On Nov 19, 2007, at 7:13 PM, Matthieu Moy wrote:
Benoit Sigoure <tsuna@xxxxxxxxxxxxx> writes:Did you only read the man? It doesn't explain how to use the reflog or I must have a very hard time understanding it. I don't know where the HEAD@{N} syntax is documented, but surely not in man git-reflog.http://www.kernel.org/pub/software/scm/git/docs/git-rev-parse.html I'll post a patch adding a link to that in the reflog man page.
No please stop adding links from on man page to another. If you read man git-reflog, you surely want to learn the HEAD@{N} syntax and see practical uses cases. One of the complaints against Git (which also came up in the Git Users' Survey) is that man pages are harder to use because they often refer to each other and they tend to list their numerous arguments out of order. Many arguments are clearly plumbing and should be mentioned in a different section (I guess it would be better to list the most useful arguments in alphabetical order first and then list the remaining arguments in another section, still in alphabetical order).
-- Benoit Sigoure aka Tsuna EPITA Research and Development Laboratory
Attachment:
PGP.sig
Description: This is a digitally signed message part
