<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Revision Identifiers — Bazaar 2.7.0 documentation</title>
<link rel="stylesheet" href="../_static/classic.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script type="text/javascript" src="../_static/jquery.js"></script>
<script type="text/javascript" src="../_static/underscore.js"></script>
<script type="text/javascript" src="../_static/doctools.js"></script>
<script type="text/javascript" src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Standard Options" href="standard-options-help.html" />
<link rel="prev" title="Other Storage Formats" href="other-formats-help.html" />
</head><body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="standard-options-help.html" title="Standard Options"
accesskey="N">next</a></li>
<li class="right" >
<a href="other-formats-help.html" title="Other Storage Formats"
accesskey="P">previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Bazaar User Reference</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="revision-identifiers">
<h1>Revision Identifiers<a class="headerlink" href="#revision-identifiers" title="Permalink to this headline">¶</a></h1>
<p>A revision identifier refers to a specific state of a branch’s history. It
can be expressed in several ways. It can begin with a keyword to
unambiguously specify a given lookup type; some examples are ‘last:1’,
‘before:yesterday’ and ‘submit:’.</p>
<p>Alternately, it can be given without a keyword, in which case it will be
checked as a revision number, a tag, a revision id, a date specification, or a
branch specification, in that order. For example, ‘date:today’ could be
written as simply ‘today’, though if you have a tag called ‘today’ that will
be found first.</p>
<p>If ‘REV1’ and ‘REV2’ are revision identifiers, then ‘REV1..REV2’ denotes a
revision range. Examples: ‘3647..3649’, ‘date:yesterday..-1’ and
‘branch:/path/to/branch1/..branch:/branch2’ (note that there are no quotes or
spaces around the ‘..’).</p>
<p>Ranges are interpreted differently by different commands. To the “log” command,
a range is a sequence of log messages, but to the “diff” command, the range
denotes a change between revisions (and not a sequence of changes). In
addition, “log” considers a closed range whereas “diff” and “merge” consider it
to be open-ended, that is, they include one end but not the other. For example:
“bzr log -r 3647..3649” shows the messages of revisions 3647, 3648 and 3649,
while “bzr diff -r 3647..3649” includes the changes done in revisions 3648 and
3649, but not 3647.</p>
<p>The keywords used as revision selection methods are the following:</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">revid:</th><td class="field-body">Selects a revision using the revision id.</td>
</tr>
<tr class="field-even field"><th class="field-name">submit:</th><td class="field-body">Selects a common ancestor with the submit branch.</td>
</tr>
<tr class="field-odd field"><th class="field-name">ancestor:</th><td class="field-body">Selects a common ancestor with a second branch.</td>
</tr>
<tr class="field-even field"><th class="field-name">date:</th><td class="field-body">Selects a revision on the basis of a datestamp.</td>
</tr>
<tr class="field-odd field"><th class="field-name">branch:</th><td class="field-body">Selects the last revision of a specified branch.</td>
</tr>
<tr class="field-even field"><th class="field-name">tag:</th><td class="field-body">Selects a revision identified by a tag name.</td>
</tr>
<tr class="field-odd field"><th class="field-name">revno:</th><td class="field-body">Selects a revision using a number.</td>
</tr>
<tr class="field-even field"><th class="field-name">before:</th><td class="field-body">Selects the parent of the revision specified.</td>
</tr>
<tr class="field-odd field"><th class="field-name">annotate:</th><td class="field-body">Select the revision that last modified the specified line.</td>
</tr>
<tr class="field-even field"><th class="field-name">mainline:</th><td class="field-body">Select mainline revision that merged the specified revision.</td>
</tr>
<tr class="field-odd field"><th class="field-name">last:</th><td class="field-body">Selects the nth revision from the end.</td>
</tr>
</tbody>
</table>
<p>In addition, plugins can provide other keywords.</p>
<p>A detailed description of each keyword is given below.</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">revid:</th><td class="field-body"><p class="first">Supply a specific revision id, that can be used to specify any
revision id in the ancestry of the branch.
Including merges, and pending merges.
Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">revid</span><span class="p">:</span><span class="n">aaaa</span><span class="nd">@bbbb</span><span class="o">-</span><span class="mi">123456789</span> <span class="o">-></span> <span class="n">Select</span> <span class="n">revision</span> <span class="s1">'aaaa@bbbb-123456789'</span>
</pre></div>
</div>
</td>
</tr>
<tr class="field-even field"><th class="field-name">submit:</th><td class="field-body"><p class="first">Diffing against this shows all the changes that were made in this branch,
and is a good predictor of what merge will do. The submit branch is
used by the bundle and merge directive commands. If no submit branch
is specified, the parent branch is used instead.</p>
<p>The common ancestor is the last revision that existed in both
branches. Usually this is the branch point, but it could also be
a revision that was merged.</p>
<p>Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>$ bzr diff -r submit:
</pre></div>
</div>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">ancestor:</th><td class="field-body"><p class="first">Supply the path to a branch to select the common ancestor.</p>
<p>The common ancestor is the last revision that existed in both
branches. Usually this is the branch point, but it could also be
a revision that was merged.</p>
<p>This is frequently used with ‘diff’ to return all of the changes
that your branch introduces, while excluding the changes that you
have not merged from the remote branch.</p>
<p>Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>ancestor:/path/to/branch
$ bzr diff -r ancestor:../../mainline/branch
</pre></div>
</div>
</td>
</tr>
<tr class="field-even field"><th class="field-name">date:</th><td class="field-body"><p class="first">Supply a datestamp to select the first revision that matches the date.
Date can be ‘yesterday’, ‘today’, ‘tomorrow’ or a YYYY-MM-DD string.
Matches the first entry after a given date (either at midnight or
at a specified time).</p>
<p>One way to display all the changes since yesterday would be:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">log</span> <span class="o">-</span><span class="n">r</span> <span class="n">date</span><span class="p">:</span><span class="n">yesterday</span><span class="o">..</span>
</pre></div>
</div>
<p>Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">date</span><span class="p">:</span><span class="n">yesterday</span> <span class="o">-></span> <span class="n">select</span> <span class="n">the</span> <span class="n">first</span> <span class="n">revision</span> <span class="n">since</span> <span class="n">yesterday</span>
<span class="n">date</span><span class="p">:</span><span class="mi">2006</span><span class="o">-</span><span class="mi">08</span><span class="o">-</span><span class="mi">14</span><span class="p">,</span><span class="mi">17</span><span class="p">:</span><span class="mi">10</span><span class="p">:</span><span class="mi">14</span> <span class="o">-></span> <span class="n">select</span> <span class="n">the</span> <span class="n">first</span> <span class="n">revision</span> <span class="n">after</span>
<span class="n">August</span> <span class="mi">14</span><span class="n">th</span><span class="p">,</span> <span class="mi">2006</span> <span class="n">at</span> <span class="mi">5</span><span class="p">:</span><span class="mi">10</span><span class="n">pm</span><span class="o">.</span>
</pre></div>
</div>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">branch:</th><td class="field-body"><p class="first">Supply the path to a branch to select its last revision.</p>
<p>Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">branch</span><span class="p">:</span><span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">branch</span>
</pre></div>
</div>
</td>
</tr>
<tr class="field-even field"><th class="field-name">tag:</th><td class="field-body"><p class="first">Tags are stored in the branch and created by the ‘tag’ command.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">revno:</th><td class="field-body"><p class="first">Use an integer to specify a revision in the history of the branch.
Optionally a branch can be specified. A negative number will count
from the end of the branch (-1 is the last revision, -2 the previous
one). If the negative number is larger than the branch’s history, the
first revision is returned.
Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">revno</span><span class="p">:</span><span class="mi">1</span> <span class="o">-></span> <span class="k">return</span> <span class="n">the</span> <span class="n">first</span> <span class="n">revision</span> <span class="n">of</span> <span class="n">this</span> <span class="n">branch</span>
<span class="n">revno</span><span class="p">:</span><span class="mi">3</span><span class="p">:</span><span class="o">/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">branch</span> <span class="o">-></span> <span class="k">return</span> <span class="n">the</span> <span class="mi">3</span><span class="n">rd</span> <span class="n">revision</span> <span class="n">of</span>
<span class="n">the</span> <span class="n">branch</span> <span class="s1">'/path/to/branch'</span>
<span class="n">revno</span><span class="p">:</span><span class="o">-</span><span class="mi">1</span> <span class="o">-></span> <span class="n">The</span> <span class="n">last</span> <span class="n">revision</span> <span class="ow">in</span> <span class="n">a</span> <span class="n">branch</span><span class="o">.</span>
<span class="o">-</span><span class="mi">2</span><span class="p">:</span><span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">other</span><span class="o">/</span><span class="n">branch</span> <span class="o">-></span> <span class="n">The</span> <span class="n">second</span> <span class="n">to</span> <span class="n">last</span> <span class="n">revision</span> <span class="ow">in</span> <span class="n">the</span>
<span class="n">remote</span> <span class="n">branch</span><span class="o">.</span>
<span class="o">-</span><span class="mi">1000000</span> <span class="o">-></span> <span class="n">Most</span> <span class="n">likely</span> <span class="n">the</span> <span class="n">first</span> <span class="n">revision</span><span class="p">,</span> <span class="n">unless</span>
<span class="n">your</span> <span class="n">history</span> <span class="ow">is</span> <span class="n">very</span> <span class="n">long</span><span class="o">.</span>
</pre></div>
</div>
</td>
</tr>
<tr class="field-even field"><th class="field-name">before:</th><td class="field-body"><p class="first">Supply any revision spec to return the parent of that revision. This is
mostly useful when inspecting revisions that are not in the revision history
of a branch.</p>
<p>It is an error to request the parent of the null revision (before:0).</p>
<p>Examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">before</span><span class="p">:</span><span class="mi">1913</span> <span class="o">-></span> <span class="n">Return</span> <span class="n">the</span> <span class="n">parent</span> <span class="n">of</span> <span class="n">revno</span> <span class="mi">1913</span> <span class="p">(</span><span class="n">revno</span> <span class="mi">1912</span><span class="p">)</span>
<span class="n">before</span><span class="p">:</span><span class="n">revid</span><span class="p">:</span><span class="n">aaaa</span><span class="nd">@bbbb</span><span class="o">-</span><span class="mi">1234567890</span> <span class="o">-></span> <span class="k">return</span> <span class="n">the</span> <span class="n">parent</span> <span class="n">of</span> <span class="n">revision</span>
<span class="n">aaaa</span><span class="nd">@bbbb</span><span class="o">-</span><span class="mi">1234567890</span>
<span class="n">bzr</span> <span class="n">diff</span> <span class="o">-</span><span class="n">r</span> <span class="n">before</span><span class="p">:</span><span class="mf">1913.</span><span class="o">.</span><span class="mi">1913</span>
<span class="o">-></span> <span class="n">Find</span> <span class="n">the</span> <span class="n">changes</span> <span class="n">between</span> <span class="n">revision</span> <span class="mi">1913</span> <span class="ow">and</span> <span class="n">its</span> <span class="n">parent</span> <span class="p">(</span><span class="mi">1912</span><span class="p">)</span><span class="o">.</span>
<span class="p">(</span><span class="n">What</span> <span class="n">changes</span> <span class="n">did</span> <span class="n">revision</span> <span class="mi">1913</span> <span class="n">introduce</span><span class="p">)</span><span class="o">.</span>
<span class="n">This</span> <span class="ow">is</span> <span class="n">equivalent</span> <span class="n">to</span><span class="p">:</span> <span class="n">bzr</span> <span class="n">diff</span> <span class="o">-</span><span class="n">c</span> <span class="mi">1913</span>
</pre></div>
</div>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">annotate:</th><td class="field-body"><p class="first">Select the revision that last modified the specified line. Line is
specified as path:number. Path is a relative path to the file. Numbers
start at 1, and are relative to the current version, not the last-
committed version of the file.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name">mainline:</th><td class="field-body"><p class="first">Select the revision that merged the specified revision into mainline.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">last:</th><td class="field-body"><p class="first">Supply a positive number to get the nth revision from the end.
This is the same as supplying negative numbers to the ‘revno:’ spec.
Examples:</p>
<div class="last highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">last</span><span class="p">:</span><span class="mi">1</span> <span class="o">-></span> <span class="k">return</span> <span class="n">the</span> <span class="n">last</span> <span class="n">revision</span>
<span class="n">last</span><span class="p">:</span><span class="mi">3</span> <span class="o">-></span> <span class="k">return</span> <span class="n">the</span> <span class="n">revision</span> <span class="mi">2</span> <span class="n">before</span> <span class="n">the</span> <span class="n">end</span><span class="o">.</span>
</pre></div>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="other-formats-help.html"
title="previous chapter">Other Storage Formats</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="standard-options-help.html"
title="next chapter">Standard Options</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-reference/revisionspec-help.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="standard-options-help.html" title="Standard Options"
>next</a></li>
<li class="right" >
<a href="other-formats-help.html" title="Other Storage Formats"
>previous</a> |</li>
<li><a href="http://bazaar.canonical.com/">
<img src="../_static/bzr icon 16.png" /> Home</a> | </li>
<a href="http://doc.bazaar.canonical.com/en/">Documentation</a> | </li>
<li class="nav-item nav-item-0"><a href="../index.html">Table of Contents (2.7.0)</a> »</li>
<li class="nav-item nav-item-1"><a href="index.html" >Bazaar User Reference</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
</div>
</body>
</html>
