← Back to branch summary

~michael-ellerman/bzr/mpe

« back to all changes in this revision

Viewing changes to doc/configuration.txt

[merge] bzr.dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/configuration.txt
2
2
==============================
3
3
Each user gets a pair of configurations files in $HOME/.bazaar. The first
4
4
one, named bazaar.conf, includes default configuration options. The other
5
 
file, branches.conf, contains configuration information for specific
6
 
branches.
 
5
file, locations.conf, contains configuration information for specific
 
6
branch locations.
7
7
 
8
8
General Format
9
9
==============
27
27
senstive. The default section provides for setting variables which can be
28
28
overridden with the branch config file.
29
29
 
30
 
For branches.conf, the variables from the section with the longest matching
 
30
For locations.conf, the variables from the section with the longest matching
31
31
section header are used to the exclusion of other potentially valid section
32
32
headers. A section header uses the path for the branch as the section
33
33
header. Some examples include::
54
54
The main configuration file, $HOME/.bazaar/bazaar.conf, only allows one
55
55
section called '''[DEFAULT]'''. This default section contains the default
56
56
configuration options for all branches. The default section can be
57
 
overriden by providing a branch specific section in branches.conf.
 
57
overriden by providing a branch specific section in locations.conf.
58
58
 
59
59
A typical bazaar.conf section often looks like the following::
60
60
 
64
64
    check_signatures  = check-available
65
65
    create_signatures = when-required
66
66
 
67
 
$HOME/.bazaar/branches.conf allows one to specify overriding settings for a
 
67
$HOME/.bazaar/locations.conf allows one to specify overriding settings for a
68
68
specific branch. The format is almost identical to the default section in
69
69
bazaar.conf with one significant change: The section header, instead of
70
70
saying default, will be the path to a branch that you wish to override a
128
128
 
129
129
recurse
130
130
-------
131
 
Only useful in branches.conf. Defines whether or not the configuration for
 
131
Only useful in locations.conf. Defines whether or not the configuration for
132
132
this section applies to subdirectories:
133
133
 
134
134
true