← 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

(jameinel) Bug #581311,
 treat WSAECONNABORTED as ConnectionReset. (John A Meinel)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/help_topics/en/configuration.txt
19
19
BZR_PROGRESS_BAR
20
20
~~~~~~~~~~~~~~~~
21
21
 
22
 
Override the progress display.  Possible values are "none" or "text".  If
23
 
the value is "none" then no progress bar is displayed.  The value "text" draws
24
 
the ordinary command line progress bar.
 
22
Override the progress display.  Possible values are "none", "dots", "tty"
25
23
 
26
24
BZR_SIGQUIT_PDB
27
25
~~~~~~~~~~~~~~~
260
258
    email            = John Doe <jdoe@isp.com>
261
259
    check_signatures = require
262
260
 
263
 
A variable can reference other variables **in the same configuration file** by
264
 
enclosing them in curly brackets::
265
 
 
266
 
    my_branch_name = feature_x
267
 
    my_server      = bzr+ssh://example.com
268
 
    push_location   = {my_server}/project/{my_branch_name}
269
 
 
270
261
 
271
262
Variable policies
272
263
^^^^^^^^^^^^^^^^^
386
377
check_signatures
387
378
~~~~~~~~~~~~~~~~
388
379
 
389
 
Reserved for future use.  These options will allow a policy for branches to
390
 
require signatures.
 
380
Defines the behavior for signatures.
391
381
 
392
382
require
393
383
    The gnupg signature for revisions must be present and must be valid.
403
393
create_signatures
404
394
~~~~~~~~~~~~~~~~~
405
395
 
406
 
Defines the behaviour of signing revisions on commits.  By default bzr will not
407
 
sign new commits.
 
396
Defines the behaviour of signing revisions.
408
397
 
409
398
always
410
 
    Sign every new revision that is committed.  If the signing fails then the
411
 
    commit will not be made.
 
399
    Sign every new revision that is committed.
412
400
 
413
401
when-required
414
 
    Reserved for future use.
 
402
    (default) Sign newly committed revisions only when the branch requires
 
403
    signed revisions.
415
404
 
416
405
never
417
 
    Reserved for future use.
418
 
 
419
 
In future it is planned that ``when-required`` will sign newly
420
 
committed revisions only when the branch requires them.  ``never`` will refuse
421
 
to sign newly committed revisions, even if the branch requires signatures.
 
406
    Refuse to sign newly committed revisions, even if the branch
 
407
    requires signatures.
422
408
 
423
409
recurse
424
410
~~~~~~~
467
453
These settings are only needed if the SMTP server requires authentication
468
454
to send mail.
469
455
 
470
 
locks.steal_dead
471
 
~~~~~~~~~~~~~~~~
472
 
 
473
 
If set to true, bzr will automatically break locks held by processes from
474
 
the same machine and user that are no longer alive.  Otherwise, it will
475
 
print a message and you can break the lock manually, if you are satisfied
476
 
the object is no longer in use.
477
 
 
478
456
mail_client
479
457
~~~~~~~~~~~
480
458
 
565
543
parent_location
566
544
~~~~~~~~~~~~~~~
567
545
 
568
 
If present, the location of the default branch for pull or merge.  This option
569
 
is normally set when creating a branch, the first ``pull`` or by ``pull
 
546
If present, the location of the default branch for pull or merge.
 
547
This option is normally set by ``pull --remember`` or ``merge
570
548
--remember``.
571
549
 
572
550
push_location
573
551
~~~~~~~~~~~~~
574
552
 
575
553
If present, the location of the default branch for push.  This option
576
 
is normally set by the first ``push`` or ``push --remember``.
 
554
is normally set by ``push --remember``.
577
555
 
578
556
push_strict
579
557
~~~~~~~~~~~
606
584
If present, defines the ``--strict`` option default value for checking
607
585
uncommitted changes before sending a merge directive.
608
586
 
609
 
 
610
 
External Merge Tools
611
 
--------------------
612
 
 
613
 
bzr.mergetool.<name>
614
 
~~~~~~~~~~~~~~~~~~~~
615
 
 
616
 
Defines an external merge tool called <name> with the given command-line.
617
 
Arguments containing spaces should be quoted using single or double quotes. The
618
 
executable may omit its path if it can be found on the PATH.
619
 
 
620
 
The following markers can be used in the command-line to substitute filenames
621
 
involved in the merge conflict::
622
 
 
623
 
  {base}      file.BASE
624
 
  {this}      file.THIS
625
 
  {other}     file.OTHER
626
 
  {result}    output file
627
 
  {this_temp} temp copy of file.THIS, used to overwrite output file if merge
628
 
              succeeds.
629
 
 
630
 
For example::
631
 
 
632
 
  bzr.mergetool.kdiff3 = kdiff3 {base} {this} {other} -o {result}
633
 
 
634
 
bzr.default_mergetool
635
 
~~~~~~~~~~~~~~~~~~~~~
636
 
 
637
 
Specifies which external merge tool (as defined above) should be selected by
638
 
default in tools such as ``bzr qconflicts``.
639
 
 
640
 
For example::
641
 
 
642
 
  bzr.default_mergetool = kdiff3