While other Magit buffers contain e.g. one particular diff or one particular log, the status buffer contains the diffs for staged and unstaged changes, logs for unpushed and unpulled commits, lists of stashes and untracked files, and information related to the current branch.
During certain incomplete operations – for example when a merge resulted in a conflict – additional information is displayed that helps proceeding with or aborting the operation.
magit-status displays the status buffer belonging to the
current repository in another window. This command is used so often
that it should be bound globally. We recommend using
(global-set-key (kbd "C-x g") 'magit-status)
When invoked from within an existing Git repository, then this command shows the status of that repository in a buffer.
If the current directory isn’t located within a Git repository, then
this command prompts for an existing repository or an arbitrary
directory, depending on the option
the status for the selected repository is shown instead.
These fallback behaviors can also be forced using one or more prefix arguments:
magit-repository-directories, then the behavior is the same as with two prefix arguments.
List of directories that are Git repositories or contain Git repositories.
Each element has the form
(DIRECTORY . DEPTH). DIRECTORY has to be
a directory or a directory file-name, a string. DEPTH, an integer,
specifies the maximum depth to look for Git repositories. If it is
0, then only add DIRECTORY itself.
This option controls which repositories are being listed by
magit-list-repositories. It also affects
magit-status (which see)
in potentially surprising ways (see above).
From an Ido prompt used to open a file, instead drop into
magit-status. This is similar to
despite its name, usually causes a Dired buffer to be created.
To make this command available, use something like:
(add-hook 'ido-setup-hook (lambda () (define-key ido-completion-map (kbd \"C-x g\") 'ido-enter-magit-status)))
Starting with Emacs 25.1 the Ido keymaps are defined just once instead of every time Ido is invoked, so now you can modify it like pretty much every other keymap:
(define-key ido-common-completion-map (kbd \"C-x g\") 'ido-enter-magit-status)
|• Status Sections:|
|• Status Header Sections:|
|• Status Module Sections:|
|• Status Options:|