<!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="Content-Type" content="text/html; charset=utf-8" />
<title>Annotating changes — Bazaar v2.4.2 documentation</title>
<link rel="stylesheet" href="../_static/default.css" type="text/css" />
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../',
VERSION: '2.4.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</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>
<link rel="shortcut icon" href="../_static/bzr.ico"/>
<link rel="top" title="Bazaar v2.4.2 documentation" href="../index.html" />
<link rel="up" title="Bazaar User Guide" href="index.html" />
<link rel="next" title="Centralized development" href="central_intro.html" />
<link rel="prev" title="Resolving conflicts" href="resolving_conflicts.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="central_intro.html" title="Centralized development"
accesskey="N">next</a></li>
<li class="right" >
<a href="resolving_conflicts.html" title="Resolving conflicts"
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><a href="../index.html">Table of Contents (2.4.2)</a> »</li>
<li><a href="index.html" accesskey="U">Bazaar User Guide</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="annotating-changes">
<h1>Annotating changes<a class="headerlink" href="#annotating-changes" title="Permalink to this headline">¶</a></h1>
<div class="section" id="seeing-the-origin-of-content">
<h2>Seeing the origin of content<a class="headerlink" href="#seeing-the-origin-of-content" title="Permalink to this headline">¶</a></h2>
<p>When two or more people are working on files, it can be highly
useful at times to see who created or last changed certain content.
To do this, using the annotate command like this:</p>
<div class="highlight-python"><pre>bzr annotate readme.txt</pre>
</div>
<p>If you are a pessimist or an optimist, you might prefer to use
one of built-in aliases for <tt class="docutils literal"><span class="pre">annotate</span></tt>: <tt class="docutils literal"><span class="pre">blame</span></tt> or <tt class="docutils literal"><span class="pre">praise</span></tt>.
Either way, this displays each line of the file together with
information such as:</p>
<blockquote>
<div><ul class="simple">
<li>who changed it last</li>
<li>when it was last changed</li>
<li>the commit message.</li>
</ul>
</div></blockquote>
</div>
<div class="section" id="gui-tools">
<h2>GUI tools<a class="headerlink" href="#gui-tools" title="Permalink to this headline">¶</a></h2>
<p>The various GUI plugins for Bazaar provide graphical tools for
viewing annotation information. For example, the bzr-gtk plugin
provides a GUI tool for this that can be launched using the
<tt class="docutils literal"><span class="pre">gannotate</span></tt> command:</p>
<div class="highlight-python"><pre>bzr gannotate readme.txt</pre>
</div>
<p>The GUI tools typically provide a much richer display of
interesting information (e.g. all the changes in each commit)
so you may prefer them over the text-based command.</p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="../index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Annotating changes</a><ul>
<li><a class="reference internal" href="#seeing-the-origin-of-content">Seeing the origin of content</a></li>
<li><a class="reference internal" href="#gui-tools">GUI tools</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="resolving_conflicts.html"
title="previous chapter">Resolving conflicts</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="central_intro.html"
title="next chapter">Centralized development</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-guide/annotating_changes.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="../search.html" method="get">
<input type="text" name="q" size="18" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="central_intro.html" title="Centralized development"
>next</a></li>
<li class="right" >
<a href="resolving_conflicts.html" title="Resolving conflicts"
>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><a href="../index.html">Table of Contents (2.4.2)</a> »</li>
<li><a href="index.html" >Bazaar User Guide</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
</html>
