Rev 5459: Add some user-guide documentation for bzr config. in file:///home/vila/src/bzr/experimental/test-script/
Vincent Ladeuil
v.ladeuil+lp at free.fr
Wed Oct 13 14:53:31 BST 2010
At file:///home/vila/src/bzr/experimental/test-script/
------------------------------------------------------------
revno: 5459
revision-id: v.ladeuil+lp at free.fr-20101013135330-9hknrtjw2bc3wdg9
parent: v.ladeuil+lp at free.fr-20101013075513-hil6q8xi7i9e3ozq
committer: Vincent Ladeuil <v.ladeuil+lp at free.fr>
branch nick: test-script
timestamp: Wed 2010-10-13 15:53:30 +0200
message:
Add some user-guide documentation for bzr config.
-------------- next part --------------
=== modified file 'doc/en/user-guide/configuring_bazaar.txt'
--- a/doc/en/user-guide/configuring_bazaar.txt 2010-10-08 10:50:51 +0000
+++ b/doc/en/user-guide/configuring_bazaar.txt 2010-10-13 13:53:30 +0000
@@ -70,6 +70,59 @@
in the Bazaar User Reference.
+Looking at the active configuration
+-----------------------------------
+
+To look at all the currently defined options, you can use the following
+command::
+
+ bzr config
+
+``bzr`` implements some rules to decide where to get the value of a
+configuration option.
+
+The current policy is to examine the existing configurations files in a
+given order for matching definitions.
+
+ * ``locations.conf`` is searched first for a section whose name matches the
+ location considered (working tree, branch or remote branch),
+
+ * the current ``branch.conf`` is searched next,
+
+ * ``bazaar.conf`` is searched next,
+
+ * finally, some options can have default values generally defined in the
+ code itself and not displayed by ``bzr config`` (see `Configuration
+ Settings <../user-reference/index.html#configuration-settings>`_).
+
+This is better understood by using ```bzr config`` with no arguments, which
+will display some output of the form::
+
+ locations:
+ post_commit_to = commits at example.com
+ news_merge_files = NEWS
+ branch:
+ parent_location = bzr+ssh://bazaar.launchpad.net/+branch/bzr/
+ nickname = config-modify
+ push_location = bzr+ssh://bazaar.launchpad.net/~vila/bzr/config-modify/
+ bazaar:
+ debug_flags = hpss,
+
+Each configuration file is associated with a given scope whose name is
+displayed before each set of defined options.
+
+Modifying the active configuration
+----------------------------------
+
+To set an option to a given value use::
+
+ bzr config opt=value
+
+To remove an option use::
+
+ bzr config --remove opt
+
+
Rule-based preferences
----------------------
More information about the bazaar-commits
mailing list