← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/setting_up_email.txt

  • Committer: Robert Collins
  • Date: 2006-08-08 23:19:29 UTC
  • mfrom: (1884 +trunk)
  • mto: This revision was merged to the branch mainline in revision 1912.
  • Revision ID: robertc@robertcollins.net-20060808231929-4e3e298190214b3a
current status

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setting_up_email.txt
20
20
The order of precedence is
21
21
 
22
22
 1. If the `$BZREMAIL` env variable is set, use it.
23
 
 2. If an email is set for your current branch in the `branches.conf` ini file.
 
23
 2. If an email is set for your current branch in the `locations.conf` ini
 
24
    file.
24
25
 3. If an email is set in the `bazaar.conf` default ini file.
25
26
 4. If the `$EMAIL` env variable is set.
26
27
 5. Bazaar-NG will try to guess based on your username and the hostname.
30
31
 
31
32
    % bzr whoami
32
33
    Joe Cool <joe@example.com>
 
34
    
 
35
Setting email via the 'whoami' command
 
36
======================================
 
37
You can use the whoami command to set your email globally::
 
38
 
 
39
    % bzr whoami 'Joe Cool <joe@example.com>'
 
40
 
 
41
or only for the current branch::
 
42
 
 
43
    % bzr whoami --branch 'Joe Cool <joe@example.com>'
 
44
 
 
45
These modify your global bazaar.conf or branch branch.conf file, respectively.
33
46
 
34
47
Setting email via default ini file
35
48
==================================
36
 
The first method is using the default ini file.  To use the default ini
37
 
method, create the file `$HOME/.bazaar/bazaar.conf` (on Windows this is
38
 
`%APPDATA%\bazaar\2.0\bazaar.conf`) and set an email address as shown
39
 
below.  Please note that the word DEFAULT is case sensitive, and must be in
40
 
upper-case.::
 
49
To use the default ini file, create the file `$HOME/.bazaar/bazaar.conf` (on
 
50
Windows this is `%APPDATA%\bazaar\2.0\bazaar.conf`) and set an email address
 
51
as shown below.  Please note that the word DEFAULT is case sensitive, and
 
52
must be in upper-case.::
41
53
 
42
54
    [DEFAULT]
43
55
    email=Your Name <name@isp.com>
49
61
===================================
50
62
 
51
63
The second approach is to set email on a branch by branch basis by using the
52
 
`$HOME/.bazaar/branches.conf` ini file, thusly::
 
64
`$HOME/.bazaar/locations.conf` ini file, thusly::
53
65
 
54
66
    [/some/branch/location]
55
67
    email=Your Name <name@other-isp.com>