← 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: Alexander Belchenko
  • Date: 2006-07-30 06:52:39 UTC
  • mto: (1711.2.111 jam-integration)
  • mto: This revision was merged to the branch mainline in revision 1906.
  • Revision ID: bialix@ukr.net-20060730065239-03b4ac02d9f56202
branding: change Bazaar-NG to Bazaar

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setting_up_email.txt
2
2
Setting up email
3
3
================
4
4
 
5
 
The various ways that exist to tell Bazaar-NG your email address for
 
5
The various ways that exist to tell Bazaar your email address for
6
6
commits.
7
7
 
8
 
Why set up an email address with Bazaar-NG?
9
 
===========================================
10
 
Bazaar-NG stores the claimed email address in revisions when they're
 
8
Why set up an email address with Bazaar?
 
9
========================================
 
10
Bazaar stores the claimed email address in revisions when they're
11
11
created, so that people can tell who commited which revisions.  Of course,
12
12
people can change the email address claimed, so you have to trust the
13
13
people involved.  Additionally, the email address in a revision gives
16
16
 
17
17
How to setup your email address 
18
18
===============================
19
 
Bazaar-NG will try to guess an email address based on your username and the
 
19
Bazaar will try to guess an email address based on your username and the
20
20
hostname if none is set.  This will probably not be what you want, so three
21
 
ways exist to tell Bazaar-NG what email to use
 
21
ways exist to tell Bazaar what email to use
22
22
 
23
23
 * You can set your email in the default ini file,
24
24
 * You can set emails per-branch in the branch specific ini file,
31
31
    file.
32
32
 3. If an email is set in the `bazaar.conf` default ini file.
33
33
 4. If the `$EMAIL` env variable is set.
34
 
 5. Bazaar-NG will try to guess based on your username and the hostname.
 
34
 5. Bazaar will try to guess based on your username and the hostname.
35
35
 
36
 
To check on what Bazaar-NG thinks your current email is, use the '''whoami'''
 
36
To check on what Bazaar thinks your current email is, use the '''whoami'''
37
37
("who am i?") command::
38
38
 
39
39
    % bzr whoami
78
78
 
79
79
Setting email via environment
80
80
-----------------------------
81
 
The final method Bazaar-NG will use is checking for the `$BZREMAIL` and
 
81
The final method Bazaar will use is checking for the `$BZREMAIL` and
82
82
`$EMAIL` environment variables.  Generally, one would use this method to
83
83
override the email in a script context.  If you would like to set a general
84
84
default, then please see the ini methods above.
87
87
Concerns for spam
88
88
=================
89
89
Some people want to avoid sharing their email address so as not to get
90
 
spam.  Bazaar-NG will never disclose your email address, unless you publish
 
90
spam.  Bazaar will never disclose your email address, unless you publish
91
91
a branch or changeset in a public location.  It's recommended that you
92
92
''do'' use a real address, so that people can contact you about your work,
93
93
but it's not required.  You can use an address which is obfuscated, which