/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/en/user-guide/configuring_bazaar.txt

  • Committer: v.ladeuil+lp at free
  • Date: 2006-12-01 15:06:29 UTC
  • mto: (2172.3.1 bzr.73948)
  • mto: This revision was merged to the branch mainline in revision 2181.
  • Revision ID: v.ladeuil+lp@free.fr-20061201150629-zjd2an87u0r7nhhw
The tests that would have help avoid bug #73948 and all that mess :)

* bzrlib/transport/http/response.py:
(handle_response): Translate a 416 http error code into a bzr
exception.

* bzrlib/transport/http/_urllib2_wrappers.py:
(HTTPDefaultErrorHandler.http_error_default): Translate a 416 http
error code into a bzr exception.

* bzrlib/transport/http/_pycurl.py:
(PyCurlTransport._curl_perform): It could happen that pycrul
itself detect a short read.

* bzrlib/transport/http/__init__.py:
(HttpTransportBase._retry_get): New method, factorizing the retry
logic.
(HttpTransportBase.readv): We can have exception during the
initial GET worth degrading the range requirements (i.e. retrying
the GET request with either single or not ranges).

* bzrlib/tests/test_transport_implementations.py:
(TransportTests.test_readv_short_read): InvalidRange can also be
raised.

* bzrlib/tests/test_http.py:
(TestRangeRequestServer.test_readv_invalid_ranges): Was named
test_readv_short_read, the new name make the intent
clearer. Depending of the code path used (urllib or pycurl), both
exceptions can be raised.

* bzrlib/tests/HttpServer.py:
(TestingHTTPRequestHandler.do_GET): If invalid ranges are
specified, returns a 416 instead of the whole file (both are valid
according to the RFC).

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/configuring_bazaar.txt
1
 
Configuring Bazaar
2
 
==================
3
 
 
4
 
Telling Bazaar about yourself
5
 
-----------------------------
6
 
 
7
 
One function of a version control system is to keep track of who changed
8
 
what.  In a decentralized system, that requires an identifier for each
9
 
author that is globally unique.  Most people already have one of these: an
10
 
email address. Bazaar is smart enough to automatically generate an email
11
 
address by looking up your username and hostname. If you don't like the
12
 
guess that Bazaar makes, then use the ``whoami`` command to set the
13
 
identifier you want::
14
 
 
15
 
    % bzr whoami "Your Name <email@example.com>"
16
 
 
17
 
If ``whoami`` is used without an argument, the current value is displayed.
18
 
 
19
 
Configuration files
20
 
-------------------
21
 
 
22
 
Configuration files are located in ``$HOME/.bazaar`` on Linux/Unix and
23
 
``C:\Documents and Settings\<username>\Application Data\Bazaar\2.0`` on
24
 
Windows. There are three primary configuration files in this location:
25
 
 
26
 
* ``bazaar.conf`` describes default configuration options,
27
 
 
28
 
* ``locations.conf`` describes configuration information for
29
 
  specific branch locations,
30
 
 
31
 
* ``authentication.conf`` describes credential information for
32
 
  remote servers.
33
 
 
34
 
Each branch can also contain a configuration file that sets values specific
35
 
to that branch. This file is found at ``.bzr/branch/branch.conf`` within the
36
 
branch. This file is visible to **all users of a branch**. If you wish to
37
 
override one of the values for a branch with a setting that is specific to you,
38
 
then you can do so in ``locations.conf``.
39
 
 
40
 
Here is sample content of ``bazaar.conf`` after setting an email address using
41
 
the ``whoami`` command::
42
 
 
43
 
  [DEFAULT]
44
 
  email = Your Name <email@example.com>
45
 
 
46
 
For further details on the syntax and configuration settings supported, see
47
 
`Configuration Settings <../user-reference/bzr_man.html#configuration-settings>`_
48
 
in the Bazaar User Reference.
49
 
 
50
 
 
51
 
Rule-based preferences
52
 
----------------------
53
 
 
54
 
Some commands and plugins provide custom processing on files matching
55
 
certain patterns. Per-user rule-based preferences are defined in
56
 
``BZR_HOME/rules``.
57
 
 
58
 
For further information on how rules are searched and the detailed syntax of
59
 
the relevant files, see `Rules <../user-reference/bzr_man.html#rules>`_
60
 
in the Bazaar User Reference.