← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/configuration.txt

  • Committer: Jelmer Vernooij
  • Date: 2011-09-12 09:51:52 UTC
  • mfrom: (6129 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6130.
  • Revision ID: jelmer@samba.org-20110912095152-04atttpiqgn2lzjw
merge bzr.dev

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/configuration.txt
86
86
all data needed for the selection and uses it while processing the sections in
87
87
``get_sections``.
88
88
 
89
 
Only ``ReadOnlySection`` objects are manipulated here but a ``SectionMatcher``
90
 
can return dedicated ``Section`` to provide additional context (the
91
 
``LocationSection`` add an ``extra_path`` attribute to implement the
92
 
``appendpath`` policy for example).
 
89
Only ``ReadOnlySection`` objects are manipulated here but a
 
90
``SectionMatcher`` can return dedicated ``Section`` objects to provide
 
91
additional context (the ``LocationSection`` add an ``extra_path`` attribute
 
92
to implement the ``appendpath`` policy for example). If no sections match,
 
93
an empty list is returned.
93
94
 
94
95
.. FIXME: Replace the appendpath example if/when it's deprecated ;)
95
96
 
 
97
Specific section matchers can be implemented by overriding ``get_sections``
 
98
or just ``match``.
 
99
 
 
100
``bzrlib`` provides:
 
101
 
 
102
* ``LocationMatcher(store, location)``: To select all sections that match
 
103
  ``location``.
 
104
 
 
105
* ``NameMatcher(store, unique_id)``: To select a single section matching
 
106
  ``unique_id``.
 
107
 
96
108
Stacks
97
109
------
98
110