← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/configuration.txt

(jelmer) Add flag to indicate whether a repository supports unreferenced
 revisions. (Jelmer Vernooij)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/configuration.txt
47
47
MutableSection is needed to set or remove an option, ReadOnlySection should
48
48
be used otherwise.
49
49
 
50
 
 
51
50
Stores
52
51
------
53
52
 
80
79
------------------
81
80
 
82
81
For some contexts, only some sections from a given store will apply. Defining
83
 
which is what the ``SectionMatcher`` objects are about.
 
82
which is what the ``SectionMatcher`` are about.
84
83
 
85
84
The main constraint here is that a ``SectionMatcher`` should delay the loading
86
85
of the associated store as long as possible. The constructor should collect
93
92
to implement the ``appendpath`` policy for example). If no sections match,
94
93
an empty list is returned.
95
94
 
96
 
Options local to a section can also be defined for special purposes and be
97
 
handled by ``Section.get()``. One such option is ``relpath`` which is
98
 
defined in ``LocationSection`` as an alternative to the ``appendpath``
99
 
policy.
100
 
 
101
 
For ``appendpath``, the ``LocationSection`` will carry ``extra_path`` as the
102
 
relative path between the section name and the location used. ``relpath``
103
 
will be available as a ``Section`` local option with the same
104
 
value. ``basename`` will carry the location base name and be available as a
105
 
local option with the same name. Note that such options can only be expanded
106
 
inside the section that defines them.
 
95
.. FIXME: Replace the appendpath example if/when it's deprecated ;)
107
96
 
108
97
Specific section matchers can be implemented by overriding ``get_sections``
109
98
or just ``match``.