← 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: Martin Pool
  • Date: 2010-09-14 09:47:23 UTC
  • mto: (5452.4.1 jam-integration)
  • mto: This revision was merged to the branch mainline in revision 5476.
  • Revision ID: mbp@sourcefrog.net-20100914094723-2dn6e9q5ktpa1m8r
Update existing script tests to not ignore their output

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
^^^^^^^^^^^^^^^^^
331
322
    create_signatures = always
332
323
    check_signatures  = always
333
324
 
334
 
    [http://example.com/bzr/*]
 
325
    [http://bazaar-vcs.org/bzr/*]
335
326
    check_signatures  = require
336
327
 
337
328
The authentication configuration file, authentication.conf
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
 
526
504
    whether the format deprecation warning is shown on repositories that are
527
505
    using deprecated formats.
528
506
 
529
 
default_format
530
 
~~~~~~~~~~~~~~
531
 
 
532
 
A format name for the default format used when creating branches.  See ``bzr
533
 
help formats`` for possible values.
534
 
 
535
507
 
536
508
Unicode options
537
509
---------------
565
537
parent_location
566
538
~~~~~~~~~~~~~~~
567
539
 
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
 
540
If present, the location of the default branch for pull or merge.
 
541
This option is normally set by ``pull --remember`` or ``merge
570
542
--remember``.
571
543
 
572
544
push_location
573
545
~~~~~~~~~~~~~
574
546
 
575
547
If present, the location of the default branch for push.  This option
576
 
is normally set by the first ``push`` or ``push --remember``.
 
548
is normally set by ``push --remember``.
577
549
 
578
550
push_strict
579
551
~~~~~~~~~~~
606
578
If present, defines the ``--strict`` option default value for checking
607
579
uncommitted changes before sending a merge directive.
608
580
 
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