← 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: Canonical.com Patch Queue Manager
  • Date: 2011-08-09 17:04:46 UTC
  • mfrom: (6055.1.3 822571-bzr-home-unicode)
  • Revision ID: pqm@pqm.ubuntu.com-20110809170446-f1wc1a8fhgnxi4cn
(vila) Decode BZR_HOME with fs encoding to allow unicode homes. (Vincent
 Ladeuil)

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", "dots", "tty"
 
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.
23
25
 
24
26
BZR_SIGQUIT_PDB
25
27
~~~~~~~~~~~~~~~
256
258
variable name, an equals sign and a value.  For example::
257
259
 
258
260
    email            = John Doe <jdoe@isp.com>
259
 
    check_signatures = require
 
261
    gpg_signing_key  = Amy Pond <amy@example.com>
260
262
 
261
263
A variable can reference other variables **in the same configuration file** by
262
264
enclosing them in curly brackets::
309
311
    [DEFAULT]
310
312
    email             = John Doe <jdoe@isp.com>
311
313
    editor            = /usr/bin/vim
312
 
    check_signatures  = check-available
313
314
    create_signatures = when-required
314
315
 
315
316
 
327
328
 
328
329
    [http://hypothetical.site.com/branches/devel-branch]
329
330
    create_signatures = always
330
 
    check_signatures  = always
331
 
 
332
 
    [http://example.com/bzr/*]
333
 
    check_signatures  = require
334
331
 
335
332
The authentication configuration file, authentication.conf
336
333
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
384
381
check_signatures
385
382
~~~~~~~~~~~~~~~~
386
383
 
387
 
Defines the behavior for signatures.
 
384
Reserved for future use.  These options will allow a policy for branches to
 
385
require signatures.
388
386
 
389
387
require
390
388
    The gnupg signature for revisions must be present and must be valid.
400
398
create_signatures
401
399
~~~~~~~~~~~~~~~~~
402
400
 
403
 
Defines the behaviour of signing revisions.
 
401
Defines the behaviour of signing revisions on commits.  By default bzr will not
 
402
sign new commits.
404
403
 
405
404
always
406
 
    Sign every new revision that is committed.
 
405
    Sign every new revision that is committed.  If the signing fails then the
 
406
    commit will not be made.
407
407
 
408
408
when-required
409
 
    (default) Sign newly committed revisions only when the branch requires
410
 
    signed revisions.
 
409
    Reserved for future use.
411
410
 
412
411
never
413
 
    Refuse to sign newly committed revisions, even if the branch
414
 
    requires signatures.
 
412
    Reserved for future use.
 
413
 
 
414
In future it is planned that ``when-required`` will sign newly
 
415
committed revisions only when the branch requires them.  ``never`` will refuse
 
416
to sign newly committed revisions, even if the branch requires signatures.
 
417
 
 
418
dirstate.fdatasync
 
419
~~~~~~~~~~~~~~~~~~
 
420
 
 
421
If true (default), working tree metadata changes are flushed through the
 
422
OS buffers to physical disk.  This is somewhat slower, but means data
 
423
should not be lost if the machine crashes.  See also repository.fdatasync.
 
424
 
 
425
gpg_signing_key
 
426
~~~~~~~~~~~
 
427
 
 
428
The GnuPG user identity to use when signing commits.  Can be an e-mail
 
429
address, key fingerprint or full key ID.  When unset or when set to
 
430
"default" Bazaar will use the user e-mail set with ``whoami``.
415
431
 
416
432
recurse
417
433
~~~~~~~
434
450
 
435
451
    gpg_signing_command = /usr/bin/gnpg
436
452
 
 
453
The specified command must accept the options "--clearsign" and "-u <email>".
 
454
 
437
455
bzr_remote_path
438
456
~~~~~~~~~~~~~~~
439
457
 
460
478
These settings are only needed if the SMTP server requires authentication
461
479
to send mail.
462
480
 
 
481
locks.steal_dead
 
482
~~~~~~~~~~~~~~~~
 
483
 
 
484
If set to true, bzr will automatically break locks held by processes from
 
485
the same machine and user that are no longer alive.  Otherwise, it will
 
486
print a message and you can break the lock manually, if you are satisfied
 
487
the object is no longer in use.
 
488
 
463
489
mail_client
464
490
~~~~~~~~~~~
465
491
 
486
512
:mapi: Use your preferred e-mail client on Windows.
487
513
:xdg-email: Use xdg-email to run your preferred mail program
488
514
 
 
515
repository.fdatasync
 
516
~~~~~~~~~~~~~~~~~~~~
 
517
 
 
518
If true (default), repository changes are flushed through the OS buffers
 
519
to physical disk.  This is somewhat slower, but means data should not be
 
520
lost if the machine crashes.  See also dirstate.fdatasync.
 
521
 
489
522
submit_branch
490
523
~~~~~~~~~~~~~
491
524