/breezy/unstable

To get this branch, use:
bzr branch https://code.breezy-vcs.org/breezy/unstable

« back to all changes in this revision

Viewing changes to breezy/help_topics/en/configuration.txt

  • Committer: Jelmer Vernooij
  • Date: 2017-05-24 01:39:33 UTC
  • mfrom: (3815.3776.6)
  • Revision ID: jelmer@jelmer.uk-20170524013933-ir4y4tqtrsiz2ka2
New upstream snapshot.

Show diffs side-by-side

added added

removed removed

Lines of Context:
7
7
While most configuration is handled by configuration files, some options
8
8
which may be semi-permanent can also be controlled through the environment.
9
9
 
10
 
BZR_EMAIL
 
10
BRZ_EMAIL
11
11
~~~~~~~~~
12
12
 
13
 
Override the email id used by Bazaar.  Typical format::
 
13
Override the email id used by Breezy.  Typical format::
14
14
 
15
15
  "John Doe <jdoe@example.com>"
16
16
 
17
17
See also the ``email`` configuration option.
18
18
 
19
 
BZR_PROGRESS_BAR
 
19
BRZ_PROGRESS_BAR
20
20
~~~~~~~~~~~~~~~~
21
21
 
22
22
Override the progress display.  Possible values are "none" or "text".  If
23
23
the value is "none" then no progress bar is displayed.  The value "text" draws
24
24
the ordinary command line progress bar.
25
25
 
26
 
BZR_SIGQUIT_PDB
 
26
BRZ_SIGQUIT_PDB
27
27
~~~~~~~~~~~~~~~
28
28
 
29
29
Control whether SIGQUIT behaves normally or invokes a breakin debugger.
31
31
* 0 = Standard SIGQUIT behavior (normally, exit with a core dump)
32
32
* 1 = Invoke breakin debugger (default)
33
33
 
34
 
BZR_HOME
 
34
BRZ_HOME
35
35
~~~~~~~~
36
36
 
37
 
Override the home directory used by Bazaar.
 
37
Override the home directory used by Breezy.
38
38
 
39
 
BZR_SSH
 
39
BRZ_SSH
40
40
~~~~~~~
41
41
 
42
42
Select a different SSH implementation.
43
43
 
44
 
BZR_PDB
 
44
BRZ_PDB
45
45
~~~~~~~
46
46
 
47
47
Control whether to launch a debugger on error.
52
52
BZR_REMOTE_PATH
53
53
~~~~~~~~~~~~~~~
54
54
 
55
 
Path to the Bazaar executable to use when using the bzr+ssh protocol.
 
55
Path to the Bazaar or Breezy executable to use when using the bzr+ssh protocol.
56
56
 
57
57
See also the ``bzr_remote_path`` configuration option.
58
58
 
59
 
BZR_EDITOR
 
59
BRZ_EDITOR
60
60
~~~~~~~~~~
61
61
 
62
 
Path to the editor Bazaar should use for commit messages, etc.
 
62
Path to the editor Breezy should use for commit messages, etc.
63
63
 
64
 
BZR_LOG
 
64
BRZ_LOG
65
65
~~~~~~~
66
66
 
67
 
Location of the Bazaar log file. You can check the current location by
 
67
Location of the Breezy log file. You can check the current location by
68
68
running ``bzr version``.
69
69
 
70
70
The log file contains debug information that is useful for diagnosing or
71
 
reporting problems with Bazaar.
 
71
reporting problems with Breezy.
72
72
 
73
73
Setting this to ``NUL`` on Windows or ``/dev/null`` on other platforms
74
74
will disable logging.
75
75
 
76
76
 
77
 
BZR_PLUGIN_PATH
 
77
BRZ_PLUGIN_PATH
78
78
~~~~~~~~~~~~~~~
79
79
 
80
 
The path to the plugins directory that Bazaar should use.
81
 
If not set, Bazaar will search for plugins in:
 
80
The path to the plugins directory that Breezy should use.
 
81
If not set, Breezy will search for plugins in:
82
82
 
83
83
* the user specific plugin directory (containing the ``user`` plugins),
84
84
 
85
 
* the bzrlib directory (containing the ``core`` plugins),
 
85
* the breezy directory (containing the ``core`` plugins),
86
86
 
87
87
* the site specific plugin directory if applicable (containing
88
88
  the ``site`` plugins).
132
132
 
133
133
  BZR_PLUGIN_PATH='/path/to/my/site/plugins:-site':+user
134
134
 
135
 
BZR_DISABLE_PLUGINS
 
135
BRZ_DISABLE_PLUGINS
136
136
~~~~~~~~~~~~~~~~~~~
137
137
 
138
138
Under special circumstances (mostly when trying to diagnose a
148
148
 
149
149
  BZR_DISABLE_PLUGINS='myplugin:yourplugin'
150
150
 
151
 
BZR_PLUGINS_AT
 
151
BRZ_PLUGINS_AT
152
152
~~~~~~~~~~~~~~
153
153
 
154
154
When adding a new feature or working on a bug in a plugin,
175
175
Using a specific version of ``myplugin``:
176
176
``BZR_PLUGINS_AT='myplugin@/home/me/bugfixes/123456-myplugin``
177
177
 
178
 
BZRPATH
 
178
BRZPATH
179
179
~~~~~~~
180
180
 
181
 
The path where Bazaar should look for shell plugin external commands.
 
181
The path where Breezy should look for shell plugin external commands.
182
182
 
183
183
 
184
184
http_proxy, https_proxy
197
197
~~~~~~~~
198
198
 
199
199
Configuration files are located in ``$HOME/.bazaar`` on Unix and
200
 
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0`` on
 
200
``C:\Documents and Settings\<username>\Application Data\Breezy\2.0`` on
201
201
Windows. (You can check the location for your system by using
202
202
``bzr version``.)
203
203
 
228
228
 
229
229
A comment is any line that starts with a "#" (sometimes called a "hash
230
230
mark", "pound sign" or "number sign"). Comment lines are ignored by
231
 
Bazaar when parsing ini files.
 
231
Breezy when parsing ini files.
232
232
 
233
233
Section headers
234
234
^^^^^^^^^^^^^^^
448
448
 
449
449
check-available
450
450
    (default) If gnupg signatures for revisions are present, check them.
451
 
    Bazaar will fail if it finds a bad signature, but will not fail if
 
451
    Breezy will fail if it finds a bad signature, but will not fail if
452
452
    no signature is present.
453
453
 
454
454
create_signatures
483
483
 
484
484
The GnuPG user identity to use when signing commits.  Can be an e-mail
485
485
address, key fingerprint or full key ID.  When unset or when set to
486
 
"default" Bazaar will use the user e-mail set with ``whoami``.
 
486
"default" Breezy will use the user e-mail set with ``whoami``.
487
487
 
488
488
recurse
489
489
~~~~~~~
523
523
smtp_server
524
524
~~~~~~~~~~~
525
525
 
526
 
(Default: "localhost"). SMTP server to use when Bazaar needs to send
 
526
(Default: "localhost"). SMTP server to use when Breezy needs to send
527
527
email, eg. with ``merge-directive --mail-to``, or the bzr-email plugin.
528
528
 
529
529
smtp_username, smtp_password
530
530
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
531
531
 
532
532
User and password to authenticate to the SMTP server. If smtp_username
533
 
is set, and smtp_password is not, Bazaar will prompt for a password.
 
533
is set, and smtp_password is not, Breezy will prompt for a password.
534
534
These settings are only needed if the SMTP server requires authentication
535
535
to send mail.
536
536