@c This is part of the Emacs manual.
-@c Copyright (C) 1985,86,87,93,94,95,97,2000,2001, 2003
-@c Free Software Foundation, Inc.
+@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2000, 2001, 2002,
+@c 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
-@node Sending Mail, Rmail, Picture, Top
+@node Sending Mail, Rmail, Abbrevs, Top
@chapter Sending Mail
@cindex sending mail
@cindex mail
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 is left selected with its old contents, so you can
+@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.
automatically when you send the message. Others, such as the recipient
names, must be specified by you in order to send the message properly.
- Mail mode provides a few commands to help you edit some header fields,
-and some are preinitialized in the buffer automatically at times. You can
-insert and edit header fields using ordinary editing commands.
+ In the mail buffer, you can insert and edit header fields using
+ordinary editing commands. Mail mode provides a commands to help you
+edit some header fields, and some are preinitialized in the buffer
+automatically when appropriate.
The line in the buffer that says
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
+ Here is an example of what the headers and text in the mail buffer
might look like.
@example
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:@refill
+line:
@example
@group
alias maingnu gnu@@gnu.org local-gnu
@end example
- Emacs also recognizes include commands in @samp{.mailrc} files.
+@noindent
+Addresses specified in this way should use doublequotes around an
+entire address when the address contains spaces. But you need not
+include doublequotes around parts of the address, such as the person's
+full name. Emacs puts them in if they are needed. For example,
+
+@example
+alias chief-torturer "George W. Bush <bush@@whitehouse.gov>"
+@end example
+
+@noindent
+is correct. Emacs will insert the address as @samp{"George W. Bush"
+<bush@@whitehouse.gov>}.
+
+ Emacs also recognizes ``include'' commands in @samp{.mailrc} files.
They look like this:
@example
@smallexample
(add-hook 'mail-mode-hook
(lambda ()
- (substitute-key-definition
- 'next-line 'mail-abbrev-next-line
- mail-mode-map global-map)
- (substitute-key-definition
- 'end-of-buffer 'mail-abbrev-end-of-buffer
- mail-mode-map global-map)))
+ (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)))
@end smallexample
@node Mail Mode
using it. This is the usual way to send the message.
In a file-visiting buffer, sending the message does not clear the
-modified flag, because only saving the file should do that. As a
-result, you don't get a warning if you try to send the same message
-twice.
+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.
@c This is indexed in mule.texi, node "Recognize Coding".
@c @vindex sendmail-coding-system
determine the full name. The variable @code{mail-complete-style}
controls whether to insert the full name, and what style to use, as in
@code{mail-from-style} (@pxref{Mail Headers}). (If your window
-manager defines @kbd{M-@key{TAB}} to switch windows, you can type this
-Emacs command as @kbd{@key{ESC} @key{TAB}}.)
+manager defines @kbd{M-@key{TAB}} to switch windows, you can type
+@kbd{@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. You can
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.
+line that includes the file name. Note that this is not a MIME
+attachment.
@vindex mail-mode-hook
@vindex mail-setup-hook