diff options
author | Elijah Newren <newren@gmail.com> | 2023-01-13 04:41:53 +0000 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2023-01-13 11:55:17 -0800 |
commit | 4173b806c75dbcf4406c7a5ad6158dcbfa2beb2f (patch) | |
tree | 32e694634f79b9e6bd27b3f3a40c88452c153113 /commit.h | |
parent | 2b02d2df2bc38048ca70c82024834995624c2f4d (diff) |
ls-files: clarify descriptions of status tags for -t
Much like the file selection options we tweaked in the last commit, the
status tags printed with -t had descriptions that were easy to
misunderstand, and for many of the same reasons. Clarify them.
Also, while at it, remove the "semi-deprecated" comment for "git
ls-files -t". The -t option was marked as semi-deprecated in 5bc0e247c4
("Document ls-files -t as semi-obsolete.", 2010-07-28) because:
"git ls-files -t" is [...] badly documented, hence we point the
users to superior alternatives.
The feature is marked as "semi-obsolete" but not "scheduled for removal"
since it's a plumbing command, scripts might use it, and Git testsuite
already uses it to test the state of the index.
Marking it as obsolete because it was easily misunderstood, which I
think was primarily due to documentation problems, is one strategy, but
I think fixing the documentation is a better option. Especially since
in the intervening time, "git ls-files -t" has become heavily used by
sparse-checkout users where the same confusion just doesn't apply.
Signed-off-by: Elijah Newren <newren@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'commit.h')
0 files changed, 0 insertions, 0 deletions