Merge branch 'master' of git://git.kernel.org/pub/scm/git/git
[git/jnareb-git.git] / Documentation / git-reflog.txt
blobfad12ca600b25eb31bc1554bb95e50252681c20e
1 git-reflog(1)
2 =============
4 NAME
5 ----
6 git-reflog - Manage reflog information
9 SYNOPSIS
10 --------
11 'git reflog' <subcommand> <options>
13 DESCRIPTION
14 -----------
15 The command takes various subcommands, and different options
16 depending on the subcommand:
18 [verse]
19 git reflog expire [--dry-run] [--stale-fix]
20         [--expire=<time>] [--expire-unreachable=<time>] [--all] <refs>...
22 git reflog [show] [log-options]
24 Reflog is a mechanism to record when the tip of branches are
25 updated.  This command is to manage the information recorded in it.
27 The subcommand "expire" is used to prune older reflog entries.
28 Entries older than `expire` time, or entries older than
29 `expire-unreachable` time and are not reachable from the current
30 tip, are removed from the reflog.  Entries which refer to
31 commits that are no longer in the repository are pruned
32 regardless of their age.  This command is typically not used
33 directly by the end users -- instead, see gitlink:git-gc[1].
35 The subcommand "show" (which is also the default, in the absense of any
36 subcommands) will take all the normal log options, and show the log of
37 the current branch. It is basically an alias for 'git log -g --abbrev-commit
38 --pretty=oneline', see gitlink:git-log[1].
40 OPTIONS
41 -------
43 --expire=<time>::
44         Entries older than this time are pruned.  Without the
45         option it is taken from configuration `gc.reflogExpire`,
46         which in turn defaults to 90 days.
48 --expire-unreachable=<time>::
49         Entries older than this time and are not reachable from
50         the current tip of the branch are pruned.  Without the
51         option it is taken from configuration
52         `gc.reflogExpireUnreachable`, which in turn defaults to
53         30 days.
55 --all::
56         Instead of listing <refs> explicitly, prune all refs.
58 Author
59 ------
60 Written by Junio C Hamano <junkio@cox.net>
62 Documentation
63 --------------
64 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
66 GIT
67 ---
68 Part of the gitlink:git[7] suite