<!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>Bug Tracker Settings — Bazaar 2.6.0 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.6.0',
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 2.6.0 documentation" href="../index.html" />
<link rel="up" title="Bazaar User Reference" href="index.html" />
<link rel="next" title="Configuration Settings" href="configuration-help.html" />
<link rel="prev" title="Authentication Settings" href="authentication-help.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="configuration-help.html" title="Configuration Settings"
accesskey="N">next</a></li>
<li class="right" >
<a href="authentication-help.html" title="Authentication Settings"
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.6.0)</a> »</li>
<li><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">
<div class="section" id="bug-tracker-settings">
<h1>Bug Tracker Settings<a class="headerlink" href="#bug-tracker-settings" title="Permalink to this headline">¶</a></h1>
<p>When making a commit, metadata about bugs fixed by that change can be
recorded by using the <tt class="docutils literal"><span class="pre">--fixes</span></tt> option. For each bug marked as fixed, an
entry is included in the ‘bugs’ revision property stating ‘<url> <status>’.
(The only <tt class="docutils literal"><span class="pre">status</span></tt> value currently supported is <tt class="docutils literal"><span class="pre">fixed.</span></tt>)</p>
<p>The <tt class="docutils literal"><span class="pre">--fixes</span></tt> option allows you to specify a bug tracker and a bug identifier
rather than a full URL. This looks like:</p>
<div class="highlight-python"><div class="highlight"><pre>bzr commit --fixes <tracker>:<id>
</pre></div>
</div>
<p>or:</p>
<div class="highlight-python"><div class="highlight"><pre>bzr commit --fixes <id>
</pre></div>
</div>
<p>where “<tracker>” is an identifier for the bug tracker, and “<id>” is the
identifier for that bug within the bugtracker, usually the bug number.
If “<tracker>” is not specified the <tt class="docutils literal"><span class="pre">bugtracker</span></tt> set in the branch
or global configuration is used.</p>
<p>Bazaar knows about a few bug trackers that have many users. If
you use one of these bug trackers then there is no setup required to
use this feature, you just need to know the tracker identifier to use.
These are the bugtrackers that are built in:</p>
<blockquote>
<div><table border="1" class="docutils">
<colgroup>
<col width="54%" />
<col width="23%" />
<col width="23%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">URL</th>
<th class="head">Abbreviation</th>
<th class="head">Example</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td><a class="reference external" href="https://bugs.launchpad.net/">https://bugs.launchpad.net/</a></td>
<td>lp</td>
<td>lp:12345</td>
</tr>
<tr class="row-odd"><td><a class="reference external" href="http://bugs.debian.org/">http://bugs.debian.org/</a></td>
<td>deb</td>
<td>deb:12345</td>
</tr>
<tr class="row-even"><td><a class="reference external" href="http://bugzilla.gnome.org/">http://bugzilla.gnome.org/</a></td>
<td>gnome</td>
<td>gnome:12345</td>
</tr>
</tbody>
</table>
</div></blockquote>
<p>For the bug trackers not listed above configuration is required.
Support for generating the URLs for any project using Bugzilla or Trac
is built in, along with a template mechanism for other bugtrackers with
simple URL schemes. If your bug tracker can’t be described by one
of the schemes described below then you can write a plugin to support
it.</p>
<p>If you use Bugzilla or Trac, then you only need to set a configuration
variable which contains the base URL of the bug tracker. These options
can go into <tt class="docutils literal"><span class="pre">bazaar.conf</span></tt>, <tt class="docutils literal"><span class="pre">branch.conf</span></tt> or into a branch-specific
configuration section in <tt class="docutils literal"><span class="pre">locations.conf</span></tt>. You can set up these values
for each of the projects you work on.</p>
<p>Note: As you provide a short name for each tracker, you can specify one or
more bugs in one or more trackers at commit time if you wish.</p>
<div class="section" id="launchpad">
<h2>Launchpad<a class="headerlink" href="#launchpad" title="Permalink to this headline">¶</a></h2>
<p>Use <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">lp:2</span></tt> to record that this commit fixes bug 2.</p>
</div>
<div class="section" id="bugzilla-tracker-url">
<h2>bugzilla_<tracker>_url<a class="headerlink" href="#bugzilla-tracker-url" title="Permalink to this headline">¶</a></h2>
<p>If present, the location of the Bugzilla bug tracker referred to by
<tracker>. This option can then be used together with <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span>
<span class="pre">--fixes</span></tt> to mark bugs in that tracker as being fixed by that commit. For
example:</p>
<div class="highlight-python"><div class="highlight"><pre>bugzilla_squid_url = http://bugs.squid-cache.org
</pre></div>
</div>
<p>would allow <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">squid:1234</span></tt> to mark Squid’s bug 1234 as
fixed.</p>
</div>
<div class="section" id="trac-tracker-url">
<h2>trac_<tracker>_url<a class="headerlink" href="#trac-tracker-url" title="Permalink to this headline">¶</a></h2>
<p>If present, the location of the Trac instance referred to by
<tracker>. This option can then be used together with <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span>
<span class="pre">--fixes</span></tt> to mark bugs in that tracker as being fixed by that commit. For
example:</p>
<div class="highlight-python"><div class="highlight"><pre>trac_twisted_url = http://www.twistedmatrix.com/trac
</pre></div>
</div>
<p>would allow <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">twisted:1234</span></tt> to mark Twisted’s bug 1234 as
fixed.</p>
</div>
<div class="section" id="bugtracker-tracker-url">
<h2>bugtracker_<tracker>_url<a class="headerlink" href="#bugtracker-tracker-url" title="Permalink to this headline">¶</a></h2>
<p>If present, the location of a generic bug tracker instance referred to by
<tracker>. The location must contain an <tt class="docutils literal"><span class="pre">{id}</span></tt> placeholder,
which will be replaced by a specific bug ID. This option can then be used
together with <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span></tt> to mark bugs in that tracker as being
fixed by that commit. For example:</p>
<div class="highlight-python"><div class="highlight"><pre>bugtracker_python_url = http://bugs.python.org/issue{id}
</pre></div>
</div>
<p>would allow <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">python:1234</span></tt> to mark bug 1234 in Python’s
Roundup bug tracker as fixed, or:</p>
<div class="highlight-python"><div class="highlight"><pre>bugtracker_cpan_url = http://rt.cpan.org/Public/Bug/Display.html?id={id}
</pre></div>
</div>
<p>would allow <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">cpan:1234</span></tt> to mark bug 1234 in CPAN’s
RT bug tracker as fixed, or:</p>
<div class="highlight-python"><div class="highlight"><pre>bugtracker_hudson_url = http://issues.hudson-ci.org/browse/{id}
</pre></div>
</div>
<p>would allow <tt class="docutils literal"><span class="pre">bzr</span> <span class="pre">commit</span> <span class="pre">--fixes</span> <span class="pre">hudson:HUDSON-1234</span></tt> to mark bug HUDSON-1234
in Hudson’s JIRA bug tracker as fixed.</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="#">Bug Tracker Settings</a><ul>
<li><a class="reference internal" href="#launchpad">Launchpad</a></li>
<li><a class="reference internal" href="#bugzilla-tracker-url">bugzilla_<tracker>_url</a></li>
<li><a class="reference internal" href="#trac-tracker-url">trac_<tracker>_url</a></li>
<li><a class="reference internal" href="#bugtracker-tracker-url">bugtracker_<tracker>_url</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="authentication-help.html"
title="previous chapter">Authentication Settings</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="configuration-help.html"
title="next chapter">Configuration Settings</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-reference/bugs-help.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" />
<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="configuration-help.html" title="Configuration Settings"
>next</a></li>
<li class="right" >
<a href="authentication-help.html" title="Authentication Settings"
>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.6.0)</a> »</li>
<li><a href="index.html" >Bazaar User Reference</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009-2011 Canonical Ltd.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-updates
>
by-pkgid
>
27647990744ebd9cfe32398f37f67e20
>
files
>
3068
