aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEli Zaretskii2018-02-20 21:13:29 +0200
committerEli Zaretskii2018-02-20 21:13:29 +0200
commit355c644cc24a3aa1cf4e9d940690342ad4e67e6f (patch)
treea50598b7abc98fa0724e9c639b748056322ae4cd
parent226aca32a784c4edebdec6a16eb90930aae64c06 (diff)
downloademacs-355c644cc24a3aa1cf4e9d940690342ad4e67e6f.tar.gz
emacs-355c644cc24a3aa1cf4e9d940690342ad4e67e6f.zip
Improve the "Sending Mail" chapter of Emacs manual
* doc/emacs/sending.texi (Mail Format, Header Editing) (Mail Aliases): Fix capitalization of mail headers. (Mail Aliases): Use ~/.mailrc consistently. (Mail Misc): More accurate description of disposition. Suggested by Michael Albinus <michael.albinus@gmx.de> in emacs-manual-bugs@gnu.org.
-rw-r--r--doc/emacs/sending.texi40
1 files changed, 20 insertions, 20 deletions
diff --git a/doc/emacs/sending.texi b/doc/emacs/sending.texi
index 299f7896172..491cda42177 100644
--- a/doc/emacs/sending.texi
+++ b/doc/emacs/sending.texi
@@ -70,7 +70,7 @@ or using some other method. @xref{Mail Sending}, for details.
70 70
71@example 71@example
72To: subotai@@example.org 72To: subotai@@example.org
73CC: mongol.soldier@@example.net, rms@@gnu.org 73Cc: mongol.soldier@@example.net, rms@@gnu.org
74Subject: Re: What is best in life? 74Subject: Re: What is best in life?
75From: conan@@example.org 75From: conan@@example.org
76--text follows this line-- 76--text follows this line--
@@ -152,23 +152,23 @@ more than one address, use commas to separate them.
152@item Subject 152@item Subject
153The subject of the message. 153The subject of the message.
154 154
155@item CC 155@item Cc
156Additional mailing address(es) to send the message to. This is like 156Additional mailing address(es) to send the message to. This is like
157@samp{To}, except that these readers should not regard the message as 157@samp{To}, except that these readers should not regard the message as
158directed at them. 158directed at them.
159 159
160@item BCC 160@item Bcc
161Additional mailing address(es) to send the message to, which should 161Additional mailing address(es) to send the message to, which should
162not appear in the header of the message actually sent. @samp{BCC} stands 162not appear in the header of the message actually sent. @samp{Bcc} stands
163for @dfn{blind carbon copies}. 163for @dfn{blind carbon copies}.
164 164
165@item FCC 165@item Fcc
166The name of a file, to which a copy of the sent message should be 166The name of a file, to which a copy of the sent message should be
167appended. Emacs writes the message in mbox format, unless the file is 167appended. Emacs writes the message in mbox format, unless the file is
168in Babyl format (used by Rmail before Emacs 23), in which case Emacs 168in Babyl format (used by Rmail before Emacs 23), in which case Emacs
169writes in Babyl format. If an Rmail buffer is visiting the file, 169writes in Babyl format. If an Rmail buffer is visiting the file,
170Emacs updates it accordingly. To specify more than one file, use 170Emacs updates it accordingly. To specify more than one file, use
171several @samp{FCC} fields, with one file name in each field. 171several @samp{Fcc} fields, with one file name in each field.
172 172
173@item Reply-to 173@item Reply-to
174An address to which replies should be sent, instead of @samp{From}. 174An address to which replies should be sent, instead of @samp{From}.
@@ -198,7 +198,7 @@ this is normally filled in automatically for you.
198@end table 198@end table
199 199
200@noindent 200@noindent
201The @samp{To}, @samp{CC}, and @samp{BCC} fields can appear any number 201The @samp{To}, @samp{Cc}, and @samp{Bcc} fields can appear any number
202of times, and each such header field can contain multiple addresses, 202of times, and each such header field can contain multiple addresses,
203separated by commas. This way, you can specify any number of places 203separated by commas. This way, you can specify any number of places
204to send the message. These fields can also have continuation lines: 204to send the message. These fields can also have continuation lines:
@@ -221,11 +221,11 @@ To: foo@@example.net, this@@example.net,
221buffer by setting the variable @code{mail-default-headers} to a 221buffer by setting the variable @code{mail-default-headers} to a
222string. Then @kbd{C-x m} inserts this string into the message 222string. Then @kbd{C-x m} inserts this string into the message
223headers. For example, here is how to add a @samp{Reply-to} and 223headers. For example, here is how to add a @samp{Reply-to} and
224@samp{FCC} header to each message: 224@samp{Fcc} header to each message:
225 225
226@smallexample 226@smallexample
227(setq mail-default-headers 227(setq mail-default-headers
228 "Reply-to: foo@@example.com\nFCC: ~/Mail/sent") 228 "Reply-to: foo@@example.com\nFcc: ~/Mail/sent")
229@end smallexample 229@end smallexample
230 230
231@noindent 231@noindent
@@ -245,7 +245,7 @@ aliases are defined in the file @file{~/.mailrc}. You can specify a
245different file name to use, by setting the variable 245different file name to use, by setting the variable
246@code{mail-personal-alias-file}. 246@code{mail-personal-alias-file}.
247 247
248 To define an alias in @file{.mailrc}, write a line like this: 248 To define an alias in @file{~/.mailrc}, write a line like this:
249 249
250@example 250@example
251alias @var{nick} @var{fulladdresses} 251alias @var{nick} @var{fulladdresses}
@@ -276,7 +276,7 @@ of the address, such as the person's full name. Emacs puts them in if
276they are needed. For instance, it inserts the above address as 276they are needed. For instance, it inserts the above address as
277@samp{"John Q. Smith" <none@@example.com>}. 277@samp{"John Q. Smith" <none@@example.com>}.
278 278
279 Emacs also recognizes include commands in @file{.mailrc}. They 279 Emacs also recognizes include commands in @file{~/.mailrc}. They
280look like this: 280look like this:
281 281
282@example 282@example
@@ -284,7 +284,7 @@ source @var{filename}
284@end example 284@end example
285 285
286@noindent 286@noindent
287The @file{.mailrc} file is not unique to Emacs; many other 287The @file{~/.mailrc} file is not unique to Emacs; many other
288mail-reading programs use it for mail aliases, and it can contain 288mail-reading programs use it for mail aliases, and it can contain
289various other commands. However, Emacs ignores everything except 289various other commands. However, Emacs ignores everything except
290alias definitions and include commands. 290alias definitions and include commands.
@@ -293,7 +293,7 @@ alias definitions and include commands.
293 Mail aliases expand as abbrevs---that is to say, as soon as you type 293 Mail aliases expand as abbrevs---that is to say, as soon as you type
294a word-separator character after an alias (@pxref{Abbrevs}). This 294a word-separator character after an alias (@pxref{Abbrevs}). This
295expansion takes place only within the @samp{To}, @samp{From}, 295expansion takes place only within the @samp{To}, @samp{From},
296@samp{CC}, @samp{BCC}, and @samp{Reply-to} header fields (plus their 296@samp{Cc}, @samp{Bcc}, and @samp{Reply-to} header fields (plus their
297@samp{Resent-} variants); it does not take place in other header 297@samp{Resent-} variants); it does not take place in other header
298fields, such as @samp{Subject}. 298fields, such as @samp{Subject}.
299 299
@@ -418,16 +418,16 @@ Move to the @samp{To} header (@code{message-goto-to}).
418@item C-c C-f C-s 418@item C-c C-f C-s
419Move to the @samp{Subject} header (@code{message-goto-subject}). 419Move to the @samp{Subject} header (@code{message-goto-subject}).
420@item C-c C-f C-c 420@item C-c C-f C-c
421Move to the @samp{CC} header (@code{message-goto-cc}). 421Move to the @samp{Cc} header (@code{message-goto-cc}).
422@item C-c C-f C-b 422@item C-c C-f C-b
423Move to the @samp{BCC} header (@code{message-goto-bcc}). 423Move to the @samp{Bcc} header (@code{message-goto-bcc}).
424@item C-c C-f C-r 424@item C-c C-f C-r
425Move to the @samp{Reply-To} header (@code{message-goto-reply-to}). 425Move to the @samp{Reply-To} header (@code{message-goto-reply-to}).
426@item C-c C-f C-f 426@item C-c C-f C-f
427Move to the @samp{Mail-Followup-To} header field 427Move to the @samp{Mail-Followup-To} header field
428(@code{message-goto-followup-to}). 428(@code{message-goto-followup-to}).
429@item C-c C-f C-w 429@item C-c C-f C-w
430Add a new @samp{FCC} header field, with file-name completion 430Add a new @samp{Fcc} header field, with file-name completion
431(@code{message-goto-fcc}). 431(@code{message-goto-fcc}).
432@item C-c C-b 432@item C-c C-b
433Move to the start of the message body (@code{message-goto-body}). 433Move to the start of the message body (@code{message-goto-body}).
@@ -463,7 +463,7 @@ the body.
463@findex message-tab 463@findex message-tab
464@kindex TAB @r{(Message mode)} 464@kindex TAB @r{(Message mode)}
465 While editing a header field that contains addresses, such as 465 While editing a header field that contains addresses, such as
466@samp{To:}, @samp{CC:} and @samp{BCC:}, you can complete an address by 466@samp{To:}, @samp{Cc:} and @samp{Bcc:}, you can complete an address by
467typing @key{TAB} (@code{message-tab}). This attempts to insert the 467typing @key{TAB} (@code{message-tab}). This attempts to insert the
468full name corresponding to the address based on a couple of methods, 468full name corresponding to the address based on a couple of methods,
469including EUDC, a library that recognizes a number of directory server 469including EUDC, a library that recognizes a number of directory server
@@ -534,9 +534,9 @@ and for the attachment's @dfn{content type}, @dfn{description}, and
534automatically; just type @key{RET} to accept the default. The 534automatically; just type @key{RET} to accept the default. The
535description is a single line of text that the recipient will see next 535description is a single line of text that the recipient will see next
536to the attachment; you may also choose to leave this empty. The 536to the attachment; you may also choose to leave this empty. The
537disposition is either @samp{inline} (the default), which means the 537disposition is either @samp{inline}, which means the recipient will
538recipient will see a link to the attachment within the message body, 538see a link to the attachment within the message body, or
539or @samp{attachment}, which means the link will be separate from the 539@samp{attachment}, which means the link will be separate from the
540body. 540body.
541 541
542@findex mail-add-attachment 542@findex mail-add-attachment