← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/configuration.txt

  • Committer: Brad Crittenden
  • Date: 2007-03-02 12:40:45 UTC
  • mto: This revision was merged to the branch mainline in revision 2311.
  • Revision ID: bac@canonical.com-20070302124045-3a9o45va231z0w0a
post review changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/configuration.txt
25
25
Section Headers
26
26
---------------
27
27
A section header is a word enclosed in brackets that starts at the begining
28
 
of a line.  A typical section headers look like this::
 
28
of a line.  A typical section header looks like this::
29
29
 
30
30
    [DEFAULT]
31
31
 
32
 
The only valid section header for bazaar.conf is [DEFAULT], which is case
33
 
sensitive. The default section provides for setting variables which can be
34
 
overridden with the branch config file.
 
32
The only valid section header for bazaar.conf is [DEFAULT], which is
 
33
case sensitive. The default section provides for setting variables
 
34
which can be overridden with the branch config file.
35
35
 
36
 
For ``locations.conf``, the variables from the section with the longest matching
37
 
section header are used to the exclusion of other potentially valid section
38
 
headers. A section header uses the path for the branch as the section
39
 
header. Some examples include::
 
36
For ``locations.conf``, the variables from the section with the
 
37
longest matching section header are used to the exclusion of other
 
38
potentially valid section headers. A section header uses the path for
 
39
the branch as the section header. Some examples include::
40
40
 
41
41
    [http://mybranches.isp.com/~jdoe/branchdir]
42
42
    [/home/jdoe/branches/]
89
89
The main configuration file, ``$HOME/.bazaar/bazaar.conf``, only allows one
90
90
section called ``[DEFAULT]``. This default section contains the default
91
91
configuration options for all branches. The default section can be
92
 
overriden by providing a branch specific section in ``locations.conf``.
 
92
overriden by providing a branch-specific section in ``locations.conf``.
93
93
 
94
94
A typical ``bazaar.conf`` section often looks like the following::
95
95
 
158
158
    signed revisions.
159
159
 
160
160
never
161
 
    Refuse to sign newly committed revisions, even if the branch requires signatures.
 
161
    Refuse to sign newly committed revisions, even if the branch
 
162
    requires signatures.
162
163
 
163
164
recurse
164
165
-------
165
 
Only useful in ``locations.conf``. Defines whether or not the configuration for
166
 
this section applies to subdirectories:
 
166
Only useful in ``locations.conf``. Defines whether or not the
 
167
configuration for this section applies to subdirectories:
167
168
 
168
169
true
169
 
    (default) This section applies to subdirectories.
 
170
    (default) This section applies to subdirectories as well.
170
171
 
171
172
false
172
173
    This section only applies to the branch at this directory and not
189
190
 
190
191
append_revisions_only
191
192
---------------------
192
 
If set to "true" then revisions can only be appended to the log, not
 
193
If set to "True" then revisions can only be appended to the log, not
193
194
removed.  A branch with this setting enabled can only pull from
194
195
another branch if the other branch's log is a longer version of its
195
196
own.  This is normally set by ``bzr init --append-revisions-only``.