Mark Dominus <mjd@xxxxxxxxxx> writes:
> From: Mark Dominus <mjd@xxxxxxxxxxx>
>
> Signed-off-by: Mark Dominus <mjd@xxxxxxxxxx>
> ---
> Documentation/git-status.txt | 4 ++++
> 1 files changed, 4 insertions(+), 0 deletions(-)
>
> diff --git a/Documentation/git-status.txt b/Documentation/git-status.txt
> index 3d51717..e7fc5c3 100644
> --- a/Documentation/git-status.txt
> +++ b/Documentation/git-status.txt
> @@ -122,6 +122,8 @@ codes can be interpreted as follows:
> * 'R' = renamed
> * 'C' = copied
> * 'U' = updated but unmerged
> +* 'T' = file type changed
> + (typically from plain file to symlink, or vice versa)
>
> Ignored files are not listed, unless `--ignored` option is in effect,
> in which case `XY` are `!!`.
> @@ -134,9 +136,11 @@ in which case `XY` are `!!`.
> D [ M] deleted from index
> R [ MD] renamed in index
> C [ MD] copied in index
> + T [ MD] file type changed in index
> [MARC] index and work tree matches
> [ MARC] M work tree changed since index
> [ MARC] D deleted in work tree
> + [ MARC] T file type changed in work tree
The current organization of this table may need to be rethought, but if we
were to keep it, then this change is far from sufficient. For example, you
do not explain what XY = TT means.
Side note. The reason why we do not have two independent tables,
one of which shows "if X is M then it means updated in index, if X
is A then..." and the other shows "if Y is ' ' then index and
working tree matches, if Y is 'M' then ...", is because this table
is meant to show _possible_ combinations. For example, the row
with X = D shows that only two possible value for Y are ' ' and M
and A or D are not possible values for Y in that case.
It may be easier to explain if you treated that 'T' is merely a variant of
'M' (this comment applies to the first hunk of your patch that starts at
line 122), i.e.
Documentation/git-status.txt | 4 ++++
1 files changed, 4 insertions(+), 0 deletions(-)
diff --git a/Documentation/git-status.txt b/Documentation/git-status.txt
index 3d51717..bc2552e 100644
--- a/Documentation/git-status.txt
+++ b/Documentation/git-status.txt
@@ -126,6 +126,10 @@ codes can be interpreted as follows:
Ignored files are not listed, unless `--ignored` option is in effect,
in which case `XY` are `!!`.
+Note that a change in filetype (i.e. a regular file to symbolic link or
+vice versa) is a special case of "modified" and shown as 'T' instead of
+'M'; in the table below an 'M' could be a 'T'.
+
X Y Meaning
-------------------------------------------------
[MD] not updated
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html