Re: [PATCH] Doc fix for git-reflog: mention @{...} syntax, and <ref> in synopsys.

From: Junio C Hamano <gitster@pobox.com>
Date: Nov 19, 2007, 20:13 UTC
Message-ID: <7vtznim1s5.fsf@gitster.siamese.dyndns.org>
In-Reply-To: <1195497342-26334-1-git-send-email-Matthieu.Moy@imag.fr>

Matthieu Moy <Matthieu.Moy@imag.fr> writes:

Show 5 quoted lines

> The HEAD@{...} syntax was documented in git-rev-parse manpage, which
> is hard to find by someone looking for the documentation of porcelain.
> git-reflog is probably the place where one expects to find this.
>
> While I'm there, "git revlog show whatever" was also undocumented.

Thanks.  The new HEAD@{N} description is concise and nice.

Show 7 quoted lines

>  The subcommand "show" (which is also the default, in the absence of any
>  subcommands) will take all the normal log options, and show the log of
> -`HEAD`, which will cover all recent actions, including branch switches.
> +`HEAD`, or of the reference provided in the command-line, which will
> +cover all recent actions, including branch switches.
>  It is basically an alias for 'git log -g --abbrev-commit
>  --pretty=oneline', see gitlink:git-log[1].

But the wording added with "While I'm there" change seems wrong to me. "..., which will cover all recent actions" is about the reflog attached to HEAD but the new phrase inserted in the middle makes it unclear.