undef/git-commit-vandalism
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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

Browse Source 
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.

Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Matthieu Moy 2007-11-19 19:25:11 +01:00 committed by Junio C Hamano
parent dec9230941
commit 97e92e2cbc
1 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Documentation/git-reflog.txt
View File

@ -19,7 +19,7 @@ depending on the subcommand:
git reflog expire [--dry-run] [--stale-fix] [--verbose] git reflog expire [--dry-run] [--stale-fix] [--verbose]
[--expire=<time>] [--expire-unreachable=<time>] [--all] <refs>... [--expire=<time>] [--expire-unreachable=<time>] [--all] <refs>...
git reflog [show] [log-options] git reflog [show] [log-options] [<ref>]
Reflog is a mechanism to record when the tip of branches are Reflog is a mechanism to record when the tip of branches are
updated. This command is to manage the information recorded in it. updated. This command is to manage the information recorded in it.
@ -32,9 +32,16 @@ directly by the end users -- instead, see gitlink:git-gc[1].
The subcommand "show" (which is also the default, in the absence of any 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 subcommands) will take all the normal log options, and show the log of
`HEAD`, which will cover all recent actions, including branch switches. the reference provided in the command-line (or `HEAD`, by default).
It is basically an alias for 'git log -g --abbrev-commit The reflog will cover all recent actions (HEAD reflog records branch switching
--pretty=oneline', see gitlink:git-log[1]. as well). It is an alias for 'git log -g --abbrev-commit --pretty=oneline';
see gitlink:git-log[1].
The reflog is useful in various git commands, to specify the old value
of a reference. For example, `HEAD@\{2\}` means "where HEAD used to be
two moves ago", `master@\{one.week.ago\}` means "where master used to
point to one week ago", and so on. See gitlink:git-rev-parse[1] for
more details.
OPTIONS OPTIONS