← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: John Arbash Meinel
  • Date: 2011-05-11 11:35:28 UTC
  • mto: This revision was merged to the branch mainline in revision 5851.
  • Revision ID: john@arbash-meinel.com-20110511113528-qepibuwxicjrbb2h
Break compatibility with python <2.6.

This includes auditing the code for places where we were doing
explicit 'sys.version' checks and removing them as appropriate.

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/configuration.txt
59
59
 
60
60
Path to the editor Bazaar should use for commit messages, etc.
61
61
 
 
62
BZR_LOG
 
63
~~~~~~~
 
64
 
 
65
Location of the Bazaar log file. You can check the current location by
 
66
running ``bzr version``.
 
67
 
 
68
The log file contains debug information that is useful for diagnosing or
 
69
reporting problems with Bazaar.
 
70
 
 
71
Setting this to ``NUL`` on Windows or ``/dev/null`` on other platforms
 
72
will disable logging.
 
73
 
 
74
 
62
75
BZR_PLUGIN_PATH
63
76
~~~~~~~~~~~~~~~
64
77
 
77
90
 
78
91
As for the ``PATH`` variables, if multiple directories are
79
92
specified in ``BZR_PLUGIN_PATH`` they should be separated by the
80
 
platform specific appropriate character (':' on Unix/Linux/etc,
 
93
platform specific appropriate character (':' on Unix,
81
94
';' on windows)
82
95
 
83
96
By default if ``BZR_PLUGIN_PATH`` is set, it replaces searching
166
179
The path where Bazaar should look for shell plugin external commands.
167
180
 
168
181
 
 
182
http_proxy, https_proxy
 
183
~~~~~~~~~~~~~~~~~~~~~~~
 
184
 
 
185
Specifies the network proxy for outgoing connections, for example::
 
186
 
 
187
  http_proxy=http://proxy.example.com:3128/ 
 
188
  https_proxy=http://proxy.example.com:3128/
 
189
 
 
190
 
169
191
Configuration files
170
192
-------------------
171
193
 
172
194
Location
173
195
~~~~~~~~
174
196
 
175
 
Configuration files are located in ``$HOME/.bazaar`` on Linux/Unix and
 
197
Configuration files are located in ``$HOME/.bazaar`` on Unix and
176
198
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0`` on
177
199
Windows. (You can check the location for your system by using
178
200
``bzr version``.)
236
258
    email            = John Doe <jdoe@isp.com>
237
259
    check_signatures = require
238
260
 
 
261
A variable can reference other variables **in the same configuration file** by
 
262
enclosing them in curly brackets::
 
263
 
 
264
    my_branch_name = feature_x
 
265
    my_server      = bzr+ssh://example.com
 
266
    push_location   = {my_server}/project/{my_branch_name}
 
267
 
239
268
 
240
269
Variable policies
241
270
^^^^^^^^^^^^^^^^^
300
329
    create_signatures = always
301
330
    check_signatures  = always
302
331
 
303
 
    [http://bazaar-vcs.org/bzr/*]
 
332
    [http://example.com/bzr/*]
304
333
    check_signatures  = require
305
334
 
306
335
The authentication configuration file, authentication.conf
482
511
    whether the format deprecation warning is shown on repositories that are
483
512
    using deprecated formats.
484
513
 
 
514
default_format
 
515
~~~~~~~~~~~~~~
 
516
 
 
517
A format name for the default format used when creating branches.  See ``bzr
 
518
help formats`` for possible values.
 
519
 
 
520
 
 
521
Unicode options
 
522
---------------
 
523
 
 
524
output_encoding
 
525
~~~~~~~~~~~~~~~
 
526
 
 
527
A Python unicode encoding name for text output from bzr, such as log
 
528
information.  Values include: utf8, cp850, ascii, iso-8859-1.  The default
 
529
is the terminal encoding prefered by the operating system.
 
530
 
485
531
 
486
532
Branch type specific options
487
533
----------------------------
545
591
If present, defines the ``--strict`` option default value for checking
546
592
uncommitted changes before sending a merge directive.
547
593
 
 
594
 
 
595
External Merge Tools
 
596
--------------------
 
597
 
 
598
bzr.mergetool.<name>
 
599
~~~~~~~~~~~~~~~~~~~~
 
600
 
 
601
Defines an external merge tool called <name> with the given command-line.
 
602
Arguments containing spaces should be quoted using single or double quotes. The
 
603
executable may omit its path if it can be found on the PATH.
 
604
 
 
605
The following markers can be used in the command-line to substitute filenames
 
606
involved in the merge conflict:
 
607
 
 
608
{base}      file.BASE
 
609
{this}      file.THIS
 
610
{other}     file.OTHER
 
611
{result}    output file
 
612
{this_temp} temp copy of file.THIS, used to overwrite output file if merge
 
613
            succeeds.
 
614
 
 
615
For example:
 
616
 
 
617
  bzr.mergetool.kdiff3 = kdiff3 {base} {this} {other} -o {result}
 
618
 
 
619
bzr.default_mergetool
 
620
~~~~~~~~~~~~~~~~~
 
621
 
 
622
Specifies which external merge tool (as defined above) should be selected by
 
623
default in tools such as ``bzr qconflicts``.
 
624
 
 
625
For example:
 
626
 
 
627
  bzr.default_mergetool = kdiff3