From: Jeff King Date: Fri, 22 Jul 2016 19:51:19 +0000 (-0400) Subject: doc/rev-list-options: clarify "commit@{Nth}" for "-g" option X-Git-Tag: v2.9.4~22^2~6 X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/2b68222d72fcb899ac87d8d48f066b49b5182f28?ds=inline;hp=--cc doc/rev-list-options: clarify "commit@{Nth}" for "-g" option When "log -g" shows "HEAD@{1}", "HEAD@{2}", etc, calling that "commit@{Nth}" is not really accurate. The "HEAD" part is really the refname. By saying "commit", a reader may misunderstand that to mean something related to the specific commit we are showing, not the ref whose reflog we are traversing. While we're here, let's also switch these instances to use literal backticks, as our style guide recommends. As a bonus, that lets us drop some asciidoc quoting. Signed-off-by: Jeff King Signed-off-by: Junio C Hamano --- 2b68222d72fcb899ac87d8d48f066b49b5182f28 diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt index 4f009d4424..6720ff3bbe 100644 --- a/Documentation/rev-list-options.txt +++ b/Documentation/rev-list-options.txt @@ -252,9 +252,9 @@ list. + With `--pretty` format other than `oneline` (for obvious reasons), this causes the output to have two extra lines of information -taken from the reflog. By default, 'commit@\{Nth}' notation is +taken from the reflog. By default, `ref@{Nth}` notation is used in the output. When the starting commit is specified as -'commit@\{now}', output also uses 'commit@\{timestamp}' notation +`ref@{now}`, output also uses `ref@{timestamp}` notation instead. Under `--pretty=oneline`, the commit message is prefixed with this information on the same line. This option cannot be combined with `--reverse`.