4
Telling Bazaar about yourself
5
-----------------------------
7
One function of a version control system is to keep track of who changed
8
what. In a decentralized system, that requires an identifier for each
9
author that is globally unique. Most people already have one of these: an
10
email address. Bazaar is smart enough to automatically generate an email
11
address by looking up your username and hostname. If you don't like the
12
guess that Bazaar makes, then use the ``whoami`` command to set the
15
% bzr whoami "Your Name <email@example.com>"
17
If ``whoami`` is used without an argument, the current value is displayed.
22
Configuration files are located in ``$HOME/.bazaar`` on Linux/Unix and
23
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0`` on
24
Windows. There are three primary configuration files in this location:
26
* ``bazaar.conf`` describes default configuration options,
28
* ``locations.conf`` describes configuration information for
29
specific branch locations,
31
* ``authentication.conf`` describes credential information for
34
Each branch can also contain a configuration file that sets values specific
35
to that branch. This file is found at ``.bzr/branch/branch.conf`` within the
36
branch. This file is visible to all users of a branch, if you wish to override
37
one of the values for a branch with a setting that is specific to you then you
38
can do so in ``locations.conf``.
40
Here is sample content of ``bazaar.conf`` after setting an email address using
41
the ``whoami`` command::
44
email = Your Name <email@example.com>
46
For further details on the syntax and configuration settings supported, see
47
`Configuration reference`_ in the appendices.