← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/en/user-guide/configuring_bazaar.txt

  • Committer: Patch Queue Manager
  • Date: 2012-09-19 07:12:28 UTC
  • mfrom: (6561.1.1 996401-doc-config)
  • Revision ID: pqm@pqm.ubuntu.com-20120919071228-yd09pv4quo9hxtf2
(vila) Clarify option references expansion for `bzr config`. (Vincent
 Ladeuil)

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/configuring_bazaar.txt
129
129
Each configuration file is associated with a given scope whose name is
130
130
displayed before each set of defined options.
131
131
 
 
132
If you need to look at a specific option, you can use::
 
133
 
 
134
  bzr config <option>
 
135
 
 
136
This will display only the option value and is intended to be used in
 
137
scripts.
 
138
 
132
139
Modifying the active configuration
133
140
----------------------------------
134
141
 
136
143
 
137
144
  bzr config opt=value
138
145
 
 
146
An option value can reference another option by enclosing it in curly
 
147
braces::
 
148
 
 
149
  bzr config opt={other_opt}/subdir
 
150
 
 
151
If ``other_opt`` is set to ``'root``, ``bzr config opt`` will display::
 
152
 
 
153
  root/subdir
 
154
 
 
155
Note that when ``--all`` is used, the references are left as-is to better
 
156
reflect the content of the config files and make it easier to organize them::
 
157
 
 
158
  bzr config --all .*opt
 
159
 
 
160
  bazaar:
 
161
    [DEFAULT]
 
162
    opt = {other_opt}/subdir
 
163
    other_opt = root
 
164
 
 
165
 
 
166
 
 
167
 
 
168
 
139
169
To remove an option use::
140
170
 
141
171
  bzr config --remove opt