~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/configuration.txt

  • Committer: Patch Queue Manager
  • Date: 2011-12-21 21:27:34 UTC
  • mfrom: (6385.1.7 906897-quoting-stores)
  • Revision ID: pqm@pqm.ubuntu.com-20111221212734-aea6s92gkpux3fky
(vila) Stores allow Stacks to control when values are quoted/unquoted
 (Vincent Ladeuil)

Show diffs side-by-side

added added

removed removed

Lines of Context:
205
205
 
206
206
The value of an option is a unicode string or ``None`` if it's not
207
207
defined. By using ``from_unicode`` you can turn this string into a more
208
 
appropriate representation (a list of unicode strings for example).
 
208
appropriate representation.
 
209
 
 
210
If you need a list value, you should use ``ListOption`` instead.
 
211
 
209
212
 
210
213
Sections
211
214
--------
249
252
places to inherit from the existing basic tests and add their own specific
250
253
ones.
251
254
 
 
255
A ``Store`` defines how option values are stored, this includes:
 
256
 
 
257
* defining the sections where the options are grouped,
 
258
 
 
259
* defining how the values are quoted/unquoted for storage purposes. Stacks
 
260
  use the unquoted values internally (default value handling and option
 
261
  expansion are simpler this way) and ``bzr config`` quote them when they
 
262
  need to be displayed.
 
263
 
 
264
 
252
265
Filtering sections
253
266
------------------
254
267