undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge branch 'bc/doc-status-short'

Browse Source 
Doc update.

* bc/doc-status-short:
  docs: rephrase and clarify the git status --short format
This commit is contained in:
Junio C Hamano 2021-01-15 21:48:47 -08:00
commit 644d85e751
1 changed files with 20 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Documentation/git-status.txt
View File

@ -184,11 +184,26 @@ characters, that field will be quoted in the manner of a C string
literal: surrounded by ASCII double quote (34) characters, and with literal: surrounded by ASCII double quote (34) characters, and with
interior special characters backslash-escaped. interior special characters backslash-escaped.
For paths with merge conflicts, `X` and `Y` show the modification There are three different types of states that are shown using this format, and
states of each side of the merge. For paths that do not have merge each one uses the `XY` syntax differently:
conflicts, `X` shows the status of the index, and `Y` shows the status
of the work tree. For untracked paths, `XY` are `??`. Other status * When a merge is occurring and the merge was successful, or outside of a merge
codes can be interpreted as follows: situation, `X` shows the status of the index and `Y` shows the status of the
working tree.
* When a merge conflict has occurred and has not yet been resolved, `X` and `Y`
show the state introduced by each head of the merge, relative to the common
ancestor. These paths are said to be _unmerged_.
* When a path is untracked, `X` and `Y` are always the same, since they are
unknown to the index. `??` is used for untracked paths. Ignored files are
not listed unless `--ignored` is used; if it is, ignored files are indicated
by `!!`.
Note that the term _merge_ here also includes rebases using the default
`--merge` strategy, cherry-picks, and anything else using the merge machinery.
In the following table, these three classes are shown in separate sections, and
these characters are used for `X` and `Y` fields for the first two sections that
show tracked paths:
* ' ' = unmodified * ' ' = unmodified
* 'M' = modified * 'M' = modified
@ -198,9 +213,6 @@ codes can be interpreted as follows:
* 'C' = copied * 'C' = copied
* 'U' = updated but unmerged * 'U' = updated but unmerged
Ignored files are not listed, unless `--ignored` option is in effect,
in which case `XY` are `!!`.
.... ....
X Y Meaning X Y Meaning
------------------------------------------------- -------------------------------------------------