diff --git a/Documentation/git-status.adoc b/Documentation/git-status.adoc index 37b0453898..9acca52bfb 100644 --- a/Documentation/git-status.adoc +++ b/Documentation/git-status.adoc @@ -219,35 +219,32 @@ show tracked paths: `C`:: copied (if config option status.renames is set to "copies") `U`:: updated but unmerged -.... -X Y Meaning -------------------------------------------------- - [AMD] not updated -M [ MTD] updated in index -T [ MTD] type changed in index -A [ MTD] added to index -D deleted from index -R [ MTD] renamed in index -C [ MTD] copied in index -[MTARC] index and work tree matches -[ MTARC] M work tree changed since index -[ MTARC] T type changed in work tree since index -[ MTARC] D deleted in work tree - R renamed in work tree - C copied in work tree -------------------------------------------------- -D D unmerged, both deleted -A U unmerged, added by us -U D unmerged, deleted by them -U A unmerged, added by them -D U unmerged, deleted by us -A A unmerged, both added -U U unmerged, both modified -------------------------------------------------- -? ? untracked -! ! ignored -------------------------------------------------- -.... +[cols="^1m,^1m,<2",options="header"] +|=== +|X | Y |Meaning +| |[AMD] |not updated +|M |[ MTD] |updated in index +|T |[ MTD] |type changed in index +|A |[ MTD] |added to index +|D | |deleted from index +|R |[ MTD] |renamed in index +|C |[ MTD] |copied in index +|[MTARC] | |index and work tree matches +|[ MTARC] |M |work tree changed since index +|[ MTARC] |T |type changed in work tree since index +|[ MTARC] |D |deleted in work tree +| |R |renamed in work tree +| |C |copied in work tree +|D |D |unmerged, both deleted +|A |U |unmerged, added by us +|U |D |unmerged, deleted by them +|U |A |unmerged, added by them +|D |U |unmerged, deleted by us +|A |A |unmerged, both added +|U |U |unmerged, both modified +|? |? |untracked +|! |! |ignored +|=== Submodules have more state and instead report @@ -311,16 +308,15 @@ Branch Headers If `--branch` is given, a series of header lines are printed with information about the current branch. -.... -Line Notes ------------------------------------------------------------- -# branch.oid | (initial) Current commit. -# branch.head | (detached) Current branch. -# branch.upstream If upstream is set. -# branch.ab + - If upstream is set and - the commit is present. ------------------------------------------------------------- -.... +[cols="<1,<1",options="header"] +|=== +|Line |Notes +|`# branch.oid \| (initial)` |Current commit. +|`# branch.head \| (detached)` |Current branch. +|`# branch.upstream ` |If upstream is set. +|`# branch.ab + -` |If upstream is set and + the commit is present. +|=== Stash Information ^^^^^^^^^^^^^^^^^ @@ -349,37 +345,42 @@ Renamed or copied entries have the following format: [synopsis] 2 -.... -Field Meaning --------------------------------------------------------- - A 2 character field containing the staged and - unstaged XY values described in the short format, - with unchanged indicated by a "." rather than - a space. - A 4 character field describing the submodule state. - "N..." when the entry is not a submodule. - "S" when the entry is a submodule. - is "C" if the commit changed; otherwise ".". - is "M" if it has tracked changes; otherwise ".". - is "U" if there are untracked changes; otherwise ".". - The octal file mode in HEAD. - The octal file mode in the index. - The octal file mode in the worktree. - The object name in HEAD. - The object name in the index. - The rename or copy score (denoting the percentage - of similarity between the source and target of the - move or copy). For example "R100" or "C75". - The pathname. In a renamed/copied entry, this - is the target path. - When the `-z` option is used, the 2 pathnames are separated - with a NUL (ASCII 0x00) byte; otherwise, a tab (ASCII 0x09) - byte separates them. - The pathname in the commit at HEAD or in the index. - This is only present in a renamed/copied entry, and - tells where the renamed/copied contents came from. --------------------------------------------------------- -.... +[cols="<1,<1a",options="header"] +|=== +|Field | Meaning + +|__ +|A 2 character field containing the staged and +unstaged XY values described in the short format, +with unchanged indicated by a "." rather than +a space. +|__ +|A 4 character field describing the submodule state. +"N..." when the entry is not a submodule. +`S` when the entry is a submodule. + +* __ is "C" if the commit changed; otherwise ".". +* __ is "M" if it has tracked changes; otherwise ".". +* __ is "U" if there are untracked changes; otherwise ".". +|__ |The octal file mode in HEAD. +|__ |The octal file mode in the index. +|__ |The octal file mode in the worktree. +|__ |The object name in HEAD. +|__ |The object name in the index. +|__ |The rename or copy score (denoting the percentage +of similarity between the source and target of the +move or copy). For example "R100" or "C75". +|__ +|The pathname. In a renamed/copied entry, this is the target path. +|__ +|When the `-z` option is used, the 2 pathnames are separated +with a _NUL_ (ASCII 0x00) byte; otherwise, a _TAB_ (ASCII 0x09) +byte separates them. +|__ +|The pathname in the commit at HEAD or in the index. +This is only present in a renamed/copied entry, and +tells where the renamed/copied contents came from. +|=== Unmerged entries have the following format; the first character is a "u" to distinguish from ordinary changed entries. @@ -387,23 +388,22 @@ a "u" to distinguish from ordinary changed entries. [synopsis] u

-.... -Field Meaning --------------------------------------------------------- - A 2 character field describing the conflict type +[cols="<1,<1a",options="header"] +|=== +|Field |Meaning +|__ |A 2 character field describing the conflict type as described in the short format. - A 4 character field describing the submodule state +|__ |A 4 character field describing the submodule state as described above. - The octal file mode in stage 1. - The octal file mode in stage 2. - The octal file mode in stage 3. - The octal file mode in the worktree. -

The object name in stage 1. -

The object name in stage 2. -

The object name in stage 3. - The pathname. --------------------------------------------------------- -.... +|__ |The octal file mode in stage 1. +|__ |The octal file mode in stage 2. +|__ |The octal file mode in stage 3. +|__ |The octal file mode in the worktree. +|_

_ |The object name in stage 1. +|_

_ |The object name in stage 2. +|_

_ |The object name in stage 3. +|__ |The pathname. +|=== Other Items ^^^^^^^^^^^