Re: [PATCH] Document ls-files -t as obsolete.
- From
Junio C Hamano <gitster@pobox.com>
- Date
- Apr 14, 2010, 14:39 UTC
- Message-ID
- <7vaat6qesd.fsf@alter.siamese.dyndns.org>
- In-Reply-To
- <1271252704-21739-1-git-send-email-Matthieu.Moy@imag.fr>
Matthieu Moy <Matthieu.Moy@imag.fr> writes:
Show 5 quoted lines
> The behavior of "git ls-files -t" is very misleading (see > http://thread.gmane.org/gmane.comp.version-control.git/126516 and > http://thread.gmane.org/gmane.comp.version-control.git/144394/focus=144397 > for examples of mislead users) and badly documented, hence we point the > users to superior alternatives.
I am no entirely happy with this patch.
If all your scripted Porcelain wants to see is "what are the paths I might want to run 'git add' on?", you do not want to run diff twice (which is what "status" does); you would say "ls-files -t -m -o --exclude-standard", instead. The alternative is not even superiour in this case.
Having said that, I personally don't think of any other combination of flags with which "ls-files -t" is useful.
If there are parts of the documentation that are misleading, perhaps that is what your patch should be fixing instead, no?