Commit e73c2434 authored by Chong Yidong's avatar Chong Yidong

Document Message mode as the default mail mode.

* sending.texi (Sending Mail): Document the fact that Message mode is
now the default mail mode.
(Mail Format, Mail Headers): Document mail-from-style changes.
(Mail Commands): Rename from Mail mode.  Document Message mode.
(Mail Misc): Rename from Mail mode Misc.
(Mail Sending, Header Editing, Mail Misc): Switch to Message mode
command names and update keybindings.
(Header Editing): Document message-tab.  De-document
mail-self-blind, mail-default-reply-to, and mail-archive-file-name in
favor of mail-default-headers.  Ad index entries for user-full-name and
user-mail-address.
(Citing Mail): Update changes in Message mode behavior.  Document
mail-yank-prefix.
(Mail Signature): New node, moved from Mail Misc.
(Mail Aliases): Mail abbrevs are the default with Message mode.
(Mail Methods): Note that Message mode is now the default.

* rmail.texi (Rmail Reply):
* text.texi (Text Mode):
* major.texi (Major Modes):
* mule.texi (Output Coding): Refer to Message mode.

* custom.texi (Init Examples): Add xref to Mail Header.

* emacs.texi (Top):  Fix xrefs.
parent 481134fd
2010-03-28 Chong Yidong <cyd@stupidchicken.com>
Document Message mode as the default mail mode.
* sending.texi (Sending Mail): Copyedits.
(Mail Format, Mail Headers): Document mail-from-style changes.
(Mail Commands): Rename from Mail mode. Document Message mode.
(Mail Misc): Rename from Mail mode Misc.
(Mail Sending, Header Editing, Mail Misc): Switch to Message mode
command names and update keybindings.
(Header Editing): Document message-tab. De-document
mail-self-blind, mail-default-reply-to, and mail-archive-file-name in
favor of mail-default-headers. Ad index entries for user-full-name and
user-mail-address.
(Citing Mail): Update changes in Message mode behavior. Document
mail-yank-prefix.
(Mail Signature): New node, moved from Mail Misc.
(Mail Aliases): Mail abbrevs are the default with Message mode.
(Mail Methods): Note that Message mode is now the default.
* rmail.texi (Rmail Reply):
* text.texi (Text Mode):
* major.texi (Major Modes):
* mule.texi (Output Coding): Refer to Message mode.
* custom.texi (Init Examples): Add xref to Mail Header.
* emacs.texi (Top): Fix xrefs.
2010-03-25 Chong Yidong <cyd@stupidchicken.com>
* maintaining.texi (VC With A Merging VCS): C-x v v now creates a
......
......@@ -2269,8 +2269,9 @@ Specify your own email address, if Emacs can't figure it out correctly.
(setq user-mail-address "cheney@@torture.gov")
@end example
Various Emacs packages that need your own email address use the value of
@code{user-mail-address}.
Various Emacs packages, such as Message mode, consult
@code{user-mail-address} when they need to know your email address.
@xref{Mail Headers}.
@item
Make Text mode the default mode for new buffers.
......
......@@ -886,16 +886,17 @@ Sending Mail
* Mail Format:: Format of the mail being composed.
* Mail Headers:: Details of some standard mail header fields.
* Mail Aliases:: Abbreviating and grouping mail addresses.
* Mail Mode:: Special commands for editing mail being composed.
* Mail Commands:: Special commands for editing mail being composed.
* Mail Signature:: Adding a signature to every message.
* Mail Amusements:: Distracting the NSA; adding fortune messages.
* Mail Methods:: Using alternative mail-composition methods.
Mail Mode
Mail Commands
* Mail Sending:: Commands to send the message.
* Header Editing:: Commands to move to header fields and edit them.
* Citing Mail:: Copying all or part of a message you are replying to.
* Mail Mode Misc:: Spell checking, signatures, etc.
* Citing Mail:: Quoting a message you are replying to.
* Mail Misc:: Attachments, spell checking, etc.
Reading Mail with Rmail
......
......@@ -41,7 +41,7 @@ languages. These include Lisp mode (which has several variants), C
mode, Fortran mode, and others. The remaining major modes are not
intended for use on users' files; they are used in buffers created for
specific purposes by Emacs, such as Dired mode for buffers made by
Dired (@pxref{Dired}), Mail mode for buffers made by @kbd{C-x m}
Dired (@pxref{Dired}), Message mode for buffers made by @kbd{C-x m}
(@pxref{Sending Mail}), and Shell mode for buffers used for
communicating with an inferior shell process (@pxref{Interactive
Shell}).
......
......@@ -961,15 +961,16 @@ still use an unsuitable coding system if you type its name in response
to the question.)
@vindex sendmail-coding-system
When you send a message with Mail mode (@pxref{Sending Mail}), Emacs has
four different ways to determine the coding system to use for encoding
the message text. It tries the buffer's own value of
@code{buffer-file-coding-system}, if that is non-@code{nil}. Otherwise,
it uses the value of @code{sendmail-coding-system}, if that is
non-@code{nil}. The third way is to use the default coding system for
new files, which is controlled by your choice of language environment,
if that is non-@code{nil}. If all of these three values are @code{nil},
Emacs encodes outgoing mail using the Latin-1 coding system.
When you send a message with Message mode (@pxref{Sending Mail}),
Emacs has four different ways to determine the coding system to use
for encoding the message text. It tries the buffer's own value of
@code{buffer-file-coding-system}, if that is non-@code{nil}.
Otherwise, it uses the value of @code{sendmail-coding-system}, if that
is non-@code{nil}. The third way is to use the default coding system
for new files, which is controlled by your choice of language
environment, if that is non-@code{nil}. If all of these three values
are @code{nil}, Emacs encodes outgoing mail using the Latin-1 coding
system.
@node Text Coding
@section Specifying a Coding System for File Text
......
......@@ -683,12 +683,12 @@ standard meaning.
@node Rmail Reply
@section Sending Replies
Rmail has several commands that use Mail mode to send outgoing mail.
@xref{Sending Mail}, for information on using Mail mode, including
certain features meant to work with Rmail. What this section documents
are the special commands of Rmail for entering Mail mode. Note that the
usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and @kbd{C-x 5
m}---also work normally in Rmail mode.
Rmail has several commands to send outgoing mail. @xref{Sending
Mail}, for information on using Message mode, including certain
features meant to work with Rmail. What this section documents are
the special commands of Rmail for entering the mail buffer. Note that
the usual keys for sending mail---@kbd{C-x m}, @kbd{C-x 4 m}, and
@kbd{C-x 5 m}---also work normally in Rmail mode.
@table @kbd
@item m
......@@ -735,12 +735,12 @@ the reply command with a numeric argument: @kbd{C-u r} or @kbd{1 r}.
This means to reply only to the sender of the original message.
Once the @samp{*mail*} buffer has been initialized, editing and
sending the mail goes as usual (@pxref{Sending Mail}). You can edit the
presupplied header fields if they are not what you want. You can also
use the commands of Mail mode (@pxref{Mail Mode}), including @kbd{C-c
C-y} which yanks in the message that you are replying to. You can
also switch to the Rmail buffer, select a different message there, switch
back, and yank the new current message.
sending the mail goes as usual (@pxref{Sending Mail}). You can edit
the presupplied header fields if they are not what you want. You can
also use commands such as @kbd{C-c C-y}, which yanks in the message
that you are replying to (@pxref{Mail Commands}). You can also switch
to the Rmail buffer, select a different message there, switch back,
and yank the new current message.
@kindex M-m @r{(Rmail)}
@findex rmail-retry-failure
......
......@@ -6,120 +6,104 @@
@chapter Sending Mail
@cindex sending mail
@cindex mail
@cindex email
@cindex message
To send a message in Emacs, you start by typing a command (@kbd{C-x m})
to select and initialize the @samp{*mail*} buffer. Then you edit the text
and headers of the message in this buffer, and type another command
(@kbd{C-c C-s} or @kbd{C-c C-c}) to send the message.
@kindex C-x m
@findex compose-mail
To send an @dfn{e-mail} message in Emacs, type @kbd{C-x m}. This
selects and initializes a buffer named @samp{*mail*}, where you can
edit the text and headers of the message. Finally, type @kbd{C-c C-s}
or @kbd{C-c C-c} to send the message.
@table @kbd
@item C-x m
Begin composing a message to send (@code{compose-mail}).
Begin composing mail (@code{compose-mail}).
@item C-x 4 m
Likewise, but display the message in another window
(@code{compose-mail-other-window}).
Likewise, in another window (@code{compose-mail-other-window}).
@item C-x 5 m
Likewise, but make a new frame (@code{compose-mail-other-frame}).
Likewise, but in a new frame (@code{compose-mail-other-frame}).
@item C-c C-s
In Mail mode, send the message (@code{mail-send}).
In the mail buffer, send the message (@code{message-send}).
@item C-c C-c
Send the message and bury the mail buffer (@code{mail-send-and-exit}).
In the mail buffer, send the message and bury the buffer
(@code{message-send-and-exit}).
@end table
@kindex C-x m
@findex compose-mail
@kindex C-x 4 m
@findex compose-mail-other-window
@kindex C-x 5 m
@findex compose-mail-other-frame
The command @kbd{C-x m} (@code{compose-mail}) selects a buffer named
@samp{*mail*} and initializes it with the skeleton of an outgoing
message. @kbd{C-x 4 m} (@code{compose-mail-other-window}) selects the
@samp{*mail*} buffer in a different window, leaving the previous current
buffer visible. @kbd{C-x 5 m} (@code{compose-mail-other-frame}) creates
a new frame to select the @samp{*mail*} buffer.
Because the mail-composition buffer is an ordinary Emacs buffer, you can
switch to other buffers while in the middle of composing mail, and switch
back later (or never). If you use the @kbd{C-x m} command again when you
have been composing another message but have not sent it, you are asked to
confirm before the old message is erased. If you answer @kbd{n}, the
@samp{*mail*} buffer remains selected with its old contents, so you can
finish the old message and send it. @kbd{C-u C-x m} is another way to do
this. Sending the message marks the @samp{*mail*} buffer ``unmodified,''
which avoids the need for confirmation when @kbd{C-x m} is next used.
If you are composing a message in the @samp{*mail*} buffer and want to
send another message before finishing the first, rename the
@samp{*mail*} buffer using @kbd{M-x rename-uniquely} (@pxref{Misc
Buffer}). Then you can use @kbd{C-x m} or its variants described above
to make a new @samp{*mail*} buffer. Once you've done that, you can work
with each mail buffer independently.
@vindex mail-default-directory
The variable @code{mail-default-directory} controls the default
directory for mail buffers, and also says where to put their auto-save
files.
@c Not mentioned: mail-bury-selects-summary. Really an Rmail feature.
@ignore
@c Commented out because it is not user-oriented;
@c it doesn't say how to do some job. -- rms.
@cindex directory servers
@cindex LDAP
@cindex PH/QI
@cindex names and addresses
There is an interface to directory servers using various protocols such
as LDAP or the CCSO white pages directory system (PH/QI), described in a
separate manual. It may be useful for looking up names and addresses.
@xref{Top,,EUDC, eudc, EUDC Manual}.
@end ignore
@noindent
The command @kbd{C-x 4 m} (@code{compose-mail-other-window}) does the
same as @kbd{C-x m}, except it displays the mail buffer in a different
window. The command @kbd{C-x 5 m} (@code{compose-mail-other-frame})
creates a new frame for the mail buffer.
Because the mail buffer is an ordinary Emacs buffer, you can switch
to other buffers while in the middle of composing mail, and switch
back later (or never). If you type @kbd{C-x m} again when you have
been composing another message but have not sent it, Emacs asks for
confirmation before erasing the old message. If you answer @kbd{n},
Emacs selects the mail buffer with its old contents, so you can finish
the old message and send it. @kbd{C-u C-x m} is another way to do
this. Sending the message marks the mail buffer ``unmodified,'' which
avoids the need for confirmation when @kbd{C-x m} is next used.
If you want to send another message before finishing the current
message, use the command @kbd{M-x rename-uniquely} to rename the
current mail buffer (@pxref{Misc Buffer}). Then you can use @kbd{C-x
m} to make a new mail buffer, and work with each mail buffer
independently.
@menu
* Format: Mail Format. Format of the mail being composed.
* Headers: Mail Headers. Details of some standard mail header fields.
* Aliases: Mail Aliases. Abbreviating and grouping mail addresses.
* Mode: Mail Mode. Special commands for editing mail being composed.
* Amuse: Mail Amusements. Distracting the NSA; adding fortune messages.
* Methods: Mail Methods. Using alternative mail-composition methods.
* Format: Mail Format. Format of a mail message.
* Headers: Mail Headers. Details of some standard mail header fields.
* Aliases: Mail Aliases. Abbreviating and grouping mail addresses.
* Commands: Mail Commands. Special commands for editing mail being composed.
* Signature: Mail Signature. Adding a signature to every message.
* Amuse: Mail Amusements. Distracting the NSA; adding fortune messages.
* Methods: Mail Methods. Using alternative mail-composition methods.
@end menu
@node Mail Format
@section The Format of the Mail Buffer
In addition to the @dfn{text} or @dfn{body}, a message has @dfn{header
fields} which say who sent it, when, to whom, why, and so on. Some
header fields, such as @samp{Date} and @samp{Message-Id}, are created
automatically when you send the message. Others, such as the recipient
names, must be specified by you in order to send the message properly.
An email message must contain certain pieces of information, called
@dfn{headers}, which specify the message's sender, recipient(s), and
so on.
In the mail buffer, you can insert and edit header fields using
ordinary editing commands. Mail mode provides commands to help you
edit some header fields, and some are automatically preinitialized in
the buffer, when appropriate.
At the top of the mail buffer is a set of @dfn{header fields}, where
you can enter this information. You can insert and edit header fields
using ordinary editing commands. @xref{Header Editing}, for commands
specific to editing header fields.
Some header fields are automatically pre-initialized in the buffer,
when appropriate; other headers, such as @samp{Date} and
@samp{Message-Id}, are normally omitted from the mail buffer and
created automatically when the message is sent.
@vindex mail-header-separator
The line in the buffer that says
@example
@smallexample
--text follows this line--
@end example
@end smallexample
@noindent
is a special delimiter that separates the headers you have specified from
the text. Whatever follows this line is the text of the message; the
headers precede it. The delimiter line itself does not appear in the
message actually sent. The text used for the delimiter line is controlled
by the variable @code{mail-header-separator}.
separates the header fields from the @dfn{body} (or @dfn{text}) of the
message. Everything above this line is treated as part of the
headers; everything below it is treated as the body. The delimiter
line itself does not appear in the message actually sent. The text
used for the delimiter line is controlled by the variable
@code{mail-header-separator}.
Here is an example of what the headers and text in the mail buffer
might look like.
@example
To: gnu@@gnu.org
CC: lungfish@@spam.org, byob@@spam.org
To: gnu@@example.org
CC: lungfish@@example.com, byob@@example.net
Subject: The Emacs Manual
--text follows this line--
Please ignore this message.
......@@ -134,85 +118,51 @@ beginning of a line, terminated by a colon. Upper and lower case are
equivalent in field names (and in mailing addresses also). After the
colon and optional whitespace comes the contents of the field.
You can use any name you like for a header field, but normally people
use only standard field names with accepted meanings. Here is a table
of fields commonly used in outgoing messages. Emacs preinitializes some
of these when you start to compose a mail, depending on various options
you can set. You can delete or alter any header field before you send
the message, if you wish.
You can use any name you like for a header field, but normally
people use only standard field names with accepted meanings. Here is
a table of commonly-used fields. Emacs pre-initializes some of these,
depending on various options you can set. You can delete or alter any
header field before you send the message, if you wish.
@table @samp
@item From
@vindex user-mail-address
The address of the sender (you). This should be a valid mailing
address, as replies will normally go there. Emacs initializes this
field using the variables @code{user-full-name} and
@code{user-mail-address}; see below.
@item To
This field contains the mailing addresses to which the message is
addressed. If you list more than one address, use commas, not spaces,
to separate them.
The mailing address(es) to which the message is addressed. To list
more than one address, use commas (not spaces) to separate them.
@item Subject
The contents of the @samp{Subject} field should be a piece of text
that says what the message is about. The reason @samp{Subject} fields
are useful is that most mail-reading programs can provide a summary of
messages, listing the subject of each message but not its text.
A piece of text saying what the message is about. Most mail-reading
programs can display a summary of messages, listing the subject of
each message but not its text.
@item CC
This field contains additional mailing addresses to send the message to,
like @samp{To} except that these readers should not regard the message
as directed at them.
Additional mailing address(es) to send the message to. This is like
@samp{To}, except that these readers should not regard the message as
directed at them.
@item BCC
This field contains additional mailing addresses to send the message to,
which should not appear in the header of the message actually sent.
Copies sent this way are called @dfn{blind carbon copies}.
@vindex mail-self-blind
@cindex copy of every outgoing message
To send a blind carbon copy of every outgoing message to yourself, set
the variable @code{mail-self-blind} to @code{t}. To send a blind carbon
copy of every message to some other @var{address}, set the variable
@code{mail-default-headers} to @code{"Bcc: @var{address}\n"}.
Additional mailing address(es) to send the message to, which should
not appear in the header of the message actually sent. ``BCC'' stands
for @dfn{blind carbon copies}.
@item FCC
This field contains the name of one file and directs Emacs to append a
copy of the message to that file when you send the message. Emacs
writes the message in mbox format, unless the file is in Babyl format
(used by Rmail before Emacs 23), in which case Emacs writes Babyl. If
an Rmail buffer is visiting the file, Emacs updates it accordingly.
To specify more than one file, use several @samp{FCC} fields, with one
file name in each field.
@vindex mail-archive-file-name
To put a fixed file name in the @samp{FCC} field each time you start
editing an outgoing message, set the variable
@code{mail-archive-file-name} to that file name. Unless you remove the
@samp{FCC} field before sending, the message will be written into that
file when it is sent.
@item From
Use the @samp{From} field to say who you are. You might need to change
this if the account you are using to send the mail is not your own. The
contents of the @samp{From} field should be a valid mailing address,
since replies will normally go there.
@vindex mail-setup-with-from
Emacs initializes this field (unless the variable
@code{mail-setup-with-from} is @code{nil}) using
@code{user-mail-address} as the default. If there is no @samp{From}
field when you send a mail, Emacs adds one.
The name of one file, to which a copy of the sent message should be
appended. Emacs writes the message in mbox format, unless the file is
in Babyl format (used by Rmail before Emacs 23), in which case Emacs
writes Babyl. If an Rmail buffer is visiting the file, Emacs updates
it accordingly. To specify more than one file, use several @samp{FCC}
fields, with one file name in each field.
@item Reply-to
Use this field to direct replies to a different address. Most
mail-reading programs (including Rmail) automatically send replies to
the @samp{Reply-to} address in preference to the @samp{From} address.
By adding a @samp{Reply-to} field to your header, you can work around
any problems your @samp{From} address may cause for replies.
@cindex @env{REPLYTO} environment variable
@vindex mail-default-reply-to
To put a fixed @samp{Reply-to} address into every outgoing message, set
the variable @code{mail-default-reply-to} to that address (as a string).
Then Emacs initializes the message with a @samp{Reply-to} field as
specified. When you first compose a mail, if
@code{mail-default-reply-to} is @code{nil}, Emacs initializes it from the
environment variable @env{REPLYTO}.
An address to which replies should be sent, instead of @samp{From}.
You can use this header if, for some reason, your @samp{From} address
is unable to receive replies.
@item Mail-reply-to
This field takes precedence over @samp{Reply-to}. It is used because
......@@ -225,70 +175,88 @@ you reply to a message from a mailing list that you are subscribed to.
It usually indicates that you want replies to go to the list, and that
you do not need an extra copy sent directly to you.
@vindex mail-mailing-lists
The variable @code{mail-mailing-lists} holds a list of mailing list
addresses that you are subscribed to. If it is non-@code{nil}, Emacs
inserts an appropriate @samp{Mail-followup-to} header when sending mail
to a mailing list.
@c There is also "Sent-via", added by C-c C-v, but it does not seem
@c particularly useful (?).
@c Message mode handles this differently...
@c @vindex mail-mailing-lists
@c The variable @code{mail-mailing-lists} holds a list of mailing list
@c addresses that you are subscribed to. If it is non-@code{nil}, Emacs
@c inserts an appropriate @samp{Mail-followup-to} header when sending mail
@c to a mailing list.
@item In-reply-to
This field contains a piece of text describing the message you are
replying to. Some mail systems can use this information to correlate
related pieces of mail. Normally this field is filled in by Rmail
when you reply to a message in Rmail, and you never need to
think about it (@pxref{Rmail}).
A piece of text describing the message you are replying to. Some mail
systems can use this information to correlate related pieces of mail.
Normally, you never need to think about this, because it is filled in
automatically when you reply to a message in Rmail (or any other mail
program built into Emacs).
@item References
This field lists the Message-Ids of related previous messages (a
Message-Id is a unique identifier generated when a message is sent).
Rmail sets up this field automatically when you reply to a message.
The Message-Ids of previous related messages (a Message-Id is a unique
identifier generated when a message is sent). Like
@samp{In-reply-to}, this is normally set up automatically for you.
@end table
The @samp{To}, @samp{CC}, and @samp{BCC} header fields can appear
any number of times, and each such header field can contain multiple
addresses, separated by commas. This way, you can specify any number
of places to send the message. These fields can also have
continuation lines: one or more lines starting with whitespace,
following the starting line of the field, are considered part of the
field. Here's an example of a @samp{To} field with a continuation
line:
@noindent
The @samp{To}, @samp{CC}, and @samp{BCC} fields can appear any number
of times, and each such header field can contain multiple addresses,
separated by commas. This way, you can specify any number of places
to send the message. These fields can also have continuation lines:
one or more lines starting with whitespace, following the starting
line of the field, are considered part of the field. Here's an
example of a @samp{To} field with a continuation line:
@example
@group
To: foo@@here.net, this@@there.net,
me@@gnu.cambridge.mass.usa.earth.spiral3281
To: foo@@example.net, this@@example.net,
bob@@example.com
@end group
@end example
@vindex user-full-name
@vindex user-mail-address
The default contents of the @samp{From} header field are computed
from the variables @code{user-full-name} and @code{user-mail-address}.
On some operating systems, Emacs initializes these two variables using
environment variables (@pxref{General Variables}). If this
information is unavailable or wrong, you can customize the variables
yourself (@pxref{Easy Customization}).
@vindex mail-from-style
When you send the message, if you didn't write a @samp{From} field
yourself, Emacs puts in one for you, using @code{user-mail-address}.
The variable @code{mail-from-style} controls the format:
@table @code
@item nil
Use just the email address, as in @samp{king@@grassland.com}.
@item parens
Use both email address and full name, as in:@*
The value of the variable @code{mail-from-style} specifies how to
format the address in the @samp{From} field:
@table @asis
@item @code{nil}
Use just the address, as in @samp{king@@grassland.com}.
@item @code{parens}
Use both address and full name, as in:@*
@samp{king@@grassland.com (Elvis Parsley)}.
@item angles
Use both email address and full name, as in:@*
@item @code{angles}
Use both address and full name, as in:@*
@samp{Elvis Parsley <king@@grassland.com>}.
@item system-default
Allow the system to insert the @samp{From} field.
@item any other value
Use @code{angles} for most addresses. However, if the address must be
``quoted'' to remain syntactically-valid under the @code{angles}
format but not under the @code{parens} format, use @code{parens}
instead. This is the default.
@end table
@c There is also mail-specify-envelope-from and mail-envelope-from, but
@c these are probably not topics for the Emacs manual.
@vindex mail-default-headers
You can direct Emacs to insert certain default headers into the
outgoing message by setting the variable @code{mail-default-headers}
to a string. Then @code{C-x m} inserts this string into the message
headers. If the default header fields are not appropriate for a
You can direct Emacs to insert certain default headers into the mail
buffer by setting the variable @code{mail-default-headers} to a
string. Then @kbd{C-x m} inserts this string into the message
headers. For example, here is how to add a @samp{Reply-to} and
@samp{FCC} header to each message:
@smallexample
(setq mail-default-headers
"Reply-to: foo@@example.com\nFCC: ~/Mail/sent")
@end smallexample
@noindent
If the default header fields are not appropriate for a
particular message, edit them as necessary before sending the message.
@node Mail Aliases
......@@ -296,29 +264,26 @@ particular message, edit them as necessary before sending the message.
@cindex mail aliases
@cindex @file{.mailrc} file
@cindex mailrc file
@vindex mail-personal-alias-file
You can define @dfn{mail aliases} in a file named @file{~/.mailrc}.
These are short mnemonic names which stand for mail addresses or groups of
mail addresses. Like many other mail programs, Emacs expands aliases
when they occur in the @samp{To}, @samp{From}, @samp{CC}, @samp{BCC}, and
@samp{Reply-to} fields, plus their @samp{Resent-} variants.
@c The list is defined by mail-address-field-regexp.
You can define @dfn{mail aliases}, which are short mnemonic names
that stand for mail addresses or groups of mail addresses. By
default, mail aliases are defined in the file @file{~/.mailrc}. You
can specify a different file name to use, by setting the variable
@code{mail-personal-alias-file}.
To define an alias in @file{~/.mailrc}, write a line in the following
To define an alias in @file{.mailrc}, write a line in the following
format:
@example
alias @var{shortaddress} @var{fulladdresses}
alias @var{nick} @var{fulladdresses}
@end example
@noindent
Here @var{fulladdresses} stands for one or more mail addresses for
@var{shortaddress} to expand into. Separate multiple addresses with
spaces; if an address contains a space, quote the whole address with a
pair of double quotes.
For instance, to make @code{maingnu} stand for
@code{gnu@@gnu.org} plus a local address of your own, put in
This means that @var{nick} should expand into @var{fulladdresses},
where @var{fulladdresses} can be either a single address, or multiple
addresses separated with spaces. For instance, to make @code{maingnu}
stand for @code{gnu@@gnu.org} plus a local address of your own, put in
this line:@refill
@example
......@@ -326,329 +291,232 @@ alias maingnu gnu@@gnu.org local-gnu
@end example
@noindent
Addresses specified in this way should use double quotes around an
entire address when the address contains spaces. But you need not
include double quotes around parts of the address, such as the person's
full name. Emacs puts them in if they are needed. For example,
If an address contains a space, quote the whole address with a pair of
double quotes, like this:
@example
alias jsmith "John Q. Smith <none@@example.com>"
@end example
@noindent
is correct in @samp{.mailrc}. Emacs will insert the address as
Note that you need not include double quotes around individual parts
of the address, such as the person's full name. Emacs puts them in if
they are needed. For instance, it inserts the above address as
@samp{"John Q. Smith" <none@@example.com>}.
Emacs also recognizes ``include'' commands in @samp{.mailrc} files.
They look like this:
Emacs also recognizes ``include'' commands in @file{.mailrc}. They
look like this:
@example
source @var{filename}
@end example
@noindent
The file @file{~/.mailrc} is used primarily by other mail-reading