Google Git
Sign in
chromium / external / gitster / git-htmldocs / 86bccccdbdcef5b72f60cca6ec3d9594b271dc63 / . / git-reflog.html
blob: 01a1ecb1b89f72bbfb3d72c15c5d6ef88c8dde37 [file] [log] [blame]
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6<meta name="generator" content="AsciiDoc 7.0.2" />
7<style type="text/css">
8/* Debug borders */
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10/*
11 border: 1px solid red;
12*/
13}
14
15body {
16 margin: 1em 5% 1em 5%;
17}
18
19a { color: blue; }
20a:visited { color: fuchsia; }
21
22em {
23 font-style: italic;
24}
25
26strong {
27 font-weight: bold;
28}
29
30tt {
31 color: navy;
32}
33
34h1, h2, h3, h4, h5, h6 {
35 color: #527bbd;
36 font-family: sans-serif;
37 margin-top: 1.2em;
38 margin-bottom: 0.5em;
39 line-height: 1.3;
40}
41
42h1 {
43 border-bottom: 2px solid silver;
44}
45h2 {
46 border-bottom: 2px solid silver;
47 padding-top: 0.5em;
48}
49
50div.sectionbody {
51 font-family: serif;
52 margin-left: 0;
53}
54
55hr {
56 border: 1px solid silver;
57}
58
59p {
60 margin-top: 0.5em;
61 margin-bottom: 0.5em;
62}
63
64pre {
65 padding: 0;
66 margin: 0;
67}
68
69span#author {
70 color: #527bbd;
71 font-family: sans-serif;
72 font-weight: bold;
73 font-size: 1.2em;
74}
75span#email {
76}
77span#revision {
78 font-family: sans-serif;
79}
80
81div#footer {
82 font-family: sans-serif;
83 font-size: small;
84 border-top: 2px solid silver;
85 padding-top: 0.5em;
86 margin-top: 4.0em;
87}
88div#footer-text {
89 float: left;
90 padding-bottom: 0.5em;
91}
92div#footer-badges {
93 float: right;
94 padding-bottom: 0.5em;
95}
96
97div#preamble,
98div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
99div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
100div.admonitionblock {
101 margin-right: 10%;
102 margin-top: 1.5em;
103 margin-bottom: 1.5em;
104}
105div.admonitionblock {
106 margin-top: 2.5em;
107 margin-bottom: 2.5em;
108}
109
110div.content { /* Block element content. */
111 padding: 0;
112}
113
114/* Block element titles. */
115div.title, caption.title {
116 font-family: sans-serif;
117 font-weight: bold;
118 text-align: left;
119 margin-top: 1.0em;
120 margin-bottom: 0.5em;
121}
122div.title + * {
123 margin-top: 0;
124}
125
126td div.title:first-child {
127 margin-top: 0.0em;
128}
129div.content div.title:first-child {
130 margin-top: 0.0em;
131}
132div.content + div.title {
133 margin-top: 0.0em;
134}
135
136div.sidebarblock > div.content {
137 background: #ffffee;
138 border: 1px solid silver;
139 padding: 0.5em;
140}
141
142div.listingblock > div.content {
143 border: 1px solid silver;
144 background: #f4f4f4;
145 padding: 0.5em;
146}
147
148div.quoteblock > div.content {
149 padding-left: 2.0em;
150}
151div.quoteblock .attribution {
152 text-align: right;
153}
154
155div.admonitionblock .icon {
156 vertical-align: top;
157 font-size: 1.1em;
158 font-weight: bold;
159 text-decoration: underline;
160 color: #527bbd;
161 padding-right: 0.5em;
162}
163div.admonitionblock td.content {
164 padding-left: 0.5em;
165 border-left: 2px solid silver;
166}
167
168div.exampleblock > div.content {
169 border-left: 2px solid silver;
170 padding: 0.5em;
171}
172
173div.verseblock div.content {
174 white-space: pre;
175}
176
177div.imageblock div.content { padding-left: 0; }
178div.imageblock img { border: 1px solid silver; }
179span.image img { border-style: none; }
180
181dl {
182 margin-top: 0.8em;
183 margin-bottom: 0.8em;
184}
185dt {
186 margin-top: 0.5em;
187 margin-bottom: 0;
188 font-style: italic;
189}
190dd > *:first-child {
191 margin-top: 0;
192}
193
194ul, ol {
195 list-style-position: outside;
196}
197ol.olist2 {
198 list-style-type: lower-alpha;
199}
200
201div.tableblock > table {
202 border-color: #527bbd;
203 border-width: 3px;
204}
205thead {
206 font-family: sans-serif;
207 font-weight: bold;
208}
209tfoot {
210 font-weight: bold;
211}
212
213div.hlist {
214 margin-top: 0.8em;
215 margin-bottom: 0.8em;
216}
217td.hlist1 {
218 vertical-align: top;
219 font-style: italic;
220 padding-right: 0.8em;
221}
222td.hlist2 {
223 vertical-align: top;
224}
225
226@media print {
227 div#footer-badges { display: none; }
228}
229include::./stylesheets/xhtml11-manpage.css[]
230/* Workarounds for IE6's broken and incomplete CSS2. */
231
232div.sidebar-content {
233 background: #ffffee;
234 border: 1px solid silver;
235 padding: 0.5em;
236}
237div.sidebar-title, div.image-title {
238 font-family: sans-serif;
239 font-weight: bold;
240 margin-top: 0.0em;
241 margin-bottom: 0.5em;
242}
243
244div.listingblock div.content {
245 border: 1px solid silver;
246 background: #f4f4f4;
247 padding: 0.5em;
248}
249
250div.quoteblock-content {
251 padding-left: 2.0em;
252}
253
254div.exampleblock-content {
255 border-left: 2px solid silver;
256 padding-left: 0.5em;
257}
258</style>
259<title>git-reflog(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264git-reflog(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>git-reflog -
269 Manage reflog information
270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
Junio C Hamanod3339982007-02-09 08:38:48[diff] [blame]275<p><em>git reflog</em> &lt;subcommand&gt; &lt;options&gt;</p>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]276</div>
277<h2>DESCRIPTION</h2>
278<div class="sectionbody">
Junio C Hamanod3339982007-02-09 08:38:48[diff] [blame]279<p>The command takes various subcommands, and different options
280depending on the subcommand:</p>
281<div class="verseblock">
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]282<div class="content">git reflog expire [--dry-run] [--stale-fix] [--verbose]
Junio C Hamanod3339982007-02-09 08:38:48[diff] [blame]283 [--expire=&lt;time&gt;] [--expire-unreachable=&lt;time&gt;] [--all] &lt;refs&gt;&#8230;</div></div>
Junio C Hamano86bcccc2008-03-08 09:33:55[diff] [blame^]284<p>git reflog delete ref@{specifier}&#8230;</p>
Junio C Hamano2e72a942007-11-21 08:54:42[diff] [blame]285<p>git reflog [show] [log-options] [&lt;ref&gt;]</p>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]286<p>Reflog is a mechanism to record when the tip of branches are
287updated. This command is to manage the information recorded in it.</p>
288<p>The subcommand "expire" is used to prune older reflog entries.
289Entries older than <tt>expire</tt> time, or entries older than
290<tt>expire-unreachable</tt> time and are not reachable from the current
291tip, are removed from the reflog. This is typically not used
292directly by the end users &#8212; instead, see <a href="git-gc.html">git-gc(1)</a>.</p>
Junio C Hamanoa6387422007-08-25 03:54:27[diff] [blame]293<p>The subcommand "show" (which is also the default, in the absence of any
Junio C Hamanod3339982007-02-09 08:38:48[diff] [blame]294subcommands) will take all the normal log options, and show the log of
Junio C Hamano2e72a942007-11-21 08:54:42[diff] [blame]295the reference provided in the command-line (or <tt>HEAD</tt>, by default).
296The reflog will cover all recent actions (HEAD reflog records branch switching
297as well). It is an alias for <em>git log -g --abbrev-commit --pretty=oneline</em>;
298see <a href="git-log.html">git-log(1)</a>.</p>
299<p>The reflog is useful in various git commands, to specify the old value
300of a reference. For example, <tt>HEAD@{2}</tt> means "where HEAD used to be
301two moves ago", <tt>master@{one.week.ago}</tt> means "where master used to
302point to one week ago", and so on. See <a href="git-rev-parse.html">git-rev-parse(1)</a> for
303more details.</p>
Junio C Hamano86bcccc2008-03-08 09:33:55[diff] [blame^]304<p>To delete single entries from the reflog, use the subcommand "delete"
305and specify the _exact_ entry (e.g. &#8220;git reflog delete master@{2}&#8221;).</p>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]306</div>
307<h2>OPTIONS</h2>
308<div class="sectionbody">
309<dl>
310<dt>
Junio C Hamanoee695f22007-06-21 00:35:36[diff] [blame]311--stale-fix
312</dt>
313<dd>
314<p>
315 This revamps the logic &#8212; the definition of "broken commit"
316 becomes: a commit that is not reachable from any of the refs and
317 there is a missing object among the commit, tree, or blob
318 objects reachable from it that is not reachable from any of the
319 refs.
320</p>
321<p>This computation involves traversing all the reachable objects, i.e. it
322has the same cost as <em>git prune</em>. Fortunately, once this is run, we
323should not have to ever worry about missing objects, because the current
324prune and pack-objects know about reflogs and protect objects referred by
325them.</p>
326</dd>
327<dt>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]328--expire=&lt;time&gt;
329</dt>
330<dd>
331<p>
332 Entries older than this time are pruned. Without the
333 option it is taken from configuration <tt>gc.reflogExpire</tt>,
334 which in turn defaults to 90 days.
335</p>
336</dd>
337<dt>
338--expire-unreachable=&lt;time&gt;
339</dt>
340<dd>
341<p>
342 Entries older than this time and are not reachable from
343 the current tip of the branch are pruned. Without the
344 option it is taken from configuration
345 <tt>gc.reflogExpireUnreachable</tt>, which in turn defaults to
346 30 days.
347</p>
348</dd>
349<dt>
350--all
351</dt>
352<dd>
353<p>
354 Instead of listing &lt;refs&gt; explicitly, prune all refs.
355</p>
356</dd>
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]357<dt>
Junio C Hamano86bcccc2008-03-08 09:33:55[diff] [blame^]358--updateref
359</dt>
360<dd>
361<p>
362 Update the ref with the sha1 of the top reflog entry (i.e.
363 &lt;ref&gt;@{0}) after expiring or deleting.
364</p>
365</dd>
366<dt>
367--rewrite
368</dt>
369<dd>
370<p>
371 While expiring or deleting, adjust each reflog entry to ensure
372 that the <tt>old</tt> sha1 field points to the <tt>new</tt> sha1 field of the
373 previous entry.
374</p>
375</dd>
376<dt>
Junio C Hamano764a6672007-10-23 01:23:31[diff] [blame]377--verbose
378</dt>
379<dd>
380<p>
381 Print extra information on screen.
382</p>
383</dd>
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]384</dl>
385</div>
386<h2>Author</h2>
387<div class="sectionbody">
388<p>Written by Junio C Hamano &lt;junkio@cox.net&gt;</p>
389</div>
390<h2>Documentation</h2>
391<div class="sectionbody">
392<p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
393</div>
394<h2>GIT</h2>
395<div class="sectionbody">
396<p>Part of the <a href="git.html">git(7)</a> suite</p>
397</div>
398<div id="footer">
399<div id="footer-text">
Junio C Hamano86bcccc2008-03-08 09:33:55[diff] [blame^]400Last updated 08-Mar-2008 09:29:59 UTC
Junio C Hamano74640642006-12-27 10:59:55[diff] [blame]401</div>
402</div>
403</body>
404</html>