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