summaryrefslogtreecommitdiffstats
path: root/git-status.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2021-01-25 15:32:33 -0800
committerJunio C Hamano <gitster@pobox.com>2021-01-25 15:32:33 -0800
commit7887f9b4eb248358cc8e6937ceb87b9f072ce9e5 (patch)
treed5670ef418f9f7d4a5780ee5d3d01696abb477aa /git-status.html
parentd5cfc8f5a014ca40c71c8355aa37074cc885297e (diff)
downloadgit-htmldocs-7887f9b4eb248358cc8e6937ceb87b9f072ce9e5.tar.gz
Autogenerated HTML docs for v2.30.0-335-ge63628
Diffstat (limited to 'git-status.html')
-rw-r--r--git-status.html40
1 files changed, 32 insertions, 8 deletions
diff --git a/git-status.html b/git-status.html
index 874125259..0bbf77b9b 100644
--- a/git-status.html
+++ b/git-status.html
@@ -1039,11 +1039,37 @@ single space. If a filename contains whitespace or other nonprintable
characters, that field will be quoted in the manner of a C string
literal: surrounded by ASCII double quote (34) characters, and with
interior special characters backslash-escaped.</p></div>
-<div class="paragraph"><p>For paths with merge conflicts, <code>X</code> and <code>Y</code> show the modification
-states of each side of the merge. For paths that do not have merge
-conflicts, <code>X</code> shows the status of the index, and <code>Y</code> shows the status
-of the work tree. For untracked paths, <code>XY</code> are <code>??</code>. Other status
-codes can be interpreted as follows:</p></div>
+<div class="paragraph"><p>There are three different types of states that are shown using this format, and
+each one uses the <code>XY</code> syntax differently:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+When a merge is occurring and the merge was successful, or outside of a merge
+ situation, <code>X</code> shows the status of the index and <code>Y</code> shows the status of the
+ working tree.
+</p>
+</li>
+<li>
+<p>
+When a merge conflict has occurred and has not yet been resolved, <code>X</code> and <code>Y</code>
+ show the state introduced by each head of the merge, relative to the common
+ ancestor. These paths are said to be <em>unmerged</em>.
+</p>
+</li>
+<li>
+<p>
+When a path is untracked, <code>X</code> and <code>Y</code> are always the same, since they are
+ unknown to the index. <code>??</code> is used for untracked paths. Ignored files are
+ not listed unless <code>--ignored</code> is used; if it is, ignored files are indicated
+ by <code>!!</code>.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Note that the term <em>merge</em> here also includes rebases using the default
+<code>--merge</code> strategy, cherry-picks, and anything else using the merge machinery.</p></div>
+<div class="paragraph"><p>In the following table, these three classes are shown in separate sections, and
+these characters are used for <code>X</code> and <code>Y</code> fields for the first two sections that
+show tracked paths:</p></div>
<div class="ulist"><ul>
<li>
<p>
@@ -1081,8 +1107,6 @@ codes can be interpreted as follows:</p></div>
</p>
</li>
</ul></div>
-<div class="paragraph"><p>Ignored files are not listed, unless <code>--ignored</code> option is in effect,
-in which case <code>XY</code> are <code>!!</code>.</p></div>
<div class="literalblock">
<div class="content">
<pre><code>X Y Meaning
@@ -1337,7 +1361,7 @@ using <code>git --no-optional-locks status</code> (see <a href="git.html">git(1)
<div id="footer">
<div id="footer-text">
Last updated
- 2020-03-10 08:03:13 PDT
+ 2021-01-25 15:29:19 PST
</div>
</div>
</body>