← 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: Vincent Ladeuil
  • Date: 2011-07-06 09:22:00 UTC
  • mfrom: (6008 +trunk)
  • mto: (6012.1.1 trunk)
  • mto: This revision was merged to the branch mainline in revision 6013.
  • Revision ID: v.ladeuil+lp@free.fr-20110706092200-7iai2mwzc0sqdsvf
Merging in trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/configuring_bazaar.txt
37
37
which shouldn't be reached by the proxy.  (See
38
38
<http://docs.python.org/library/urllib.html> for more details.)
39
39
 
 
40
Various ways to configure
 
41
-------------------------
 
42
 
 
43
As shown in the example above, there are various ways to
 
44
configure Bazaar, they all share some common properties though.
 
45
An option has:
 
46
 
 
47
- a name which is generally a valid python identifier,
 
48
 
 
49
- a value which is a string. In some cases, Bazaar will be able
 
50
  to recognize special values like 'True', 'False' to infer a
 
51
  boolean type, but basically, as a user, you will always specify
 
52
  a value as a string.
 
53
 
 
54
Options are grouped in various contexts so the option name
 
55
uniquely identifies it in this context. When needed, options can
 
56
be made persistent by recording them in a configuration file.
 
57
 
40
58
 
41
59
Configuration files
42
60
-------------------
133
151
For further information on how rules are searched and the detailed syntax of
134
152
the relevant files, see `Rules <../user-reference/index.html#rules>`_
135
153
in the Bazaar User Reference.
 
154
 
 
155
 
 
156
Escaping command lines
 
157
----------------------
 
158
 
 
159
When you give a program name or command line in configuration, you can quote
 
160
to include special characters or whitespace.  The same rules are used across
 
161
all platforms.
 
162
 
 
163
The rules are: strings surrounded by double-quotes are interpreted as single
 
164
"words" even if they contain whitespace, and backslash may be used to quote
 
165
quotation marks.  For example::
 
166
 
 
167
    BZR_EDITOR="C:\Program Files\My Editor\myeditor.exe"