← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/configuration.txt

  • Committer: James Henstridge
  • Date: 2007-01-02 07:16:27 UTC
  • mto: (2216.1.1 jam-integration)
  • mto: This revision was merged to the branch mainline in revision 2217.
  • Revision ID: james@jamesh.id.au-20070102071627-w5w976vfetuejhck
Fix RST syntax as suggested by j-a-meinel

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/configuration.txt
16
16
An ini file has three types of contructs: section headers, section
17
17
variables and comments.
18
18
 
19
 
comment
20
 
-------
 
19
Comments
 
20
--------
21
21
A comment is any line that starts with a "#" (sometimes called a "hash
22
22
mark", "pound sign" or "number sign"). Comment lines are ignored by
23
23
Bazaar when parsing ini files.
24
24
 
25
 
section header
26
 
--------------
 
25
Section Headers
 
26
---------------
27
27
A section header is a word enclosed in brackets that starts at the begining
28
28
of a line, typical section headers look like this::
29
29
 
43
43
 
44
44
 
45
45
 
46
 
section variables
 
46
Section Variables
47
47
-----------------
48
48
 
49
49
A section variable resides within a section. A section variable contains a
54
54
    check_signatures = require
55
55
 
56
56
 
57
 
variable policies
 
57
Variable Policies
58
58
-----------------
59
59
 
60
60
Variables defined in a section affect the named directory or URL plus
62
62
variable value is interpreted for contained locations.  Currently
63
63
there are three policies available:
64
64
 
65
 
 none: the value is interpreted the same for contained locations.
66
 
   This is the default behaviour.
67
 
 norecurse: the value is only used for the exact location specified by
68
 
   the section name.
69
 
 appendpath: for contained locations, any additional path components
70
 
   are appended to the value.
 
65
 none:
 
66
   the value is interpreted the same for contained locations.  This is
 
67
   the default behaviour.
 
68
 norecurse:
 
69
   the value is only used for the exact location specified by the
 
70
   section name.
 
71
 appendpath:
 
72
   for contained locations, any additional path components are
 
73
   appended to the value.
71
74
 
72
75
Policies are specified by keys with names of the form "$var:policy".
73
76
For example, to define the push location for a tree of branches, the
74
 
following could be used:
 
77
following could be used::
75
78
 
76
79
  [/top/location]
77
80
  push_location = sftp://example.com/location
78
81
  push_location:policy = appendpath
79
82
 
80
 
With this configuration, the push location for /top/location/branch1
81
 
would be sftp://example.com/location/branch1.
 
83
With this configuration, the push location for ``/top/location/branch1``
 
84
would be ``sftp://example.com/location/branch1``.
82
85
 
83
86
 
84
87
The main configuration file, bazaar.conf