<!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>Configuring Bazaar — Bazaar v2.2.4 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.2.4',
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.2.4 documentation" href="../index.html" />
<link rel="up" title="Bazaar User Guide" href="index.html" />
<link rel="next" title="Using aliases" href="using_aliases.html" />
<link rel="prev" title="Getting help" href="getting_help.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="using_aliases.html" title="Using aliases"
accesskey="N">next</a></li>
<li class="right" >
<a href="getting_help.html" title="Getting help"
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.2.4)</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="configuring-bazaar">
<h1>Configuring Bazaar<a class="headerlink" href="#configuring-bazaar" title="Permalink to this headline">¶</a></h1>
<div class="section" id="telling-bazaar-about-yourself">
<h2>Telling Bazaar about yourself<a class="headerlink" href="#telling-bazaar-about-yourself" title="Permalink to this headline">¶</a></h2>
<p>One function of a version control system is to keep track of who changed
what. In a decentralized system, that requires an identifier for each
author that is globally unique. Most people already have one of these: an
email address. Bazaar is smart enough to automatically generate an email
address by looking up your username and hostname. If you don’t like the
guess that Bazaar makes, then use the <tt class="docutils literal"><span class="pre">whoami</span></tt> command to set the
identifier you want:</p>
<div class="highlight-python"><pre>% bzr whoami "Your Name <email@example.com>"</pre>
</div>
<p>If <tt class="docutils literal"><span class="pre">whoami</span></tt> is used without an argument, the current value is displayed.</p>
</div>
<div class="section" id="using-a-network-proxy">
<h2>Using a network proxy<a class="headerlink" href="#using-a-network-proxy" title="Permalink to this headline">¶</a></h2>
<p>If your network requires that you use an http proxy for outbound
connections, you must set the <tt class="docutils literal"><span class="pre">http_proxy</span></tt> variable. If the proxy is
also required for https connections, you need to set <tt class="docutils literal"><span class="pre">https_proxy</span></tt> too.
If you need these and don’t have them set, you may find that connections
to Launchpad or other external servers fail or time out.</p>
<p>On Unix you typically want to set these in <tt class="docutils literal"><span class="pre">/etc/environment</span></tt> or
<tt class="docutils literal"><span class="pre">~/.bash_profile</span></tt> and on Windows in the user profile.</p>
<div class="highlight-python"><pre>http_proxy=http://proxy.example.com:3128/
https_proxy=http://proxy.example.com:3128/</pre>
</div>
<p>The <tt class="docutils literal"><span class="pre">no_proxy</span></tt> variable can be set to a comma-separated list of hosts
which shouldn’t be reached by the proxy. (See
<<a class="reference external" href="http://docs.python.org/library/urllib.html">http://docs.python.org/library/urllib.html</a>> for more details.)</p>
</div>
<div class="section" id="configuration-files">
<h2>Configuration files<a class="headerlink" href="#configuration-files" title="Permalink to this headline">¶</a></h2>
<p>Configuration files are located in <tt class="docutils literal"><span class="pre">$HOME/.bazaar</span></tt> on Unix and
<tt class="docutils literal"><span class="pre">C:\Documents</span> <span class="pre">and</span> <span class="pre">Settings\<username>\Application</span> <span class="pre">Data\Bazaar\2.0</span></tt> on
Windows. There are three primary configuration files in this location:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">bazaar.conf</span></tt> describes default configuration options,</li>
<li><tt class="docutils literal"><span class="pre">locations.conf</span></tt> describes configuration information for
specific branch locations,</li>
<li><tt class="docutils literal"><span class="pre">authentication.conf</span></tt> describes credential information for
remote servers.</li>
</ul>
<p>Each branch can also contain a configuration file that sets values specific
to that branch. This file is found at <tt class="docutils literal"><span class="pre">.bzr/branch/branch.conf</span></tt> within the
branch. This file is visible to <strong>all users of a branch</strong>. If you wish to
override one of the values for a branch with a setting that is specific to you,
then you can do so in <tt class="docutils literal"><span class="pre">locations.conf</span></tt>.</p>
<p>Here is sample content of <tt class="docutils literal"><span class="pre">bazaar.conf</span></tt> after setting an email address using
the <tt class="docutils literal"><span class="pre">whoami</span></tt> command:</p>
<div class="highlight-python"><pre>[DEFAULT]
email = Your Name <email@example.com></pre>
</div>
<p>For further details on the syntax and configuration settings supported, see
<a class="reference external" href="../user-reference/index.html#configuration-settings">Configuration Settings</a>
in the Bazaar User Reference.</p>
</div>
<div class="section" id="rule-based-preferences">
<h2>Rule-based preferences<a class="headerlink" href="#rule-based-preferences" title="Permalink to this headline">¶</a></h2>
<p>Some commands and plugins provide custom processing on files matching
certain patterns. Per-user rule-based preferences are defined in
<tt class="docutils literal"><span class="pre">BZR_HOME/rules</span></tt>.</p>
<p>For further information on how rules are searched and the detailed syntax of
the relevant files, see <a class="reference external" href="../user-reference/index.html#rules">Rules</a>
in the Bazaar User Reference.</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="#">Configuring Bazaar</a><ul>
<li><a class="reference internal" href="#telling-bazaar-about-yourself">Telling Bazaar about yourself</a></li>
<li><a class="reference internal" href="#using-a-network-proxy">Using a network proxy</a></li>
<li><a class="reference internal" href="#configuration-files">Configuration files</a></li>
<li><a class="reference internal" href="#rule-based-preferences">Rule-based preferences</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="getting_help.html"
title="previous chapter">Getting help</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="using_aliases.html"
title="next chapter">Using aliases</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/user-guide/configuring_bazaar.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="using_aliases.html" title="Using aliases"
>next</a></li>
<li class="right" >
<a href="getting_help.html" title="Getting help"
>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.2.4)</a> »</li>
<li><a href="index.html" >Bazaar User Guide</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2009, Canonical Ltd.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
</html>
