~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/configuring_bazaar.txt

• browse files at revision 4996
• compare with another revision
• download diff
• download tarball
• view history from revision 4996

• reverse the comparison (4996 to 963)
• stop comparing with revision 963

Show diffs side-by-side

added

removed

doc/en/user-guide/configuring_bazaar.txt

 

1

Configuring Bazaar

 

2

==================

 

3

 

 

4

Telling Bazaar about yourself

 

5

-----------------------------

 

6

 

 

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

 

13

identifier you want::

 

14

 

 

15

    % bzr whoami "Your Name <email@example.com>"

 

16

 

 

17

If ``whoami`` is used without an argument, the current value is displayed.

 

18

 

 

19

Configuration files

 

20

-------------------

 

21

 

 

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:

 

25

 

 

26

* ``bazaar.conf`` describes default configuration options,

 

27

 

 

28

* ``locations.conf`` describes configuration information for

 

29

  specific branch locations,

 

30

 

 

31

* ``authentication.conf`` describes credential information for

 

32

  remote servers.

 

33

 

 

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

 

37

override one of the values for a branch with a setting that is specific to you,

 

38

then you can do so in ``locations.conf``.

 

39

 

 

40

Here is sample content of ``bazaar.conf`` after setting an email address using

 

41

the ``whoami`` command::

 

42

 

 

43

  [DEFAULT]

 

44

  email = Your Name <email@example.com>

 

45

 

 

46

For further details on the syntax and configuration settings supported, see

 

47

`Configuration Settings <../user-reference/bzr_man.html#configuration-settings>`_

 

48

in the Bazaar User Reference.

 

49

 

 

50

 

 

51

Rule-based preferences

 

52

----------------------

 

53

 

 

54

Some commands and plugins provide custom processing on files matching

 

55

certain patterns. Per-user rule-based preferences are defined in

 

56

``BZR_HOME/rules``.

 

57

 

 

58

For further information on how rules are searched and the detailed syntax of

 

59

the relevant files, see `Rules <../user-reference/bzr_man.html#rules>`_

 

60

in the Bazaar User Reference.

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1