git-reflog.html - external/gitster/git-htmldocs - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 7.0.2" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
 /*
  border: 1px solid red;
 */
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a { color: blue; }
 a:visited { color: fuchsia; }

 em {
  font-style: italic;
 }

 strong {
  font-weight: bold;
 }

 tt {
  color: navy;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1 {
  border-bottom: 2px solid silver;
 }
 h2 {
  border-bottom: 2px solid silver;
  padding-top: 0.5em;
 }

 div.sectionbody {
  font-family: serif;
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 pre {
  padding: 0;
  margin: 0;
 }

 span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.2em;
 }
 span#email {
 }
 span#revision {
  font-family: sans-serif;
 }

 div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 div#footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 div#preamble,
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }

 div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock > div.content {
  padding-left: 2.0em;
 }
 div.quoteblock .attribution {
  text-align: right;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
 }

 div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
 }

 div.verseblock div.content {
  white-space: pre;
 }

 div.imageblock div.content { padding-left: 0; }
 div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
 }
 dd > *:first-child {
  margin-top: 0;
 }

 ul, ol {
  list-style-position: outside;
 }
 ol.olist2 {
  list-style-type: lower-alpha;
 }

 div.tableblock > table {
  border-color: #527bbd;
  border-width: 3px;
 }
 thead {
  font-family: sans-serif;
  font-weight: bold;
 }
 tfoot {
  font-weight: bold;
 }

 div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
 }
 td.hlist2 {
  vertical-align: top;
 }

 @media print {
  div#footer-badges { display: none; }
 }
 include::./stylesheets/xhtml11-manpage.css[]
 /* Workarounds for IE6's broken and incomplete CSS2. */

 div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }
 div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
 }

 div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock-content {
  padding-left: 2.0em;
 }

 div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
 }
 </style>
 <title>git-reflog(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-reflog(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-reflog -
  Manage reflog information
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <p><em>git reflog</em> &lt;subcommand&gt; &lt;options&gt;</p>
 </div>
 <h2>DESCRIPTION</h2>
 <div class="sectionbody">
 <p>The command takes various subcommands, and different options
 depending on the subcommand:</p>
 <div class="verseblock">
 <div class="content">git reflog expire [--dry-run] [--stale-fix] [--verbose]
  [--expire=&lt;time&gt;] [--expire-unreachable=&lt;time&gt;] [--all] &lt;refs&gt;&#8230;</div></div>
 <p>git reflog delete ref@{specifier}&#8230;</p>
 <p>git reflog [show] [log-options] [&lt;ref&gt;]</p>
 <p>Reflog is a mechanism to record when the tip of branches are
 updated. This command is to manage the information recorded in it.</p>
 <p>The subcommand "expire" is used to prune older reflog entries.
 Entries older than <tt>expire</tt> time, or entries older than
 <tt>expire-unreachable</tt> time and are not reachable from the current
 tip, are removed from the reflog. This is typically not used
 directly by the end users &#8212; instead, see <a href="git-gc.html">git-gc(1)</a>.</p>
 <p>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
 the reference provided in the command-line (or <tt>HEAD</tt>, by default).
 The reflog will cover all recent actions (HEAD reflog records branch switching
 as well). It is an alias for <em>git log -g --abbrev-commit --pretty=oneline</em>;
 see <a href="git-log.html">git-log(1)</a>.</p>
 <p>The reflog is useful in various git commands, to specify the old value
 of a reference. For example, <tt>HEAD@{2}</tt> means "where HEAD used to be
 two moves ago", <tt>master@{one.week.ago}</tt> means "where master used to
 point to one week ago", and so on. See <a href="git-rev-parse.html">git-rev-parse(1)</a> for
 more details.</p>
 <p>To delete single entries from the reflog, use the subcommand "delete"
 and specify the _exact_ entry (e.g. &#8220;git reflog delete master@{2}&#8221;).</p>
 </div>
 <h2>OPTIONS</h2>
 <div class="sectionbody">
 <dl>
 <dt>
 --stale-fix
 </dt>
 <dd>
 <p>
  This revamps the logic &#8212; the definition of "broken commit"
  becomes: a commit that is not reachable from any of the refs and
  there is a missing object among the commit, tree, or blob
  objects reachable from it that is not reachable from any of the
  refs.
 </p>
 <p>This computation involves traversing all the reachable objects, i.e. it
 has the same cost as <em>git prune</em>. Fortunately, once this is run, we
 should not have to ever worry about missing objects, because the current
 prune and pack-objects know about reflogs and protect objects referred by
 them.</p>
 </dd>
 <dt>
 --expire=&lt;time&gt;
 </dt>
 <dd>
 <p>
  Entries older than this time are pruned. Without the
  option it is taken from configuration <tt>gc.reflogExpire</tt>,
  which in turn defaults to 90 days.
 </p>
 </dd>
 <dt>
 --expire-unreachable=&lt;time&gt;
 </dt>
 <dd>
 <p>
  Entries older than this time and are not reachable from
  the current tip of the branch are pruned. Without the
  option it is taken from configuration
  <tt>gc.reflogExpireUnreachable</tt>, which in turn defaults to
  30 days.
 </p>
 </dd>
 <dt>
 --all
 </dt>
 <dd>
 <p>
  Instead of listing &lt;refs&gt; explicitly, prune all refs.
 </p>
 </dd>
 <dt>
 --updateref
 </dt>
 <dd>
 <p>
  Update the ref with the sha1 of the top reflog entry (i.e.
  &lt;ref&gt;@{0}) after expiring or deleting.
 </p>
 </dd>
 <dt>
 --rewrite
 </dt>
 <dd>
 <p>
  While expiring or deleting, adjust each reflog entry to ensure
  that the <tt>old</tt> sha1 field points to the <tt>new</tt> sha1 field of the
  previous entry.
 </p>
 </dd>
 <dt>
 --verbose
 </dt>
 <dd>
 <p>
  Print extra information on screen.
 </p>
 </dd>
 </dl>
 </div>
 <h2>Author</h2>
 <div class="sectionbody">
 <p>Written by Junio C Hamano &lt;junkio@cox.net&gt;</p>
 </div>
 <h2>Documentation</h2>
 <div class="sectionbody">
 <p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
 </div>
 <h2>GIT</h2>
 <div class="sectionbody">
 <p>Part of the <a href="git.html">git(7)</a> suite</p>
 </div>
 <div id="footer">
 <div id="footer-text">
 Last updated 08-Mar-2008 09:29:59 UTC
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="generator" content="AsciiDoc 7.0.2" />
	<style type="text/css">
	/* Debug borders */
	p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
	/*
	border: 1px solid red;
	*/
	}

	body {
	margin: 1em 5% 1em 5%;
	}

	a { color: blue; }
	a:visited { color: fuchsia; }

	em {
	font-style: italic;
	}

	strong {
	font-weight: bold;
	}

	tt {
	color: navy;
	}

	h1, h2, h3, h4, h5, h6 {
	color: #527bbd;
	font-family: sans-serif;
	margin-top: 1.2em;
	margin-bottom: 0.5em;
	line-height: 1.3;
	}

	h1 {
	border-bottom: 2px solid silver;
	}
	h2 {
	border-bottom: 2px solid silver;
	padding-top: 0.5em;
	}

	div.sectionbody {
	font-family: serif;
	margin-left: 0;
	}

	hr {
	border: 1px solid silver;
	}

	p {
	margin-top: 0.5em;
	margin-bottom: 0.5em;
	}

	pre {
	padding: 0;
	margin: 0;
	}

	span#author {
	color: #527bbd;
	font-family: sans-serif;
	font-weight: bold;
	font-size: 1.2em;
	}
	span#email {
	}
	span#revision {
	font-family: sans-serif;
	}

	div#footer {
	font-family: sans-serif;
	font-size: small;
	border-top: 2px solid silver;
	padding-top: 0.5em;
	margin-top: 4.0em;
	}
	div#footer-text {
	float: left;
	padding-bottom: 0.5em;
	}
	div#footer-badges {
	float: right;
	padding-bottom: 0.5em;
	}

	div#preamble,
	div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
	div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
	div.admonitionblock {
	margin-right: 10%;
	margin-top: 1.5em;
	margin-bottom: 1.5em;
	}
	div.admonitionblock {
	margin-top: 2.5em;
	margin-bottom: 2.5em;
	}

	div.content { /* Block element content. */
	padding: 0;
	}

	/* Block element titles. */
	div.title, caption.title {
	font-family: sans-serif;
	font-weight: bold;
	text-align: left;
	margin-top: 1.0em;
	margin-bottom: 0.5em;
	}
	div.title + * {
	margin-top: 0;
	}

	td div.title:first-child {
	margin-top: 0.0em;
	}
	div.content div.title:first-child {
	margin-top: 0.0em;
	}
	div.content + div.title {
	margin-top: 0.0em;
	}

	div.sidebarblock > div.content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}

	div.listingblock > div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock > div.content {
	padding-left: 2.0em;
	}
	div.quoteblock .attribution {
	text-align: right;
	}

	div.admonitionblock .icon {
	vertical-align: top;
	font-size: 1.1em;
	font-weight: bold;
	text-decoration: underline;
	color: #527bbd;
	padding-right: 0.5em;
	}
	div.admonitionblock td.content {
	padding-left: 0.5em;
	border-left: 2px solid silver;
	}

	div.exampleblock > div.content {
	border-left: 2px solid silver;
	padding: 0.5em;
	}

	div.verseblock div.content {
	white-space: pre;
	}

	div.imageblock div.content { padding-left: 0; }
	div.imageblock img { border: 1px solid silver; }
	span.image img { border-style: none; }

	dl {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	dt {
	margin-top: 0.5em;
	margin-bottom: 0;
	font-style: italic;
	}
	dd > *:first-child {
	margin-top: 0;
	}

	ul, ol {
	list-style-position: outside;
	}
	ol.olist2 {
	list-style-type: lower-alpha;
	}

	div.tableblock > table {
	border-color: #527bbd;
	border-width: 3px;
	}
	thead {
	font-family: sans-serif;
	font-weight: bold;
	}
	tfoot {
	font-weight: bold;
	}

	div.hlist {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	td.hlist1 {
	vertical-align: top;
	font-style: italic;
	padding-right: 0.8em;
	}
	td.hlist2 {
	vertical-align: top;
	}

	@media print {
	div#footer-badges { display: none; }
	}
	include::./stylesheets/xhtml11-manpage.css[]
	/* Workarounds for IE6's broken and incomplete CSS2. */

	div.sidebar-content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}
	div.sidebar-title, div.image-title {
	font-family: sans-serif;
	font-weight: bold;
	margin-top: 0.0em;
	margin-bottom: 0.5em;
	}

	div.listingblock div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock-content {
	padding-left: 2.0em;
	}

	div.exampleblock-content {
	border-left: 2px solid silver;
	padding-left: 0.5em;
	}
	</style>
	<title>git-reflog(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-reflog(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-reflog -
	Manage reflog information
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<p><em>git reflog</em> <subcommand> <options></p>
	</div>
	<h2>DESCRIPTION</h2>
	<div class="sectionbody">
	<p>The command takes various subcommands, and different options
	depending on the subcommand:</p>
	<div class="verseblock">
	<div class="content">git reflog expire [--dry-run] [--stale-fix] [--verbose]
	[--expire=<time>] [--expire-unreachable=<time>] [--all] <refs>…</div></div>
	<p>git reflog delete ref@{specifier}…</p>
	<p>git reflog [show] [log-options] [<ref>]</p>
	<p>Reflog is a mechanism to record when the tip of branches are
	updated. This command is to manage the information recorded in it.</p>
	<p>The subcommand "expire" is used to prune older reflog entries.
	Entries older than <tt>expire</tt> time, or entries older than
	<tt>expire-unreachable</tt> time and are not reachable from the current
	tip, are removed from the reflog. This is typically not used
	directly by the end users — instead, see <a href="git-gc.html">git-gc(1)</a>.</p>
	<p>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
	the reference provided in the command-line (or <tt>HEAD</tt>, by default).
	The reflog will cover all recent actions (HEAD reflog records branch switching
	as well). It is an alias for <em>git log -g --abbrev-commit --pretty=oneline</em>;
	see <a href="git-log.html">git-log(1)</a>.</p>
	<p>The reflog is useful in various git commands, to specify the old value
	of a reference. For example, <tt>HEAD@{2}</tt> means "where HEAD used to be
	two moves ago", <tt>master@{one.week.ago}</tt> means "where master used to
	point to one week ago", and so on. See <a href="git-rev-parse.html">git-rev-parse(1)</a> for
	more details.</p>
	<p>To delete single entries from the reflog, use the subcommand "delete"
	and specify the _exact_ entry (e.g. “git reflog delete master@{2}”).</p>
	</div>
	<h2>OPTIONS</h2>
	<div class="sectionbody">
	<dl>
	<dt>
	--stale-fix
	</dt>
	<dd>
	<p>
	This revamps the logic — the definition of "broken commit"
	becomes: a commit that is not reachable from any of the refs and
	there is a missing object among the commit, tree, or blob
	objects reachable from it that is not reachable from any of the
	refs.
	</p>
	<p>This computation involves traversing all the reachable objects, i.e. it
	has the same cost as <em>git prune</em>. Fortunately, once this is run, we
	should not have to ever worry about missing objects, because the current
	prune and pack-objects know about reflogs and protect objects referred by
	them.</p>
	</dd>
	<dt>
	--expire=<time>
	</dt>
	<dd>
	<p>
	Entries older than this time are pruned. Without the
	option it is taken from configuration <tt>gc.reflogExpire</tt>,
	which in turn defaults to 90 days.
	</p>
	</dd>
	<dt>
	--expire-unreachable=<time>
	</dt>
	<dd>
	<p>
	Entries older than this time and are not reachable from
	the current tip of the branch are pruned. Without the
	option it is taken from configuration
	<tt>gc.reflogExpireUnreachable</tt>, which in turn defaults to
	30 days.
	</p>
	</dd>
	<dt>
	--all
	</dt>
	<dd>
	<p>
	Instead of listing <refs> explicitly, prune all refs.
	</p>
	</dd>
	<dt>
	--updateref
	</dt>
	<dd>
	<p>
	Update the ref with the sha1 of the top reflog entry (i.e.
	<ref>@{0}) after expiring or deleting.
	</p>
	</dd>
	<dt>
	--rewrite
	</dt>
	<dd>
	<p>
	While expiring or deleting, adjust each reflog entry to ensure
	that the <tt>old</tt> sha1 field points to the <tt>new</tt> sha1 field of the
	previous entry.
	</p>
	</dd>
	<dt>
	--verbose
	</dt>
	<dd>
	<p>
	Print extra information on screen.
	</p>
	</dd>
	</dl>
	</div>
	<h2>Author</h2>
	<div class="sectionbody">
	<p>Written by Junio C Hamano <junkio@cox.net></p>
	</div>
	<h2>Documentation</h2>
	<div class="sectionbody">
	<p>Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.</p>
	</div>
	<h2>GIT</h2>
	<div class="sectionbody">
	<p>Part of the <a href="git.html">git(7)</a> suite</p>
	</div>
	<div id="footer">
	<div id="footer-text">
	Last updated 08-Mar-2008 09:29:59 UTC
	</div>
	</div>
	</body>
	</html>