← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

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

  • Committer: Ian Clatworthy
  • Date: 2007-12-13 03:07:45 UTC
  • mto: (3105.1.1 ianc-integration)
  • mto: This revision was merged to the branch mainline in revision 3106.
  • Revision ID: ian.clatworthy@internode.on.net-20071213030745-qhw4i0g5nbspx0ws
fix some broken links and make doc more Windows user friendly

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/user-guide/setting_up_email.txt
30
30
 
31
31
The order of precedence is
32
32
 
33
 
 1. If the ``$BZR_EMAIL`` environment variable is set.
 
33
 1. If the ``BZR_EMAIL`` environment variable is set.
34
34
 #. If an email is set for your current branch in the ``locations.conf``
35
35
    file.
36
36
 #. If an email is set four your current branch in the
37
37
    ``.bzr/branch/branch.conf`` file.
38
38
 #. If an email is set in the ``bazaar.conf`` default configuration file.
39
 
 #. If the `$EMAIL` environment variable is set.
 
39
 #. If the `EMAIL` environment variable is set.
40
40
 #. Bazaar will try to guess based on your username and the hostname.
41
41
 
42
42
To check on what Bazaar thinks your current email is, use the ``whoami``
61
61
Setting email via default configuration file
62
62
--------------------------------------------
63
63
 
64
 
To use the default ini file, create the file ``$HOME/.bazaar/bazaar.conf`` (on
65
 
Windows this is ``%APPDATA%\bazaar\2.0\bazaar.conf``) and set an email address
66
 
as shown below.  Please note that the word DEFAULT is case sensitive, and
67
 
must be in upper-case.
 
64
To use the default ini file, create or edit the ``bazaar.conf`` file (in
 
65
``~/.bazaar/`` on Linix and in ``%APPDATA%\bazaar\2.0\`` in Windows)
 
66
and set an email address as shown below.  Please note that the word DEFAULT
 
67
is case sensitive, and must be in upper-case.
68
68
::
69
69
 
70
70
    [DEFAULT]
71
71
    email=Your Name <name@isp.com>
72
72
 
73
73
 
74
 
For more information on the ini file format, see ConfiguringBzr.
 
74
For more information on the ini file format, see `Configuration reference`_.
75
75
 
76
76
Setting email on a per-branch basis
77
77
-----------------------------------
78
78
 
79
79
The second approach is to set email on a branch by branch basis by
80
 
using the ``$HOME/.bazaar/locations.conf`` configuration file,
81
 
thusly::
 
80
using the ``locations.conf`` configuration file like this::
82
81
 
83
82
    [/some/branch/location]
84
83
    email=Your Name <name@other-isp.com>
88
87
 
89
88
Setting email via environment variable
90
89
--------------------------------------
91
 
The final method Bazaar will use is checking for the ``$BZR_EMAIL``
92
 
and ``$EMAIL`` environment variables.  Generally, you would use this
 
90
The final method Bazaar will use is checking for the ``BZR_EMAIL``
 
91
and ``EMAIL`` environment variables.  Generally, you would use this
93
92
method to override the email in a script context.  If you would like
94
93
to set a general default, then please see the ini methods above.
95
94