[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99689: Document Message mode as t
|
From: |
Chong Yidong |
|
Subject: |
[Emacs-diffs] /srv/bzr/emacs/emacs-23 r99689: Document Message mode as the default mail mode. |
|
Date: |
Sat, 27 Mar 2010 23:41:34 -0400 |
|
User-agent: |
Bazaar (2.0.3) |
------------------------------------------------------------
revno: 99689
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Sat 2010-03-27 23:41:34 -0400
message:
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.
modified:
doc/emacs/ChangeLog
doc/emacs/custom.texi
doc/emacs/emacs.texi
doc/emacs/major.texi
doc/emacs/mule.texi
doc/emacs/rmail.texi
doc/emacs/sending.texi
doc/emacs/text.texi
etc/NEWS
=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog 2010-03-26 00:04:48 +0000
+++ b/doc/emacs/ChangeLog 2010-03-28 03:41:34 +0000
@@ -1,3 +1,32 @@
+2010-03-28 Chong Yidong <address@hidden>
+
+ 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 <address@hidden>
* maintaining.texi (VC With A Merging VCS): C-x v v now creates a
=== modified file 'doc/emacs/custom.texi'
--- a/doc/emacs/custom.texi 2010-03-06 19:02:49 +0000
+++ b/doc/emacs/custom.texi 2010-03-28 03:41:34 +0000
@@ -2269,8 +2269,9 @@
(setq user-mail-address "cheney@@torture.gov")
@end example
-Various Emacs packages that need your own email address use the value of
address@hidden
+Various Emacs packages, such as Message mode, consult
address@hidden when they need to know your email address.
address@hidden Headers}.
@item
Make Text mode the default mode for new buffers.
=== modified file 'doc/emacs/emacs.texi'
--- a/doc/emacs/emacs.texi 2010-03-25 22:57:13 +0000
+++ b/doc/emacs/emacs.texi 2010-03-28 03:41:34 +0000
@@ -886,16 +886,17 @@
* 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
=== modified file 'doc/emacs/major.texi'
--- a/doc/emacs/major.texi 2010-03-06 19:02:49 +0000
+++ b/doc/emacs/major.texi 2010-03-28 03:41:34 +0000
@@ -41,7 +41,7 @@
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}).
=== modified file 'doc/emacs/mule.texi'
--- a/doc/emacs/mule.texi 2010-03-20 17:24:06 +0000
+++ b/doc/emacs/mule.texi 2010-03-28 03:41:34 +0000
@@ -961,15 +961,16 @@
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
address@hidden, if that is address@hidden Otherwise,
-it uses the value of @code{sendmail-coding-system}, if that is
address@hidden 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 address@hidden 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
address@hidden, if that is address@hidden
+Otherwise, it uses the value of @code{sendmail-coding-system}, if that
+is address@hidden 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 address@hidden 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
=== modified file 'doc/emacs/rmail.texi'
--- a/doc/emacs/rmail.texi 2010-01-13 08:35:10 +0000
+++ b/doc/emacs/rmail.texi 2010-03-28 03:41:34 +0000
@@ -683,12 +683,12 @@
@node Rmail Reply
@section Sending Replies
- Rmail has several commands that use Mail mode to send outgoing mail.
address@hidden 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 address@hidden 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 address@hidden m}, @kbd{C-x 4 m}, and
address@hidden 5 m}---also work normally in Rmail mode.
@table @kbd
@item m
@@ -735,12 +735,12 @@
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
=== modified file 'doc/emacs/sending.texi'
--- a/doc/emacs/sending.texi 2010-01-13 08:35:10 +0000
+++ b/doc/emacs/sending.texi 2010-03-28 03:41:34 +0000
@@ -6,120 +6,104 @@
@chapter Sending Mail
@cindex sending mail
@cindex mail
address@hidden 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.
address@hidden C-x m
address@hidden 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
address@hidden C-x m
address@hidden 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
address@hidden and initializes it with the skeleton of an outgoing
-message. @kbd{C-x 4 m} (@code{compose-mail-other-window}) selects the
address@hidden 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
address@hidden 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
address@hidden 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.
-
address@hidden 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.
-
address@hidden Not mentioned: mail-bury-selects-summary. Really an Rmail
feature.
-
address@hidden
address@hidden Commented out because it is not user-oriented;
address@hidden it doesn't say how to do some job. -- rms.
address@hidden directory servers
address@hidden LDAP
address@hidden PH/QI
address@hidden 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.
address@hidden,,EUDC, eudc, EUDC Manual}.
address@hidden ignore
address@hidden
+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.
-
- 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.
+ An email message must contain certain pieces of information, called
address@hidden, which specify the message's sender, recipient(s), and
+so on.
+
+ 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
address@hidden, 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
address@hidden
address@hidden
--text follows this line--
address@hidden example
address@hidden 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
address@hidden
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 @@
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
address@hidden From
address@hidden 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
address@hidden; 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
address@hidden, 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}.
-
address@hidden mail-self-blind
address@hidden 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
address@hidden 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.
-
address@hidden 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
address@hidden to that file name. Unless you remove the
address@hidden field before sending, the message will be written into that
-file when it is sent.
-
address@hidden 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.
-
address@hidden mail-setup-with-from
-Emacs initializes this field (unless the variable
address@hidden is @code{nil}) using
address@hidden 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.
-
address@hidden @env{REPLYTO} environment variable
address@hidden 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
address@hidden 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 @@
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.
address@hidden mail-mailing-lists
- The variable @code{mail-mailing-lists} holds a list of mailing list
-addresses that you are subscribed to. If it is address@hidden, Emacs
-inserts an appropriate @samp{Mail-followup-to} header when sending mail
-to a mailing list.
-
address@hidden There is also "Sent-via", added by C-c C-v, but it does not seem
address@hidden particularly useful (?).
address@hidden Message mode handles this differently...
address@hidden @vindex mail-mailing-lists
address@hidden The variable @code{mail-mailing-lists} holds a list of mailing
list
address@hidden addresses that you are subscribed to. If it is address@hidden,
Emacs
address@hidden inserts an appropriate @samp{Mail-followup-to} header when
sending mail
address@hidden 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
address@hidden, 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:
address@hidden
+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
address@hidden user-full-name
address@hidden 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:
+ The value of the variable @code{mail-from-style} specifies how to
+format the address in the @samp{From} field:
address@hidden @code
address@hidden nil
-Use just the email address, as in @samp{king@@grassland.com}.
address@hidden parens
-Use both email address and full name, as in:@*
address@hidden @asis
address@hidden @code{nil}
+Use just the address, as in @samp{king@@grassland.com}.
address@hidden @code{parens}
+Use both address and full name, as in:@*
@samp{king@@grassland.com (Elvis Parsley)}.
address@hidden angles
-Use both email address and full name, as in:@*
address@hidden @code{angles}
+Use both address and full name, as in:@*
@samp{Elvis Parsley <king@@grassland.com>}.
address@hidden system-default
-Allow the system to insert the @samp{From} field.
address@hidden 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
address@hidden header to each message:
+
address@hidden
+(setq mail-default-headers
+ "Reply-to: foo@@example.com\nFCC: ~/Mail/sent")
address@hidden smallexample
+
address@hidden
+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 @@
@cindex mail aliases
@cindex @file{.mailrc} file
@cindex mailrc 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
address@hidden fields, plus their @samp{Resent-} variants.
address@hidden The list is defined by mail-address-field-regexp.
-
- To define an alias in @file{~/.mailrc}, write a line in the following
address@hidden mail-personal-alias-file
+
+ 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
address@hidden
+
+ 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
address@hidden 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
address@hidden@@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 @@
@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
-programs; it can contain various other commands. Emacs ignores
-everything in it except for alias definitions and include commands.
-
address@hidden define-mail-alias
- Another way to define a mail alias, within Emacs alone, is with the
address@hidden command. It prompts for the alias and then the
-full address. You can use it to define aliases in your @file{.emacs}
-file, like this:
-
address@hidden
-(define-mail-alias "maingnu" "gnu@@gnu.org")
address@hidden example
-
address@hidden mail-aliases
- @code{define-mail-alias} records aliases by adding them to a
-variable named @code{mail-aliases}. If you are comfortable with
-manipulating Lisp lists, you can set @code{mail-aliases} directly. The
-initial value of @code{mail-aliases} is @code{t}, which means that
-Emacs should read @file{.mailrc} to get the proper value.
-
address@hidden mail-personal-alias-file
- You can specify a different file name to use instead of
address@hidden/.mailrc} by setting the variable
address@hidden
-
address@hidden There is also mail-alias-file for the system aliases.
-
address@hidden expand-mail-aliases
- Normally, Emacs expands aliases when you send the message. You do not
-need to expand mail aliases before sending the message, but you can
-expand them if you want to see where the mail will actually go. To do
-this, use the command @kbd{M-x expand-mail-aliases}; it expands all mail
-aliases currently present in the mail headers that hold addresses.
-
- If you like, you can have mail aliases expand as abbrevs, as soon as
-you type them in (@pxref{Abbrevs}). To enable this feature, execute the
-following:
-
address@hidden
-(add-hook 'mail-mode-hook 'mail-abbrevs-setup)
address@hidden example
-
address@hidden
address@hidden define-mail-abbrev
address@hidden mail-abbrevs
-This can go in your @file{.emacs} file. @xref{Hooks}. If you use this
-feature, you must use @code{define-mail-abbrev} instead of
address@hidden; the latter does not work with this package.
-Note that the mail abbreviation package uses the variable
address@hidden instead of @code{mail-aliases}, and that all alias
-names are converted to lower case.
-
address@hidden C-c C-a @r{(Mail mode)}
+The @file{.mailrc} file is not unique to Emacs; many other
+mail-reading programs use it for mail aliases, and it can contain
+various other commands. However, Emacs ignores everything except
+alias definitions and include commands.
+
@findex mail-abbrev-insert-alias
- The mail abbreviation package also provides the @kbd{C-c C-a}
-(@code{mail-abbrev-insert-alias}) command, which reads an alias
-name (with completion) and inserts its definition at point. This is
-useful when editing the message text itself or a header field such as
address@hidden in which Emacs does not normally expand aliases.
-
- Note that abbrevs expand only if you insert a word-separator character
-afterward. However, you can rebind @kbd{C-n} and @kbd{M->} to cause
-expansion as well. Here's how to do that:
-
address@hidden
-(add-hook 'mail-mode-hook
- (lambda ()
- (define-key
- mail-mode-map [remap next-line] 'mail-abbrev-next-line)
- (define-key
- mail-mode-map [remap end-of-buffer] 'mail-abbrev-end-of-buffer)))
address@hidden smallexample
-
address@hidden Mail Mode
address@hidden Mail Mode
address@hidden Mail mode
address@hidden mode, Mail
-
- The major mode used in the mail buffer is Mail mode, which is much
-like Text mode except that various special commands are provided on the
address@hidden prefix. These commands all have to do specifically with
-editing or sending the message.
-
- Mail mode is normally used in buffers set up automatically by the
address@hidden command and related commands. However, you can also switch
-to Mail mode in a file-visiting buffer. This is a useful thing to do if
-you have saved the text of a draft message in a file.
+ Mail aliases expand as abbrevs---that is to say, as soon as you type
+a word-separator character after an alias (@pxref{Abbrevs}). This
+expansion takes place only within the @samp{To}, @samp{From},
address@hidden, @samp{BCC}, and @samp{Reply-to} header fields (plus their
address@hidden variants); it does not take place in other header
+fields, such as @samp{Subject}.
+
+ You can also insert an aliased address directly, using the command
address@hidden mail-abbrev-insert-alias}. This reads an alias name, with
+completion, and inserts its definition at point.
+
address@hidden Mail Commands
address@hidden Mail Commands
address@hidden Message mode
address@hidden mode, Message
+
+ The default major mode for the @samp{*mail*} buffer is called
+Message mode. It behaves like Text mode in many ways, but provides
+several additional commands on the @kbd{C-c} prefix, which make
+editing a message more convenient.
+
+ In this section, we will describe some of the most commonly-used
+commands available in Message mode.
address@hidden
+Message mode also has its own manual, where its features are described
+in greater detail. @xref{Top,,Message, message, Message}.
address@hidden ifnottex
@menu
* 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.
@end menu
@node Mail Sending
@subsection Mail Sending
- Mail mode has two commands for sending the message you have been
-editing:
+ There are two commands to send a message you have been editing:
@table @kbd
address@hidden C-c C-c
+Send the message, and deselect the mail buffer (@code{message-send-and-exit}).
@item C-c C-s
-Send the message, and leave the mail buffer selected (@code{mail-send}).
address@hidden C-c C-c
-Send the message, and select some other buffer (@code{mail-send-and-exit}).
+Send the message, and leave the mail buffer selected (@code{message-send}).
@end table
address@hidden C-c C-s @r{(Mail mode)}
address@hidden C-c C-c @r{(Mail mode)}
address@hidden mail-send
address@hidden mail-send-and-exit
address@hidden mail-send-hook
- @kbd{C-c C-s} (@code{mail-send}) sends the message and marks the mail
-buffer unmodified, but leaves that buffer selected so that you can
-modify the message (perhaps with new recipients) and send it again.
address@hidden C-c} (@code{mail-send-and-exit}) sends and then deletes the
-window or switches to another buffer. It puts the mail buffer at the
-lowest priority for reselection by default, since you are finished with
-using it. This is the usual way to send the message. Sending a message
-runs the hook @code{mail-send-hook}.
-
address@hidden Options not mentioned: mail-interactive, mail-use-dsn.
address@hidden C-c C-s @r{(Message mode)}
address@hidden C-c C-c @r{(Message mode)}
address@hidden message-send
+ If you want to send a message and be done with it, type @kbd{C-c
+C-c} (@code{mail-send-and-exit}). This sends the message and then
+either deletes the window or switches to another buffer. It also
+``buries'' the mail buffer, putting it at the lowest priority for
+reselection. This is the usual command for sending a message.
+
address@hidden message-send-and-exit
+ The command @kbd{C-c C-s} (@code{message-send}) sends the message
+and marks the mail buffer unmodified, but leaves the buffer selected.
+Use this command if you want to modify the message (perhaps with new
+recipients) and send it again.
+
address@hidden message-send-hook
+ Sending a message runs the hook @code{message-send-hook}.
In a file-visiting buffer, sending the message does not clear the
modified flag, because only saving the file should do that. Also, you
don't get a warning if you try to send the same message twice.
address@hidden This is indexed in mule.texi, node "Recognize Coding".
address@hidden @vindex sendmail-coding-system
- When you send a message that contains address@hidden characters, they need
-to be encoded with a coding system (@pxref{Coding Systems}). Usually
-the coding system is specified automatically by your chosen language
-environment (@pxref{Language Environments}). You can explicitly specify
-the coding system for outgoing mail by setting the variable
address@hidden (@pxref{Recognize Coding}).
-
- If the coding system thus determined does not handle the characters in
-a particular message, Emacs asks you to select the coding system to use,
address@hidden sendmail-coding-system
+ When you send a message containing address@hidden characters,
+they need to be encoded with a coding system (@pxref{Coding Systems}).
+Usually the coding system is specified automatically by your chosen
+language environment (@pxref{Language Environments}). You can
+explicitly specify the coding system for outgoing mail by setting the
+variable @code{sendmail-coding-system} (@pxref{Recognize Coding}). If
+the coding system thus determined does not handle the characters in a
+particular message, Emacs asks you to select the coding system to use,
showing a list of possible coding systems.
address@hidden Not mentioned: mail-send-nonascii.
-
@cindex SMTP
@cindex Feedmail
@cindex Sendmail
@cindex Mailclient
@vindex send-mail-function
The variable @code{send-mail-function} controls how the default mail
-user agent sends mail. It should be set to a function. In most cases,
-the default is @code{sendmail-send-it}, which delivers mail using the
-Sendmail installation on the local host. On Mac OS X and MS-Windows,
-however, the default is normally @code{mailclient-send-it}, which
-passes the mail buffer on to the system's designated mail client (see
address@hidden). To send mail through an SMTP server, set
address@hidden to @code{smtpmail-send-it} and set up the
-Emacs SMTP library (@pxref{Top,,Emacs SMTP Library, smtpmail, Sending
-mail via SMTP}). Another option is @code{feedmail-send-it} (see the
-commentary section of the @file{feedmail.el} package).
+user agent sends mail. It should be set to a function. In most
+cases, the default is @code{sendmail-send-it}, which delivers mail
+using @command{sendmail} (or a @command{sendmail}-compatible program).
+On Mac OS X and MS-Windows, however, the default is normally
address@hidden, which passes the mail buffer on to the
+system's designated mail client (see @file{mailclient.el}). To send
+mail through an SMTP server, set @code{send-mail-function} to
address@hidden and set up the Emacs SMTP library
+(@pxref{Top,,Emacs SMTP Library, smtpmail, Sending mail via SMTP}).
+Another option is @code{feedmail-send-it} (see the commentary section
+of the @file{feedmail.el} package).
@node Header Editing
@subsection Mail Header Editing
- Mail mode provides special commands to move to particular header
-fields and to complete addresses in headers.
+ Message mode provides the following special commands to move to
+particular header fields and to complete addresses in headers.
@table @kbd
@item C-c C-f C-t
-Move to the @samp{To} header field, creating one if there is none
-(@code{mail-to}).
+Move to the @samp{To} header (@code{message-goto-to}).
@item C-c C-f C-s
-Move to the @samp{Subject} header field, creating one if there is
-none (@code{mail-subject}).
+Move to the @samp{Subject} header (@code{message-goto-subject}).
@item C-c C-f C-c
-Move to the @samp{CC} header field, creating one if there is none
-(@code{mail-cc}).
+Move to the @samp{CC} header (@code{message-goto-cc}).
@item C-c C-f C-b
-Move to the @samp{BCC} header field, creating one if there is none
-(@code{mail-bcc}).
+Move to the @samp{BCC} header (@code{message-goto-bcc}).
@item C-c C-f C-r
-Move to the @samp{Reply-To} header field, creating one if there is none
-(@code{mail-reply-to}).
address@hidden C-c C-f C-a
-Move to the @samp{Mail-Reply-To} header field, creating one if there is none
-(@code{mail-mail-reply-to}).
address@hidden C-c C-f C-l
-Move to the @samp{Mail-Followup-To} header field, creating one if there is none
-(@code{mail-mail-followup-to}).
+Move to the @samp{Reply-To} header (@code{message-goto-reply-to}).
@item C-c C-f C-f
+Move to the @samp{Mail-Followup-To} header field
+(@code{message-goto-followup-to}).
address@hidden C-c C-f C-w
Add a new @samp{FCC} header field, with file-name completion
-(@code{mail-fcc}).
address@hidden There is also C-c C-v, mail-sent-via, which adds one or more
address@hidden "Sent-via" headers, but I don't know what the point of that
header is.
address@hidden address@hidden
-Complete a mailing address (@code{mail-complete}).
+(@code{message-goto-fcc}).
address@hidden C-c C-b
+Move to the start of the message body (@code{message-goto-body}).
address@hidden @key{TAB}
+Complete a mailing address (@code{message-tab}).
@end table
address@hidden C-c C-f C-t @r{(Mail mode)}
address@hidden mail-to
address@hidden C-c C-f C-s @r{(Mail mode)}
address@hidden mail-subject
address@hidden C-c C-f C-c @r{(Mail mode)}
address@hidden mail-cc
address@hidden C-c C-f C-b @r{(Mail mode)}
address@hidden mail-bcc
address@hidden C-c C-f C-r @r{(Mail mode)}
address@hidden mail-reply-to
address@hidden C-c C-f C-a @r{(Mail mode)}
address@hidden mail-mail-reply-to
address@hidden C-c C-f C-l @r{(Mail mode)}
address@hidden mail-mail-followup-to
address@hidden C-c C-f C-f @r{(Mail mode)}
address@hidden mail-fcc
- There are several commands to move point to particular header fields,
-all based on the prefix @kbd{C-c C-f} (@samp{C-f} is for ``field'').
-They are listed in the table above. If the field in question does not
-exist, these commands create one (the exception is @code{mail-fcc},
-which creates a new field each time). We provide special motion
-commands for these particular fields because they are the fields users
-most often want to edit.
-
address@hidden mail-complete
address@hidden M-TAB @r{(Mail mode)}
address@hidden `mail-complete-alist' specifies the headers.
- While editing a header field that contains mailing addresses, such
-as @samp{To:}, @samp{CC:} and @samp{BCC:}, you can complete a mailing
-address by typing @address@hidden (@code{mail-complete}). It
-inserts the full name corresponding to the address, if it can
-determine the full name. The variable @code{mail-complete-style}
-controls whether to insert the full name, and what style to use, as in
address@hidden (@pxref{Mail Headers}). (If your window
-manager defines @address@hidden to switch windows, you can type
address@hidden@key{ESC} @key{TAB}} or @kbd{C-M-i}.)
-
- For completion purposes, the valid mailing addresses are taken to be
-the local users' names plus your personal mail aliases (@pxref{Mail
-Aliases}). You can specify additional sources of valid addresses;
-browse the customization group @samp{mailalias} to see the variables for
-customizing this feature (@pxref{Customization Groups}).
-
- If you type @address@hidden in the body of the message, or on a
-unrecognized header, @code{mail-complete} invokes the function specified
-by @code{mail-complete-function}. By default, this is
address@hidden, as in Text mode.
address@hidden C-c C-f C-t @r{(Message mode)}
address@hidden message-goto-to
address@hidden C-c C-f C-s @r{(Message mode)}
address@hidden message-goto-subject
address@hidden C-c C-f C-c @r{(Message mode)}
address@hidden message-goto-cc
address@hidden C-c C-f C-b @r{(Message mode)}
address@hidden message-goto-bcc
address@hidden C-c C-f C-r @r{(Message mode)}
address@hidden goto-reply-to
address@hidden C-c C-f C-f @r{(Message mode)}
address@hidden goto-followup-to
address@hidden C-c C-f C-w @r{(Message mode)}
address@hidden message-goto-fcc
+ The commands to move point to particular header fields are all based
+on the prefix @kbd{C-c C-f} (@samp{C-f} is for ``field''). If the
+field in question does not exist, the command creates one (the
+exception is @code{mail-fcc}, which creates a new field each time).
+
address@hidden C-c C-b @r{(Message mode)}
address@hidden mail-text
+ The command @kbd{C-c C-b} (@code{message-goto-body}) moves point to
+just after the header separator line---that is, to the beginning of
+the body.
+
address@hidden message-tab
address@hidden TAB @r{(Message mode)}
+ While editing a header field that contains addresses, such as
address@hidden:}, @samp{CC:} and @samp{BCC:}, you can complete an address by
+typing @key{TAB} (@code{message-tab}). This attempts to insert the
+full name corresponding to the address based on a couple of methods,
+including EUDC, a library that recognizes a number of directory server
+protocols (@pxref{Top,,EUDC,eudc, The Emacs Unified Directory
+Client}). Failing that, it attempts to expand the address as a mail
+alias (@pxref{Mail Aliases}). If point is on a header field that does
+not take addresses, or if it is in the message body, then @key{TAB}
+just inserts a tab character.
@node Citing Mail
@subsection Citing Mail
@cindex citing mail
- Mail mode also has commands for yanking or @dfn{citing} all or part of
-a message that you are replying to. These commands are active only when
-you started sending a message using an Rmail command.
-
@table @kbd
@item C-c C-y
-Yank the selected message from Rmail (@code{mail-yank-original}).
address@hidden C-c C-r
-Yank the region from the Rmail buffer (@code{mail-yank-region}).
+Yank the selected message from Rmail (@code{message-yank-original}).
@item C-c C-q
Fill each paragraph cited from another message
-(@code{mail-fill-yanked-message}).
address@hidden There is also mail-split-line, but it does not seem very useful.
+(@code{message-fill-yanked-message}).
@end table
address@hidden C-c C-y @r{(Mail mode)}
address@hidden mail-yank-original
- When mail sending is invoked from the Rmail mail reader using an Rmail
-command, @kbd{C-c C-y} can be used inside the mail buffer to insert the
-text of the message you are replying to. Normally it indents each line
-of that message three spaces and eliminates most header fields (as
-specified by the variable @code{mail-yank-ignored-headers}). A numeric
-argument specifies the number of spaces to indent (the variable
address@hidden specifies the default number). An
-argument of just @kbd{C-u} says not to indent at all and not to
-eliminate anything. @kbd{C-c C-y} always uses the current message from
-the Rmail buffer, so you can insert several old messages by selecting
-one in Rmail, switching to @samp{*mail*} and yanking it, then switching
-back to Rmail to select another.
-
address@hidden mail-yank-prefix
- You can specify the text for @kbd{C-c C-y} to insert at the beginning
-of each line: set @code{mail-yank-prefix} to the desired string. (A
-value of @code{nil} means to use indentation; this is the default.)
-However, @kbd{C-u C-c C-y} never adds anything at the beginning of the
-inserted lines, regardless of the value of @code{mail-yank-prefix}.
-
address@hidden C-c C-r @r{(Mail mode)}
address@hidden mail-yank-region
- To yank just a part of an incoming message, set the region in Rmail to
-the part you want; then go to the @samp{*Mail*} message and type
address@hidden C-r} (@code{mail-yank-region}). Each line that is copied is
-indented or prefixed according to @code{mail-yank-prefix}.
-
address@hidden C-c C-q @r{(Mail mode)}
address@hidden C-c C-y @r{(Message mode)}
address@hidden message-yank-original
address@hidden message-yank-prefix
+ You can use the command @kbd{C-c C-y} (@code{message-yank-original})
+to @dfn{cite} a message that you are replying to. This inserts the
+text of that message into the mail buffer. This command is active
+only when the mail buffer is invoked from a mail program running in
+Emacs, such as Rmail.
+
+ By default, Emacs inserts the string @samp{>} in front of each line
+of the cited text; this prefix string is specified by the variable
address@hidden If you call @code{message-yank-original}
+with a prefix argument, the citation prefix is not inserted.
+
address@hidden C-c C-q @r{(Message mode)}
@findex mail-fill-yanked-message
- After using @kbd{C-c C-y} or @kbd{C-c C-r}, you can type @kbd{C-c C-q}
-(@code{mail-fill-yanked-message}) to fill the paragraphs of the yanked
-old message or messages. One use of @kbd{C-c C-q} fills all such
-paragraphs, each one individually. To fill a single paragraph of the
-quoted message, use @kbd{M-q}. If filling does not automatically
-handle the type of citation prefix you use, try setting the fill prefix
+ After using @kbd{C-c C-y}, you can type @kbd{C-c C-q}
+(@code{message-fill-yanked-message}) to fill the paragraphs of the
+cited message. One use of @kbd{C-c C-q} fills all such paragraphs,
+each one individually. To fill a single paragraph of the quoted
+message, use @kbd{M-q}. If filling does not automatically handle the
+type of citation prefix you use, try setting the fill prefix
explicitly. @xref{Filling}.
@vindex mail-citation-hook
@@ -657,91 +525,103 @@
package, which provides more flexible citation
(@pxref{Introduction,,,sc, Supercite}).
address@hidden No need to mention: mail-citation-prefix-regexp.
-
address@hidden Mail Mode Misc
address@hidden Mail Mode Miscellany
-
address@hidden @kbd
address@hidden C-c C-t
-Move to the beginning of the message body text (@code{mail-text}).
address@hidden C-c C-w
-Insert a signature at the end of the message text (@code{mail-signature}).
address@hidden C-c C-i @var{file} @key{RET}
-Insert the contents of @var{file} at the end of the message text
-(@code{mail-attach-file}).
address@hidden M-x ispell-message
-Perform spelling correction on the message text, but not on citations from
-other messages, or the message headers.
address@hidden table
-
address@hidden C-c C-t @r{(Mail mode)}
address@hidden mail-text
- @kbd{C-c C-t} (@code{mail-text}) moves point to just after the header
-separator line---that is, to the beginning of the message body text.
-
address@hidden C-c C-w @r{(Mail mode)}
address@hidden mail-signature
address@hidden mail-signature
- @kbd{C-c C-w} (@code{mail-signature}) adds a standard piece of text
-(your @dfn{mail signature}) at the end of the message to say more about who
-you are. For example, it may contain telephone numbers, or your
-physical location. The text comes from the variable
address@hidden It can be a fixed string, or a Lisp expression
-that returns a string. If it is @code{t} or @code{nil}, the function
-inserts the contents of the file @code{mail-signature-file}. By
-default, this is the file @file{~/.signature} in your home directory.
-
- If the variable @code{mail-signature} has a address@hidden value,
-starting a mail automatically inserts your signature. Otherwise, you
-must explicitly use the command @code{mail-signature}. If you want to
-omit your signature from a particular message, just delete it from the
-buffer before you send the message.
-
- Convention says that the start of your signature should be marked by a
-line whose contents are @samp{-- }. If your signature comes from a
-file, this prefix is added for you, but in all other cases you must add
-it yourself. The remainder of your signature should be no more than
-four lines.
address@hidden Mail Misc
address@hidden Mail Miscellany
+
address@hidden C-c C-a @r{(Message mode)}
address@hidden mail-attach-file
address@hidden MIME
address@hidden Multipurpose Internet Mail Extensions
+ You can @dfn{attach} a file to an outgoing message by typing
address@hidden C-a} (@code{mml-attach-file}) in the mail buffer. Attaching
+is done using the MIME (Multipurpose Internet Mail Extensions)
+standard.
+
+ The @code{mml-attach-file} command prompts for the name of the file,
+and for the attachment's @dfn{content type}, @dfn{description}, and
address@hidden The content type is normally detected
+automatically; just type @key{RET} to accept the default. The
+description is a single line of text that the recipient will see next
+to the attachment; you may also choose to leave this empty. The
+disposition is either @samp{inline} (the default), which means the
+recipient will see a link to the attachment within the message body,
+or @samp{attachment}, which means the link will be separate from the
+body.
+
+ The actual contents of the attached file are not inserted into the
+mail buffer. Instead, some placeholder text is inserted into the mail
+buffer, like this:
+
address@hidden
+<#part type="text/plain" filename="~/foo.txt" disposition=inline>
+<#/part>
address@hidden smallexample
+
address@hidden
+When you type @kbd{C-c C-c} or @kbd{C-c C-s} to send the message, the
+attached file will be delivered with it.
@findex ispell-message
- You can do spelling correction on the message text you have written
-with the command @kbd{M-x ispell-message}. If you have yanked an
-incoming message into the outgoing draft, this command skips what was
-yanked, but it checks the text that you yourself inserted. (It looks
-for indentation or @code{mail-yank-prefix} to distinguish the cited
-lines from your input.) @xref{Spelling}.
-
address@hidden C-c C-i @r{(Mail mode)}
address@hidden mail-attach-file
- To include a file in the outgoing message, you can use @kbd{C-x i},
-the usual command to insert a file in the current buffer. But it is
-often more convenient to use a special command, @kbd{C-c C-i}
-(@code{mail-attach-file}). This command inserts the file contents at
-the end of the buffer, after your signature (if any), with a delimiter
-line that includes the file name. Note that this is not a MIME
-attachment.
+ While composing a message, you can do spelling correction on the
+message text by typing @kbd{M-x ispell-message}. If you have yanked
+an incoming message into the outgoing draft, this command skips what
+was yanked, but it checks the text that you yourself inserted (it
+looks for indentation or @code{mail-yank-prefix} to distinguish the
+cited lines from your input). @xref{Spelling}.
@vindex mail-mode-hook
@vindex mail-setup-hook
- Turning on Mail mode (which @kbd{C-x m} does automatically) runs the
-normal hooks @code{text-mode-hook} and @code{mail-mode-hook}.
+ Turning on Message mode (which @kbd{C-x m} does automatically) runs
+the normal hooks @code{text-mode-hook} and @code{message-mode-hook}.
Initializing a new outgoing message runs the normal hook
address@hidden; if you want to add special fields to your mail
-header or make other changes to the appearance of the mail buffer, use
-that hook. @xref{Hooks}.
address@hidden; you can use this hook if you want to make
+changes to the appearance of the mail buffer. @xref{Hooks}.
The main difference between these hooks is just when they are
-invoked. Whenever you type @kbd{M-x mail}, @code{mail-mode-hook} runs
-as soon as the @samp{*mail*} buffer is created. Then the
address@hidden function inserts the default contents of the buffer.
-After these default contents are inserted, @code{mail-setup-hook} runs.
-
- If you use @kbd{M-x mail} to continue an existing composition,
address@hidden runs immediately after switching to the
address@hidden buffer. If the buffer is unmodified, or if you decide to
-erase it and start again, @code{mail-setup-hook} runs after the default
-contents are inserted.
+invoked. Whenever you type @kbd{C-x m}, @code{message-mode-hook} runs
+as soon as the mail buffer is created. Then the @code{message-setup}
+function inserts the default contents of the buffer. After these
+default contents are inserted, @code{message-setup-hook} runs.
+
+ If you use @kbd{C-x m} to continue an existing composition,
address@hidden runs immediately after switching to the mail
+buffer. If the buffer is unmodified, or if you decide to erase it and
+start again, @code{message-setup-hook} runs after the default contents
+are inserted.
+
address@hidden Mail Signature
address@hidden Mail Signature
+
address@hidden mail signature
address@hidden mail-signature-file
address@hidden mail-signature
+ You can add a standard piece of text---your @dfn{mail
+signature}---to the end of every message. This signature may contain
+information such as your telephone number or your physical location.
+The variable @code{mail-signature} determines how Emacs handles the
+mail signature.
+
+ The default value of @code{mail-signature} is @code{t}; this means
+to look for your mail signature in the file @file{~/.signature}. If
+this file exists, its contents are automatically inserted into the end
+of the mail buffer. You can change the signature file via the
+variable @code{mail-signature-file}.
+
+ If you change @code{mail-signature} to a string, that specifies the
+text of the signature directly.
+
address@hidden C-c C-w @r{(Message mode)}
address@hidden message-insert-signature
+ If you change @code{mail-signature} to @code{nil}, Emacs will not
+insert your mail signature automatically. You can insert your mail
+signature by typing @kbd{C-c C-w} (@code{message-insert-signature}) in
+the mail buffer. Emacs will look for your signature in the signature
+file.
+
+ By convention, a mail signature should be marked by a line whose
+contents are @samp{-- }. If your signature lacks this prefix, it is
+added for you. The remainder of your signature should be no more than
+four lines.
@node Mail Amusements
@section Mail Amusements
@@ -778,28 +658,32 @@
@node Mail Methods
@section Mail-Composition Methods
@cindex mail-composition methods
address@hidden Mail mode
address@hidden mode, Mail
@cindex MH mail interface
@cindex Message mode for sending mail
In this chapter we have described the usual Emacs mode for editing
-and sending mail---Mail mode. Emacs has alternative facilities for
-editing and sending mail, including
-MH-E and Message mode, not documented in this manual.
address@hidden,,MH-E,mh-e, The Emacs Interface to MH}.
@xref{Top,,Message,message,
-Message Manual}. You can choose any of them as your preferred method.
-The commands @code{C-x m}, @code{C-x 4 m} and @code{C-x 5 m} use
-whichever agent you have specified, as do various other Emacs commands
-and facilities that send mail.
+and sending mail---Message mode. This is only one of several
+available modes. Prior to Emacs 23.2, the default mode was Mail mode,
+which is similar to Message mode in many respects but lacks features
+such as MIME support. Another available mode is MH-E
+(@pxref{Top,,MH-E,mh-e, The Emacs Interface to MH}).
@vindex mail-user-agent
- To specify your mail-composition method, customize the variable
address@hidden Currently legitimate values include
address@hidden (Mail mode), @code{mh-e-user-agent},
address@hidden and @code{gnus-user-agent}.
+ You can choose any of these @dfn{mail user agents} as your preferred
+method for editing and sending mail. The commands @code{C-x m},
address@hidden 4 m} and @code{C-x 5 m} use whichever agent you have
+specified; so do various other parts of Emacs that send mail, such as
+the bug reporter (@pxref{Bugs}). To specify a mail user agent,
+customize the variable @code{mail-user-agent}. Currently, legitimate
+values include @code{message-user-agent} (Message mode)
address@hidden (Mail mode), @code{gnus-user-agent}, and
address@hidden
If you select a different mail-composition method, the information
-in this chapter about the @samp{*mail*} buffer and Mail mode does not
-apply; the other methods use a different format of text in a different
+in this chapter about the mail buffer and Message mode does not apply;
+the other methods use a different format of text in a different
buffer, and their commands are different as well.
@vindex read-mail-command
=== modified file 'doc/emacs/text.texi'
--- a/doc/emacs/text.texi 2010-03-25 20:32:39 +0000
+++ b/doc/emacs/text.texi 2010-03-28 03:41:34 +0000
@@ -928,10 +928,10 @@
@vindex text-mode-hook
Entering Text mode runs the hook @code{text-mode-hook}. Other major
modes related to Text mode also run this hook, followed by hooks of
-their own; this includes Paragraph-Indent Text mode, Nroff mode, @TeX{}
-mode, Outline mode, and Mail mode. Hook functions on
address@hidden can look at the value of @code{major-mode} to see
-which of these modes is actually being entered. @xref{Hooks}.
+their own; this includes Paragraph-Indent Text mode, Nroff mode,
address@hidden mode, Outline mode, and Message mode. Hook functions on
address@hidden can look at the value of @code{major-mode} to
+see which of these modes is actually being entered. @xref{Hooks}.
@node Outline Mode
@section Outline Mode
=== modified file 'etc/NEWS'
--- a/etc/NEWS 2010-03-26 17:43:01 +0000
+++ b/etc/NEWS 2010-03-28 03:41:34 +0000
@@ -250,6 +250,7 @@
manual that generates an Info file which gives the same information
through a menu structure.
++++
** Message mode is now the default mode for composing mail.
The default for `mail-user-agent' is now message-user-agent, so the
@@ -259,6 +260,7 @@
for several years. It provides several features that are absent in
Mail mode, such as MIME handling.
+---
*** If the user has not customized mail-user-agent, `compose-mail'
checks for Mail mode customizations, and issues a warning if these
customizations are found. This alerts users who may otherwise be
@@ -284,9 +286,8 @@
*** ansi-color is now enabled by default in Shell mode.
To disable it, set ansi-color-for-comint-mode to nil.
+** Tramp
+++
-** Tramp
-
*** New connection methods "rsyncc", "imap" and "imaps".
On systems which support GVFS-Fuse, Tramp offers also the new
connection methods "dav", "davs", "obex" and "synce".
@@ -317,7 +318,7 @@
it displays the old names for the files and it can show logs/diffs for
the corresponding lines. Currently only Git and Mercurial take
advantage of this feature.
-
+---
*** The log command in vc-annotate can display a single log entry
instead of redisplaying the full log. The RCS, CVS and SCCS VC
backends do not support this.
@@ -341,7 +342,7 @@
*** vc-bzr supports operating with shelves: the shelve list is
displayed in the *vc-dir* header, shelves can be created, removed and applied.
-
+---
*** log-edit-strip-single-file-name controls whether or not single filenames
are stripped when copying text from the ChangeLog to the *VC-Log* buffer.
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/emacs-23 r99689: Document Message mode as the default mail mode.,
Chong Yidong <=