19
19
Using a network proxy
20
20
---------------------
22
If your network requires that you use an http proxy for outbound
22
If your network requires that you use an HTTP proxy for outbound
23
23
connections, you must set the ``http_proxy`` variable. If the proxy is
24
24
also required for https connections, you need to set ``https_proxy`` too.
25
25
If you need these and don't have them set, you may find that connections
66
66
email = Your Name <email@example.com>
68
68
For further details on the syntax and configuration settings supported, see
69
`Configuration Settings <../user-reference/bzr_man.html#configuration-settings>`_
69
`Configuration Settings <../user-reference/index.html#configuration-settings>`_
70
70
in the Bazaar User Reference.
73
Looking at the active configuration
74
-----------------------------------
76
To look at all the currently defined options, you can use the following
81
``bzr`` implements some rules to decide where to get the value of a
84
The current policy is to examine the existing configurations files in a
85
given order for matching definitions.
87
* ``locations.conf`` is searched first for a section whose name matches the
88
location considered (working tree, branch or remote branch),
90
* the current ``branch.conf`` is searched next,
92
* ``bazaar.conf`` is searched next,
94
* finally, some options can have default values generally defined in the
95
code itself and not displayed by ``bzr config`` (see `Configuration
96
Settings <../user-reference/index.html#configuration-settings>`_).
98
This is better understood by using ```bzr config`` with no arguments, which
99
will display some output of the form::
102
post_commit_to = commits@example.com
103
news_merge_files = NEWS
105
parent_location = bzr+ssh://bazaar.launchpad.net/+branch/bzr/
106
nickname = config-modify
107
push_location = bzr+ssh://bazaar.launchpad.net/~vila/bzr/config-modify/
111
Each configuration file is associated with a given scope whose name is
112
displayed before each set of defined options.
114
Modifying the active configuration
115
----------------------------------
117
To set an option to a given value use::
121
To remove an option use::
123
bzr config --remove opt
73
126
Rule-based preferences
74
127
----------------------
78
131
``BZR_HOME/rules``.
80
133
For further information on how rules are searched and the detailed syntax of
81
the relevant files, see `Rules <../user-reference/bzr_man.html#rules>`_
134
the relevant files, see `Rules <../user-reference/index.html#rules>`_
82
135
in the Bazaar User Reference.