<!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>log — 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="ls" href="ls-help.html" />
<link rel="prev" title="join" href="join-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="ls-help.html" title="ls"
accesskey="N">next</a></li>
<li class="right" >
<a href="join-help.html" title="join"
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="log">
<h1>log<a class="headerlink" href="#log" title="Permalink to this headline">¶</a></h1>
<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">Purpose:</th><td class="field-body"><p class="first">Show historical log for a branch or subset of a branch.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Usage:</th><td class="field-body"><p class="first">bzr log [FILE…]</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">Options:</th><td class="field-body"><table class="first docutils option-list" frame="void" rules="none">
<col class="option" />
<col class="description" />
<tbody valign="top">
<tr><td class="option-group">
<kbd><span class="option">--signatures</span></kbd></td>
<td><p class="first last">Show digital signature validity.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-v</span>, <span class="option">--verbose</span></kbd></td>
<td><p class="first last">Show files changed in each revision.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--include-merged</span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show merged revisions like –levels 0 does.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--timezone=<var>ARG</var></span></kbd></td>
<td><p class="first last">Display timezone as local, original, or utc.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-h</span>, <span class="option">--help</span></kbd></td>
<td><p class="first last">Show help message.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-p</span>, <span class="option">--show-diff</span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show changes made in each revision as a patch.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--forward</span></kbd></td>
<td><p class="first last">Show from oldest to newest.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-m <var>ARG</var></span>, <span class="option">--match=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show revisions whose properties match this expression.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-r <var>ARG</var></span>, <span class="option">--revision=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">See “help revisionspec” for details.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--omit-merges</span></kbd></td>
<td><p class="first last">Do not report commits with more than one parent.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--usage</span></kbd></td>
<td><p class="first last">Show usage message and options.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-n <var>N</var></span>, <span class="option">--levels=<var>N</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Number of levels to display - 0 for all, 1 for flat.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--authors=<var>ARG</var></span></kbd></td>
<td><p class="first last">What names to list as authors - first, all or
committer.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--match-author=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show revisions whose authors match this expression.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--match-message=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show revisions whose message matches this expression.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-c <var>ARG</var></span>, <span class="option">--change=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show just the specified revision. See also “help
revisionspec”.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--match-bugs=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show revisions whose bugs match this expression.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-q</span>, <span class="option">--quiet</span></kbd></td>
<td><p class="first last">Only display errors and warnings.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--match-committer=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Show revisions whose committer matches this
expression.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">-l <var>N</var></span>, <span class="option">--limit=<var>N</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Limit the output to the first N revisions.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--show-ids</span></kbd></td>
<td><p class="first last">Show internal object ids.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--exclude-common-ancestry</span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Display only the revisions that are not part of both
ancestries (require -rX..Y).</p>
</td></tr>
</tbody>
</table>
<dl class="docutils">
<dt>Log format:</dt>
<dd><table class="first last docutils option-list" frame="void" rules="none">
<col class="option" />
<col class="description" />
<tbody valign="top">
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--log-format=<var>ARG</var></span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Use specified log format.</p>
</td></tr>
<tr><td class="option-group" colspan="2">
<kbd><span class="option">--gnu-changelog</span></kbd></td>
</tr>
<tr><td> </td><td><p class="first last">Format used by GNU ChangeLog files.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--line</span></kbd></td>
<td><p class="first last">Log format with one line per revision.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">--long</span></kbd></td>
<td><p class="first last">Detailed log format.</p>
</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-S</span>, <span class="option">--short</span></kbd></td>
<td><p class="first last">Moderately short log format.</p>
</td></tr>
</tbody>
</table>
</dd>
</dl>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Description:</th><td class="field-body"><p class="first">log is bzr’s default tool for exploring the history of a branch.
The branch to use is taken from the first parameter. If no parameters
are given, the branch containing the working directory is logged.
Here are some simple examples:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">bzr</span> <span class="n">log</span> <span class="n">log</span> <span class="n">the</span> <span class="n">current</span> <span class="n">branch</span>
<span class="n">bzr</span> <span class="n">log</span> <span class="n">foo</span><span class="o">.</span><span class="n">py</span> <span class="n">log</span> <span class="n">a</span> <span class="n">file</span> <span class="ow">in</span> <span class="n">its</span> <span class="n">branch</span>
<span class="n">bzr</span> <span class="n">log</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">server</span><span class="o">/</span><span class="n">branch</span> <span class="n">log</span> <span class="n">a</span> <span class="n">branch</span> <span class="n">on</span> <span class="n">a</span> <span class="n">server</span>
</pre></div>
</div>
<p>The filtering, ordering and information shown for each revision can
be controlled as explained below. By default, all revisions are
shown sorted (topologically) so that newer revisions appear before
older ones and descendants always appear before ancestors. If displayed,
merged revisions are shown indented under the revision in which they
were merged.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">Output control:</th><td class="field-body"><p class="first">The log format controls how information about each revision is
displayed. The standard log formats are called <code class="docutils literal notranslate"><span class="pre">long</span></code>, <code class="docutils literal notranslate"><span class="pre">short</span></code>
and <code class="docutils literal notranslate"><span class="pre">line</span></code>. The default is long. See <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">help</span> <span class="pre">log-formats</span></code>
for more details on log formats.</p>
<p>The following options can be used to control what information is
displayed:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">-</span><span class="n">l</span> <span class="n">N</span> <span class="n">display</span> <span class="n">a</span> <span class="n">maximum</span> <span class="n">of</span> <span class="n">N</span> <span class="n">revisions</span>
<span class="o">-</span><span class="n">n</span> <span class="n">N</span> <span class="n">display</span> <span class="n">N</span> <span class="n">levels</span> <span class="n">of</span> <span class="n">revisions</span> <span class="p">(</span><span class="mi">0</span> <span class="k">for</span> <span class="nb">all</span><span class="p">,</span> <span class="mi">1</span> <span class="k">for</span> <span class="n">collapsed</span><span class="p">)</span>
<span class="o">-</span><span class="n">v</span> <span class="n">display</span> <span class="n">a</span> <span class="n">status</span> <span class="n">summary</span> <span class="p">(</span><span class="n">delta</span><span class="p">)</span> <span class="k">for</span> <span class="n">each</span> <span class="n">revision</span>
<span class="o">-</span><span class="n">p</span> <span class="n">display</span> <span class="n">a</span> <span class="n">diff</span> <span class="p">(</span><span class="n">patch</span><span class="p">)</span> <span class="k">for</span> <span class="n">each</span> <span class="n">revision</span>
<span class="o">--</span><span class="n">show</span><span class="o">-</span><span class="n">ids</span> <span class="n">display</span> <span class="n">revision</span><span class="o">-</span><span class="n">ids</span> <span class="p">(</span><span class="ow">and</span> <span class="n">file</span><span class="o">-</span><span class="n">ids</span><span class="p">),</span> <span class="ow">not</span> <span class="n">just</span> <span class="n">revnos</span>
</pre></div>
</div>
<p>Note that the default number of levels to display is a function of the
log format. If the -n option is not used, the standard log formats show
just the top level (mainline).</p>
<p>Status summaries are shown using status flags like A, M, etc. To see
the changes explained using words like <code class="docutils literal notranslate"><span class="pre">added</span></code> and <code class="docutils literal notranslate"><span class="pre">modified</span></code>
instead, use the -vv option.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name" colspan="2">Ordering control:</th></tr>
<tr class="field-even field"><td> </td><td class="field-body"><p class="first">To display revisions from oldest to newest, use the –forward option.
In most cases, using this option will have little impact on the total
time taken to produce a log, though –forward does not incrementally
display revisions like –reverse does when it can.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name" colspan="2">Revision filtering:</th></tr>
<tr class="field-odd field"><td> </td><td class="field-body"><p class="first">The -r option can be used to specify what revision or range of revisions
to filter against. The various forms are shown below:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">-</span><span class="n">rX</span> <span class="n">display</span> <span class="n">revision</span> <span class="n">X</span>
<span class="o">-</span><span class="n">rX</span><span class="o">..</span> <span class="n">display</span> <span class="n">revision</span> <span class="n">X</span> <span class="ow">and</span> <span class="n">later</span>
<span class="o">-</span><span class="n">r</span><span class="o">..</span><span class="n">Y</span> <span class="n">display</span> <span class="n">up</span> <span class="n">to</span> <span class="ow">and</span> <span class="n">including</span> <span class="n">revision</span> <span class="n">Y</span>
<span class="o">-</span><span class="n">rX</span><span class="o">..</span><span class="n">Y</span> <span class="n">display</span> <span class="kn">from</span> <span class="nn">X</span> <span class="n">to</span> <span class="n">Y</span> <span class="n">inclusive</span>
</pre></div>
</div>
<p>See <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">help</span> <span class="pre">revisionspec</span></code> for details on how to specify X and Y.
Some common examples are given below:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">-</span><span class="n">r</span><span class="o">-</span><span class="mi">1</span> <span class="n">show</span> <span class="n">just</span> <span class="n">the</span> <span class="n">tip</span>
<span class="o">-</span><span class="n">r</span><span class="o">-</span><span class="mf">10.</span><span class="o">.</span> <span class="n">show</span> <span class="n">the</span> <span class="n">last</span> <span class="mi">10</span> <span class="n">mainline</span> <span class="n">revisions</span>
<span class="o">-</span><span class="n">rsubmit</span><span class="p">:</span><span class="o">..</span> <span class="n">show</span> <span class="n">what</span><span class="s1">'s new on this branch</span>
<span class="o">-</span><span class="n">rancestor</span><span class="p">:</span><span class="n">path</span><span class="o">..</span> <span class="n">show</span> <span class="n">changes</span> <span class="n">since</span> <span class="n">the</span> <span class="n">common</span> <span class="n">ancestor</span> <span class="n">of</span> <span class="n">this</span>
<span class="n">branch</span> <span class="ow">and</span> <span class="n">the</span> <span class="n">one</span> <span class="n">at</span> <span class="n">location</span> <span class="n">path</span>
<span class="o">-</span><span class="n">rdate</span><span class="p">:</span><span class="n">yesterday</span><span class="o">..</span> <span class="n">show</span> <span class="n">changes</span> <span class="n">since</span> <span class="n">yesterday</span>
</pre></div>
</div>
<p>When logging a range of revisions using -rX..Y, log starts at
revision Y and searches back in history through the primary
(“left-hand”) parents until it finds X. When logging just the
top level (using -n1), an error is reported if X is not found
along the way. If multi-level logging is used (-n0), X may be
a nested merge revision and the log will be truncated accordingly.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Path filtering:</th><td class="field-body"><p class="first">If parameters are given and the first one is not a branch, the log
will be filtered to show only those revisions that changed the
nominated files or directories.</p>
<p>Filenames are interpreted within their historical context. To log a
deleted file, specify a revision range so that the file existed at
the end or start of the range.</p>
<p>Historical context is also important when interpreting pathnames of
renamed files/directories. Consider the following example:</p>
<ul class="simple">
<li>revision 1: add tutorial.txt</li>
<li>revision 2: modify tutorial.txt</li>
<li>revision 3: rename tutorial.txt to guide.txt; add tutorial.txt</li>
</ul>
<p>In this case:</p>
<ul class="simple">
<li><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">guide.txt</span></code> will log the file added in revision 1</li>
<li><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">tutorial.txt</span></code> will log the new file added in revision 3</li>
<li><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">-r2</span> <span class="pre">-p</span> <span class="pre">tutorial.txt</span></code> will show the changes made to
the original file in revision 2.</li>
<li><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">-r2</span> <span class="pre">-p</span> <span class="pre">guide.txt</span></code> will display an error message as there
was no file called guide.txt in revision 2.</li>
</ul>
<p>Renames are always followed by log. By design, there is no need to
explicitly ask for this (and no way to stop logging a file back
until it was last renamed).</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name" colspan="2">Other filtering:</th></tr>
<tr class="field-odd field"><td> </td><td class="field-body"><p class="first">The –match option can be used for finding revisions that match a
regular expression in a commit message, committer, author or bug.
Specifying the option several times will match any of the supplied
expressions. –match-author, –match-bugs, –match-committer and
–match-message can be used to only match a specific field.</p>
</td>
</tr>
<tr class="field-even field"><th class="field-name">Tips & tricks:</th><td class="field-body"><p class="first">GUI tools and IDEs are often better at exploring history than command
line tools: you may prefer qlog or viz from qbzr or bzr-gtk, the
bzr-explorer shell, or the Loggerhead web interface. See the Plugin
Guide <<a class="reference external" href="http://doc.bazaar.canonical.com/plugins/en/">http://doc.bazaar.canonical.com/plugins/en/</a>> and
<<a class="reference external" href="http://wiki.bazaar.canonical.com/IDEIntegration">http://wiki.bazaar.canonical.com/IDEIntegration</a>>.</p>
<p>You may find it useful to add the aliases below to <code class="docutils literal notranslate"><span class="pre">bazaar.conf</span></code>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">ALIASES</span><span class="p">]</span>
<span class="n">tip</span> <span class="o">=</span> <span class="n">log</span> <span class="o">-</span><span class="n">r</span><span class="o">-</span><span class="mi">1</span>
<span class="n">top</span> <span class="o">=</span> <span class="n">log</span> <span class="o">-</span><span class="n">l10</span> <span class="o">--</span><span class="n">line</span>
<span class="n">show</span> <span class="o">=</span> <span class="n">log</span> <span class="o">-</span><span class="n">v</span> <span class="o">-</span><span class="n">p</span>
</pre></div>
</div>
<p><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">tip</span></code> will then show the latest revision while <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">top</span></code>
will show the last 10 mainline revisions. To see the details of a
particular revision X, <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">show</span> <span class="pre">-rX</span></code>.</p>
<p>If you are interested in looking deeper into a particular merge X,
use <code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">-n0</span> <span class="pre">-rX</span></code>.</p>
<p><code class="docutils literal notranslate"><span class="pre">bzr</span> <span class="pre">log</span> <span class="pre">-v</span></code> on a branch with lots of history is currently
very slow. A fix for this issue is currently under development.
With or without that fix, it is recommended that a revision range
be given when using the -v option.</p>
<p>bzr has a generic full-text matching plugin, bzr-search, that can be
used to find revisions matching user names, commit messages, etc.
Among other features, this plugin can find all revisions containing
a list of words but not others.</p>
<p>When exploring non-mainline history on large projects with deep
history, the performance of log can be greatly improved by installing
the historycache plugin. This plugin buffers historical information
trading disk space for faster speed.</p>
</td>
</tr>
<tr class="field-odd field"><th class="field-name">See also:</th><td class="field-body"><p class="first last"><a class="reference internal" href="log-formats-help.html"><span class="doc">log-formats</span></a>, <a class="reference internal" href="revisionspec-help.html"><span class="doc">revisionspec</span></a></p>
</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="join-help.html"
title="previous chapter">join</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="ls-help.html"
title="next chapter">ls</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-reference/log-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="ls-help.html" title="ls"
>next</a></li>
<li class="right" >
<a href="join-help.html" title="join"
>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>
