annotate doc/misc/message.texi @ 99703:fe597ddfd2ca

Relicense under FDL 1.3 or later. Include doclicense.texi rather than having license in the file itself.
author Glenn Morris <rgm@gnu.org>
date Wed, 19 Nov 2008 04:23:44 +0000
parents 952d664ebd93
children 6de181810d0f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2
84329
3d431f1997d8 (setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents: 84305
diff changeset
3 @setfilename ../../info/message
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 @settitle Message Manual
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5 @synindex fn cp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 @synindex vr cp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 @synindex pg cp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 @copying
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 This file documents Message, the Emacs message composition mode.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
87647
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
12 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 @quotation
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15 Permission is granted to copy, distribute and/or modify this document
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 under the terms of the GNU Free Documentation License, Version 1.2 or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 any later version published by the Free Software Foundation; with no
95937
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
18 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
19 and with the Back-Cover Texts as in (a) below. A copy of the license
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
20 is included in the section entitled ``GNU Free Documentation License''.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21
95874
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87647
diff changeset
22 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87647
diff changeset
23 modify this GNU manual. Buying copies from the FSF supports it in
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87647
diff changeset
24 developing GNU and promoting software freedom.''
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 @end quotation
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 @end copying
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 @dircategory Emacs
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 @direntry
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 * Message: (message). Mail and news composition mode that goes with Gnus.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 @end direntry
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 @iftex
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 @finalout
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 @end iftex
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 @setchapternewpage odd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 @titlepage
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38 @title Message Manual
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 @author by Lars Magne Ingebrigtsen
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 @page
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 @vskip 0pt plus 1filll
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 @insertcopying
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 @end titlepage
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 @page
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 @node Top
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49 @top Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51 All message composition from Gnus (both mail and news) takes place in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52 Message mode buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 * Interface:: Setting up message buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 * Commands:: Commands you can execute in message mode buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 * Variables:: Customizing the message buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 * Compatibility:: Making Message backwards compatible.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59 * Appendices:: More technical things.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 * GNU Free Documentation License:: The license for this documentation.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61 * Index:: Variable, function and concept index.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 * Key Index:: List of Message mode keys.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 @c Adjust ../Makefile.in if you change the following lines:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 Message is distributed with Gnus. The Gnus distribution
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 @c
85713
f023b81ee7b4 * gnus.texi, gnus-faq.texi, message.texi: Bump version to Gnus v5.13.
Reiner Steib <Reiner.Steib@gmx.de>
parents: 85712
diff changeset
68 corresponding to this manual is Gnus v5.13
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 @node Interface
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 @chapter Interface
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
74 When a program (or a person) wants to respond to a message---reply,
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
75 follow up, forward, cancel---the program (or person) should just put
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 point in the buffer where the message is and call the required command.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 @code{Message} will then pop up a new @code{message} mode buffer with
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 appropriate headers filled out, and the user can edit the message before
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 sending it.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 * New Mail Message:: Editing a brand new mail message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 * New News Message:: Editing a brand new news message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 * Reply:: Replying via mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 * Wide Reply:: Responding to all people via mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 * Followup:: Following up via news.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 * Canceling News:: Canceling a news article.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88 * Superseding:: Superseding a message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89 * Forwarding:: Forwarding a message via news or mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 * Resending:: Resending a mail message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91 * Bouncing:: Bouncing a mail message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 * Mailing Lists:: Send mail to mailing lists.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95 You can customize the Message Mode tool bar, see @kbd{M-x
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96 customize-apropos RET message-tool-bar}. This feature is only available
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
97 in Emacs.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
98
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
99 @node New Mail Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
100 @section New Mail Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
102 @findex message-mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
103 The @code{message-mail} command pops up a new message buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 Two optional parameters are accepted: The first will be used as the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 @code{To} header and the second as the @code{Subject} header. If these
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107 are @code{nil}, those two headers will be empty.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 @node New News Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 @section New News Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113 @findex message-news
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 The @code{message-news} command pops up a new message buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116 This function accepts two optional parameters. The first will be used
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 as the @code{Newsgroups} header and the second as the @code{Subject}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118 header. If these are @code{nil}, those two headers will be empty.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121 @node Reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 @section Reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
123
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124 @findex message-reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125 The @code{message-reply} function pops up a message buffer that's a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
126 reply to the message in the current buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128 @vindex message-reply-to-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
129 Message uses the normal methods to determine where replies are to go
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130 (@pxref{Responses}), but you can change the behavior to suit your needs
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131 by fiddling with the @code{message-reply-to-function} variable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133 If you want the replies to go to the @code{Sender} instead of the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 @code{From}, you could do something like this:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 (setq message-reply-to-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138 (lambda ()
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139 (cond ((equal (mail-fetch-field "from") "somebody")
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
140 (list (cons 'To (mail-fetch-field "sender"))))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
141 (t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
142 nil))))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145 This function will be called narrowed to the head of the article that is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 being replied to.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 As you can see, this function should return a list. In this case, it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 returns @code{((To . "Whom"))} if it has an opinion as to what the To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150 header should be. If it does not, it should just return @code{nil}, and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 the normal methods for determining the To header will be used.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 Each list element should be a cons, where the @sc{car} should be the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 name of a header (e.g. @code{Cc}) and the @sc{cdr} should be the header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 value (e.g. @samp{larsi@@ifi.uio.no}). All these headers will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156 inserted into the head of the outgoing mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159 @node Wide Reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160 @section Wide Reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 @findex message-wide-reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 The @code{message-wide-reply} pops up a message buffer that's a wide
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164 reply to the message in the current buffer. A @dfn{wide reply} is a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165 reply that goes out to all people listed in the @code{To}, @code{From}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 (or @code{Reply-to}) and @code{Cc} headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 @vindex message-wide-reply-to-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 Message uses the normal methods to determine where wide replies are to go,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170 but you can change the behavior to suit your needs by fiddling with the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171 @code{message-wide-reply-to-function}. It is used in the same way as
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 @code{message-reply-to-function} (@pxref{Reply}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 @vindex message-dont-reply-to-names
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175 Addresses that match the @code{message-dont-reply-to-names} regular
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
176 expression (or list of regular expressions) will be removed from the
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
177 @code{Cc} header. A value of @code{nil} means exclude your name only.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179 @vindex message-wide-reply-confirm-recipients
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180 If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 will be asked to confirm that you want to reply to multiple
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 recipients. The default is @code{nil}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184 @node Followup
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185 @section Followup
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187 @findex message-followup
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188 The @code{message-followup} command pops up a message buffer that's a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189 followup to the message in the current buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191 @vindex message-followup-to-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192 Message uses the normal methods to determine where followups are to go,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 but you can change the behavior to suit your needs by fiddling with the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194 @code{message-followup-to-function}. It is used in the same way as
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195 @code{message-reply-to-function} (@pxref{Reply}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197 @vindex message-use-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 The @code{message-use-followup-to} variable says what to do about
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199 @code{Followup-To} headers. If it is @code{use}, always use the value.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200 If it is @code{ask} (which is the default), ask whether to use the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201 value. If it is @code{t}, use the value unless it is @samp{poster}. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202 it is @code{nil}, don't use the value.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 @node Canceling News
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206 @section Canceling News
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208 @findex message-cancel-news
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209 The @code{message-cancel-news} command cancels the article in the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210 current buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 @vindex message-cancel-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213 The value of @code{message-cancel-message} is inserted in the body of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214 the cancel message. The default is @samp{I am canceling my own
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 article.}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
216
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
217 @cindex Cancel Locks
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218 @vindex message-insert-canlock
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219 @cindex canlock
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
220 When Message posts news messages, it inserts @code{Cancel-Lock}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
221 headers by default. This is a cryptographic header that ensures that
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 only you can cancel your own messages, which is nice. The downside
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223 is that if you lose your @file{.emacs} file (which is where Gnus
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224 stores the secret cancel lock password (which is generated
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 automatically the first time you use this feature)), you won't be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226 able to cancel your message. If you want to manage a password yourself,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227 you can put something like the following in your @file{~/.gnus.el} file:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 (setq canlock-password "geheimnis"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231 canlock-password-for-verify canlock-password)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 Whether to insert the header or not is controlled by the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235 @code{message-insert-canlock} variable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 Not many news servers respect the @code{Cancel-Lock} header yet, but
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238 this is expected to change in the future.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 @node Superseding
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 @section Superseding
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244 @findex message-supersede
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 The @code{message-supersede} command pops up a message buffer that will
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 supersede the message in the current buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248 @vindex message-ignored-supersedes-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249 Headers matching the @code{message-ignored-supersedes-headers} are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 removed before popping up the new message buffer. The default is@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251 @samp{^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252 ^Received:\\|^X-From-Line:\\|^X-Trace:\\|^X-Complaints-To:\\|@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 Return-Path:\\|^Supersedes:\\|^NNTP-Posting-Date:\\|^X-Trace:\\|@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 ^X-Complaints-To:\\|^Cancel-Lock:\\|^Cancel-Key:\\|^X-Hashcash:\\|@*
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
255 ^X-Payment:\\|^Approved:}.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 @node Forwarding
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 @section Forwarding
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 @findex message-forward
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 The @code{message-forward} command pops up a message buffer to forward
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264 the message in the current buffer. If given a prefix, forward using
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265 news.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268 @item message-forward-ignored-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
269 @vindex message-forward-ignored-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
270 All headers that match this regexp will be deleted when forwarding a message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
271
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272 @item message-make-forward-subject-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 @vindex message-make-forward-subject-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 A list of functions that are called to generate a subject header for
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275 forwarded messages. The subject generated by the previous function is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276 passed into each successive function.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278 The provided functions are:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 @item message-forward-subject-author-subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282 @findex message-forward-subject-author-subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283 Source of article (author or newsgroup), in brackets followed by the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 subject.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286 @item message-forward-subject-fwd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
287 Subject of article with @samp{Fwd:} prepended to it.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
288 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
289
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
290 @item message-wash-forwarded-subjects
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
291 @vindex message-wash-forwarded-subjects
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
292 If this variable is @code{t}, the subjects of forwarded messages have
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
293 the evidence of previous forwards (such as @samp{Fwd:}, @samp{Re:},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
294 @samp{(fwd)}) removed before the new subject is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
295 constructed. The default value is @code{nil}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
296
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
297 @item message-forward-as-mime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
298 @vindex message-forward-as-mime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
299 If this variable is @code{t} (the default), forwarded messages are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
300 included as inline @acronym{MIME} RFC822 parts. If it's @code{nil}, forwarded
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
301 messages will just be copied inline to the new message, like previous,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
302 non @acronym{MIME}-savvy versions of Gnus would do.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
303
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
304 @item message-forward-before-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
305 @vindex message-forward-before-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
306 If non-@code{nil}, put forwarded message before signature, else after.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
307
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
308 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
309
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
310
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
311 @node Resending
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
312 @section Resending
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
313
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
314 @findex message-resend
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
315 The @code{message-resend} command will prompt the user for an address
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
316 and resend the message in the current buffer to that address.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
317
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
318 @vindex message-ignored-resent-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
319 Headers that match the @code{message-ignored-resent-headers} regexp will
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
320 be removed before sending the message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
321
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
322
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
323 @node Bouncing
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
324 @section Bouncing
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
325
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
326 @findex message-bounce
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
327 The @code{message-bounce} command will, if the current buffer contains a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
328 bounced mail message, pop up a message buffer stripped of the bounce
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
329 information. A @dfn{bounced message} is typically a mail you've sent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
330 out that has been returned by some @code{mailer-daemon} as
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
331 undeliverable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
332
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
333 @vindex message-ignored-bounced-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
334 Headers that match the @code{message-ignored-bounced-headers} regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
335 will be removed before popping up the buffer. The default is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
336 @samp{^\\(Received\\|Return-Path\\|Delivered-To\\):}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
337
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
338
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
339 @node Mailing Lists
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
340 @section Mailing Lists
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
341
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
342 @cindex Mail-Followup-To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
343 Sometimes while posting to mailing lists, the poster needs to direct
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
344 followups to the post to specific places. The Mail-Followup-To (MFT)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
345 was created to enable just this. Three example scenarios where this is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
346 useful:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
347
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
348 @itemize @bullet
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
349 @item
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
350 A mailing list poster can use MFT to express that responses should be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
351 sent to just the list, and not the poster as well. This will happen
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
352 if the poster is already subscribed to the list.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
353
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
354 @item
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
355 A mailing list poster can use MFT to express that responses should be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
356 sent to the list and the poster as well. This will happen if the poster
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
357 is not subscribed to the list.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
358
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
359 @item
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
360 If a message is posted to several mailing lists, MFT may also be used
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
361 to direct the following discussion to one list only, because
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
362 discussions that are spread over several lists tend to be fragmented
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
363 and very difficult to follow.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
364
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
365 @end itemize
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
366
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
367 Gnus honors the MFT header in other's messages (i.e. while following
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
368 up to someone else's post) and also provides support for generating
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
369 sensible MFT headers for outgoing messages as well.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
370
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
371 @c @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
372 @c * Honoring an MFT post:: What to do when one already exists
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
373 @c * Composing with a MFT header:: Creating one from scratch.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
374 @c @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
375
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
376 @c @node Composing with a MFT header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
377 @subsection Composing a correct MFT header automagically
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
378
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
379 The first step in getting Gnus to automagically generate a MFT header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
380 in posts you make is to give Gnus a list of the mailing lists
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
381 addresses you are subscribed to. You can do this in more than one
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
382 way. The following variables would come in handy.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
383
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
384 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
385
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
386 @vindex message-subscribed-addresses
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
387 @item message-subscribed-addresses
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
388 This should be a list of addresses the user is subscribed to. Its
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
389 default value is @code{nil}. Example:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
390 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
391 (setq message-subscribed-addresses
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
392 '("ding@@gnus.org" "bing@@noose.org"))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
393 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
394
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
395 @vindex message-subscribed-regexps
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
396 @item message-subscribed-regexps
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
397 This should be a list of regexps denoting the addresses of mailing
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
398 lists subscribed to. Default value is @code{nil}. Example: If you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
399 want to achieve the same result as above:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
400 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
401 (setq message-subscribed-regexps
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
402 '("\\(ding@@gnus\\)\\|\\(bing@@noose\\)\\.org")
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
403 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
404
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
405 @vindex message-subscribed-address-functions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
406 @item message-subscribed-address-functions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
407 This can be a list of functions to be called (one at a time!!) to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
408 determine the value of MFT headers. It is advisable that these
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
409 functions not take any arguments. Default value is @code{nil}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
410
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
411 There is a pre-defined function in Gnus that is a good candidate for
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
412 this variable. @code{gnus-find-subscribed-addresses} is a function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
413 that returns a list of addresses corresponding to the groups that have
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
414 the @code{subscribed} (@pxref{Group Parameters, ,Group Parameters,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
415 gnus, The Gnus Manual}) group parameter set to a non-@code{nil} value.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
416 This is how you would do it.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
417
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
418 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
419 (setq message-subscribed-address-functions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
420 '(gnus-find-subscribed-addresses))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
421 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
422
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
423 @vindex message-subscribed-address-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
424 @item message-subscribed-address-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
425 You might be one organized human freak and have a list of addresses of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
426 all subscribed mailing lists in a separate file! Then you can just
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
427 set this variable to the name of the file and life would be good.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
428
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
429 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
430
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
431 You can use one or more of the above variables. All their values are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
432 ``added'' in some way that works :-)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
433
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
434 Now you are all set. Just start composing a message as you normally do.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
435 And just send it; as always. Just before the message is sent out, Gnus'
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
436 MFT generation thingy kicks in and checks if the message already has a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
437 MFT field. If there is one, it is left alone. (Except if it's empty -
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
438 in that case, the field is removed and is not replaced with an
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
439 automatically generated one. This lets you disable MFT generation on a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
440 per-message basis.) If there is none, then the list of recipient
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
441 addresses (in the To: and Cc: headers) is checked to see if one of them
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
442 is a list address you are subscribed to. If none of them is a list
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
443 address, then no MFT is generated; otherwise, a MFT is added to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
444 other headers and set to the value of all addresses in To: and Cc:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
445
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
446 @kindex C-c C-f C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
447 @findex message-generate-unsubscribed-mail-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
448 @kindex C-c C-f C-m
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
449 @findex message-goto-mail-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
450 Hm. ``So'', you ask, ``what if I send an email to a list I am not
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
451 subscribed to? I want my MFT to say that I want an extra copy.'' (This
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
452 is supposed to be interpreted by others the same way as if there were no
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
453 MFT, but you can use an explicit MFT to override someone else's
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
454 to-address group parameter.) The function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
455 @code{message-generate-unsubscribed-mail-followup-to} might come in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
456 handy. It is bound to @kbd{C-c C-f C-a} by default. In any case, you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
457 can insert a MFT of your own choice; @kbd{C-c C-f C-m}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
458 (@code{message-goto-mail-followup-to}) will help you get started.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
459
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
460 @c @node Honoring an MFT post
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
461 @subsection Honoring an MFT post
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
462
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
463 @vindex message-use-mail-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
464 When you followup to a post on a mailing list, and the post has a MFT
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
465 header, Gnus' action will depend on the value of the variable
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
466 @code{message-use-mail-followup-to}. This variable can be one of:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
467
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
468 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
469 @item use
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
470 Always honor MFTs. The To: and Cc: headers in your followup will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
471 derived from the MFT header of the original post. This is the default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
472
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
473 @item nil
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
474 Always dishonor MFTs (just ignore the darned thing)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
475
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
476 @item ask
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
477 Gnus will prompt you for an action.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
478
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
479 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
480
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
481 It is considered good netiquette to honor MFT, as it is assumed the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
482 fellow who posted a message knows where the followups need to go
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
483 better than you do.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
484
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
485 @node Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
486 @chapter Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
487
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
488 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
489 * Buffer Entry:: Commands after entering a Message buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
490 * Header Commands:: Commands for moving headers or changing headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
491 * Movement:: Moving around in message buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
492 * Insertion:: Inserting things into message buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
493 * MIME:: @acronym{MIME} considerations.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
494 * IDNA:: Non-@acronym{ASCII} domain name considerations.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
495 * Security:: Signing and encrypting messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
496 * Various Commands:: Various things.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
497 * Sending:: Actually sending the message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
498 * Mail Aliases:: How to use mail aliases.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
499 * Spelling:: Having Emacs check your spelling.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
500 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
501
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
502
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
503 @node Buffer Entry
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
504 @section Buffer Entry
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
505 @cindex undo
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
506 @kindex C-_
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
507
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
508 You most often end up in a Message buffer when responding to some other
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
509 message of some sort. Message does lots of handling of quoted text, and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
510 may remove signatures, reformat the text, or the like---depending on
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
511 which used settings you're using. Message usually gets things right,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
512 but sometimes it stumbles. To help the user unwind these stumblings,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
513 Message sets the undo boundary before each major automatic action it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
514 takes. If you press the undo key (usually located at @kbd{C-_}) a few
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
515 times, you will get back the un-edited message you're responding to.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
516
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
517
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
518 @node Header Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
519 @section Header Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
520
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
521 @subsection Commands for moving to headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
522
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
523 These following commands move to the header in question. If it doesn't
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
524 exist, it will be inserted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
525
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
526 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
527
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
528 @item C-c ?
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
529 @kindex C-c ?
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
530 @findex describe-mode
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
531 Describe the message mode.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
532
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
533 @item C-c C-f C-t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
534 @kindex C-c C-f C-t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
535 @findex message-goto-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
536 Go to the @code{To} header (@code{message-goto-to}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
537
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
538 @item C-c C-f C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
539 @kindex C-c C-f C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
540 @findex message-goto-from
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
541 Go to the @code{From} header (@code{message-goto-from}). (The ``o''
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
542 in the key binding is for Originator.)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
543
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
544 @item C-c C-f C-b
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
545 @kindex C-c C-f C-b
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
546 @findex message-goto-bcc
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
547 Go to the @code{Bcc} header (@code{message-goto-bcc}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
548
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
549 @item C-c C-f C-f
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
550 @kindex C-c C-f C-f
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
551 @findex message-goto-fcc
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
552 Go to the @code{Fcc} header (@code{message-goto-fcc}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
553
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
554 @item C-c C-f C-c
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
555 @kindex C-c C-f C-c
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
556 @findex message-goto-cc
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
557 Go to the @code{Cc} header (@code{message-goto-cc}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
558
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
559 @item C-c C-f C-s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
560 @kindex C-c C-f C-s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
561 @findex message-goto-subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
562 Go to the @code{Subject} header (@code{message-goto-subject}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
563
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
564 @item C-c C-f C-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
565 @kindex C-c C-f C-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
566 @findex message-goto-reply-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
567 Go to the @code{Reply-To} header (@code{message-goto-reply-to}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
568
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
569 @item C-c C-f C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
570 @kindex C-c C-f C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
571 @findex message-goto-newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
572 Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
573
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
574 @item C-c C-f C-d
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
575 @kindex C-c C-f C-d
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
576 @findex message-goto-distribution
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
577 Go to the @code{Distribution} header (@code{message-goto-distribution}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
578
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
579 @item C-c C-f C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
580 @kindex C-c C-f C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
581 @findex message-goto-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
582 Go to the @code{Followup-To} header (@code{message-goto-followup-to}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
583
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
584 @item C-c C-f C-k
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
585 @kindex C-c C-f C-k
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
586 @findex message-goto-keywords
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
587 Go to the @code{Keywords} header (@code{message-goto-keywords}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
588
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
589 @item C-c C-f C-u
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
590 @kindex C-c C-f C-u
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
591 @findex message-goto-summary
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
592 Go to the @code{Summary} header (@code{message-goto-summary}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
593
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
594 @item C-c C-f C-i
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
595 @kindex C-c C-f C-i
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
596 @findex message-insert-or-toggle-importance
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
597 This inserts the @samp{Importance:} header with a value of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
598 @samp{high}. This header is used to signal the importance of the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
599 message to the receiver. If the header is already present in the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
600 buffer, it cycles between the three valid values according to RFC
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
601 1376: @samp{low}, @samp{normal} and @samp{high}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
602
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
603 @item C-c C-f C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
604 @kindex C-c C-f C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
605 @findex message-generate-unsubscribed-mail-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
606 Insert a reasonable @samp{Mail-Followup-To:} header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
607 (@pxref{Mailing Lists}) in a post to an
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
608 unsubscribed list. When making original posts to a mailing list you are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
609 not subscribed to, you have to type in a @samp{Mail-Followup-To:} header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
610 by hand. The contents, usually, are the addresses of the list and your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
611 own address. This function inserts such a header automatically. It
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
612 fetches the contents of the @samp{To:} header in the current mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
613 buffer, and appends the current @code{user-mail-address}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
614
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
615 If the optional argument @code{include-cc} is non-@code{nil}, the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
616 addresses in the @samp{Cc:} header are also put into the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
617 @samp{Mail-Followup-To:} header.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
618
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
619 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
620
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
621 @subsection Commands to change headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
622
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
623 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
624
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
625 @item C-c C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
626 @kindex C-c C-o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
627 @findex message-sort-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
628 @vindex message-header-format-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
629 Sort headers according to @code{message-header-format-alist}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
630 (@code{message-sort-headers}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
631
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
632 @item C-c C-t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
633 @kindex C-c C-t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
634 @findex message-insert-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
635 Insert a @code{To} header that contains the @code{Reply-To} or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
636 @code{From} header of the message you're following up
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
637 (@code{message-insert-to}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
638
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
639 @item C-c C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
640 @kindex C-c C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
641 @findex message-insert-newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
642 Insert a @code{Newsgroups} header that reflects the @code{Followup-To}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
643 or @code{Newsgroups} header of the article you're replying to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
644 (@code{message-insert-newsgroups}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
645
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
646 @item C-c C-l
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
647 @kindex C-c C-l
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
648 @findex message-to-list-only
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
649 Send a message to the list only. Remove all addresses but the list
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
650 address from @code{To:} and @code{Cc:} headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
651
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
652 @item C-c M-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
653 @kindex C-c M-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
654 @findex message-insert-disposition-notification-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
655 Insert a request for a disposition
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
656 notification. (@code{message-insert-disposition-notification-to}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
657 This means that if the recipient support RFC 2298 she might send you a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
658 notification that she received the message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
659
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
660 @item M-x message-insert-importance-high
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
661 @kindex M-x message-insert-importance-high
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
662 @findex message-insert-importance-high
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
663 @cindex Importance
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
664 Insert an @samp{Importance} header with a value of @samp{high},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
665 deleting headers if necessary.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
666
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
667 @item M-x message-insert-importance-low
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
668 @kindex M-x message-insert-importance-low
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
669 @findex message-insert-importance-low
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
670 @cindex Importance
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
671 Insert an @samp{Importance} header with a value of @samp{low}, deleting
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
672 headers if necessary.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
673
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
674 @item C-c C-f s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
675 @kindex C-c C-f s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
676 @findex message-change-subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
677 @cindex Subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
678 Change the current @samp{Subject} header. Ask for new @samp{Subject}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
679 header and append @samp{(was: <Old Subject>)}. The old subject can be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
680 stripped on replying, see @code{message-subject-trailing-was-query}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
681 (@pxref{Message Headers}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
682
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
683 @item C-c C-f x
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
684 @kindex C-c C-f x
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
685 @findex message-cross-post-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
686 @vindex message-cross-post-default
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
687 @vindex message-cross-post-note-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
688 @cindex X-Post
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
689 @cindex cross-post
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
690 Set up the @samp{FollowUp-To} header with a target newsgroup for a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
691 cross-post, add that target newsgroup to the @samp{Newsgroups} header if
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
692 it is not a member of @samp{Newsgroups}, and insert a note in the body.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
693 If @code{message-cross-post-default} is @code{nil} or if this command is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
694 called with a prefix-argument, only the @samp{FollowUp-To} header will
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
695 be set but the target newsgroup will not be added to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
696 @samp{Newsgroups} header. The function to insert a note is controlled
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
697 by the @code{message-cross-post-note-function} variable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
698
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
699 @item C-c C-f t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
700 @kindex C-c C-f t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
701 @findex message-reduce-to-to-cc
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
702 Replace contents of @samp{To} header with contents of @samp{Cc} or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
703 @samp{Bcc} header. (Iff @samp{Cc} header is not present, @samp{Bcc}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
704 header will be used instead.)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
705
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
706 @item C-c C-f w
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
707 @kindex C-c C-f w
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
708 @findex message-insert-wide-reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
709 Insert @samp{To} and @samp{Cc} headers as if you were doing a wide
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
710 reply even if the message was not made for a wide reply first.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
711
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
712 @item C-c C-f a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
713 @kindex C-c C-f a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
714 @findex message-add-archive-header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
715 @vindex message-archive-header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
716 @vindex message-archive-note
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
717 @cindex X-No-Archive
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
718 Insert @samp{X-No-Archive: Yes} in the header and a note in the body.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
719 The header and the note can be customized using
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
720 @code{message-archive-header} and @code{message-archive-note}. When
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
721 called with a prefix argument, ask for a text to insert. If you don't
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
722 want the note in the body, set @code{message-archive-note} to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
723 @code{nil}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
724
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
725 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
726
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
727
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
728 @node Movement
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
729 @section Movement
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
730
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
731 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
732 @item C-c C-b
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
733 @kindex C-c C-b
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
734 @findex message-goto-body
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
735 Move to the beginning of the body of the message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
736 (@code{message-goto-body}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
737
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
738 @item C-c C-i
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
739 @kindex C-c C-i
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
740 @findex message-goto-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
741 Move to the signature of the message (@code{message-goto-signature}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
742
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
743 @item C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
744 @kindex C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
745 @findex message-beginning-of-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
746 @vindex message-beginning-of-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
747 If at beginning of header value, go to beginning of line, else go to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
748 beginning of header value. (The header value comes after the header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
749 name and the colon.) This behavior can be disabled by toggling
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
750 the variable @code{message-beginning-of-line}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
751
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
752 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
753
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
754
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
755 @node Insertion
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
756 @section Insertion
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
757
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
758 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
759
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
760 @item C-c C-y
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
761 @kindex C-c C-y
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
762 @findex message-yank-original
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
763 Yank the message that's being replied to into the message buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
764 (@code{message-yank-original}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
765
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
766 @item C-c C-M-y
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
767 @kindex C-c C-M-y
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
768 @findex message-yank-buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
769 Prompt for a buffer name and yank the contents of that buffer into the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
770 message buffer (@code{message-yank-buffer}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
771
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
772 @item C-c C-q
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
773 @kindex C-c C-q
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
774 @findex message-fill-yanked-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
775 Fill the yanked message (@code{message-fill-yanked-message}). Warning:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
776 Can severely mess up the yanked text if its quoting conventions are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
777 strange. You'll quickly get a feel for when it's safe, though. Anyway,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
778 just remember that @kbd{C-x u} (@code{undo}) is available and you'll be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
779 all right.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
780
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
781 @item C-c C-w
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
782 @kindex C-c C-w
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
783 @findex message-insert-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
784 Insert a signature at the end of the buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
785 (@code{message-insert-signature}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
786
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
787 @item C-c M-h
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
788 @kindex C-c M-h
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
789 @findex message-insert-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
790 Insert the message headers (@code{message-insert-headers}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
791
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
792 @item C-c M-m
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
793 @kindex C-c M-m
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
794 @findex message-mark-inserted-region
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
795 Mark some region in the current article with enclosing tags. See
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
796 @code{message-mark-insert-begin} and @code{message-mark-insert-end}.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
797 When called with a prefix argument, use slrn style verbatim marks
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
798 (@samp{#v+} and @samp{#v-}).
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
799
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
800 @item C-c M-f
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
801 @kindex C-c M-f
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
802 @findex message-mark-insert-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
803 Insert a file in the current article with enclosing tags.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
804 See @code{message-mark-insert-begin} and @code{message-mark-insert-end}.
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
805 When called with a prefix argument, use slrn style verbatim marks
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
806 (@samp{#v+} and @samp{#v-}).
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
807
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
808 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
809
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
810
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
811 @node MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
812 @section MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
813 @cindex MML
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
814 @cindex MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
815 @cindex multipart
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
816 @cindex attachment
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
817
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
818 Message is a @acronym{MIME}-compliant posting agent. The user generally
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
819 doesn't have to do anything to make the @acronym{MIME} happen---Message will
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
820 automatically add the @code{Content-Type} and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
821 @code{Content-Transfer-Encoding} headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
822
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
823 @findex mml-attach-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
824 @kindex C-c C-a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
825 The most typical thing users want to use the multipart things in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
826 @acronym{MIME} for is to add ``attachments'' to mail they send out.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
827 This can be done with the @kbd{C-c C-a} command (@kbd{M-x mml-attach-file}),
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
828 which will prompt for a file name and a @acronym{MIME} type.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
829
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
830 @vindex mml-dnd-protocol-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
831 @vindex mml-dnd-attach-options
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
832 If your Emacs supports drag and drop, you can also drop the file in the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
833 Message buffer. The variable @code{mml-dnd-protocol-alist} specifies
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
834 what kind of action is done when you drop a file into the Message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
835 buffer. The variable @code{mml-dnd-attach-options} controls which
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
836 @acronym{MIME} options you want to specify when dropping a file. If it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
837 is a list, valid members are @code{type}, @code{description} and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
838 @code{disposition}. @code{disposition} implies @code{type}. If it is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
839 @code{nil}, don't ask for options. If it is @code{t}, ask the user
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
840 whether or not to specify options.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
841
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
842 You can also create arbitrarily complex multiparts using the @acronym{MML}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
843 language (@pxref{Composing, , Composing, emacs-mime, The Emacs MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
844 Manual}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
845
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
846 @node IDNA
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
847 @section IDNA
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
848 @cindex IDNA
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
849 @cindex internationalized domain names
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
850 @cindex non-ascii domain names
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
851
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
852 Message is a @acronym{IDNA}-compliant posting agent. The user
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
853 generally doesn't have to do anything to make the @acronym{IDNA}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
854 happen---Message will encode non-@acronym{ASCII} domain names in @code{From},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
855 @code{To}, and @code{Cc} headers automatically.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
856
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
857 Until @acronym{IDNA} becomes more well known, Message queries you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
858 whether @acronym{IDNA} encoding of the domain name really should
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
859 occur. Some users might not be aware that domain names can contain
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
860 non-@acronym{ASCII} now, so this gives them a safety net if they accidently
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
861 typed a non-@acronym{ASCII} domain name.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
862
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
863 @vindex message-use-idna
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
864 The @code{message-use-idna} variable control whether @acronym{IDNA} is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
865 used. If the variable is @code{nil} no @acronym{IDNA} encoding will
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
866 ever happen, if it is set to the symbol @code{ask} the user will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
867 queried, and if set to @code{t} (which is the default if @acronym{IDNA}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
868 is fully available) @acronym{IDNA} encoding happens automatically.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
869
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
870 @findex message-idna-to-ascii-rhs
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
871 If you want to experiment with the @acronym{IDNA} encoding, you can
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
872 invoke @kbd{M-x message-idna-to-ascii-rhs RET} in the message buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
873 to have the non-@acronym{ASCII} domain names encoded while you edit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
874 the message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
875
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
876 Note that you must have @uref{http://www.gnu.org/software/libidn/, GNU
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
877 Libidn} installed in order to use this functionality.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
878
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
879 @node Security
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
880 @section Security
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
881 @cindex Security
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
882 @cindex S/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
883 @cindex PGP
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
884 @cindex PGP/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
885 @cindex sign
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
886 @cindex encrypt
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
887 @cindex secure
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
888
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
889 Using the @acronym{MML} language, Message is able to create digitally
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
890 signed and digitally encrypted messages. Message (or rather
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
891 @acronym{MML}) currently support @acronym{PGP} (RFC 1991),
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
892 @acronym{PGP/MIME} (RFC 2015/3156) and @acronym{S/MIME}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
893
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
894 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
895 * Signing and encryption:: Signing and encrypting commands.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
896 * Using S/MIME:: Using S/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
897 * Using PGP/MIME:: Using PGP/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
898 * PGP Compatibility:: Compatibility with older implementations
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
899 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
900
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
901 @node Signing and encryption
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
902 @subsection Signing and encrypting commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
903
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
904 Instructing @acronym{MML} to perform security operations on a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
905 @acronym{MIME} part is done using the @kbd{C-c C-m s} key map for
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
906 signing and the @kbd{C-c C-m c} key map for encryption, as follows.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
907 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
908
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
909 @item C-c C-m s s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
910 @kindex C-c C-m s s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
911 @findex mml-secure-message-sign-smime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
912
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
913 Digitally sign current message using @acronym{S/MIME}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
914
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
915 @item C-c C-m s o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
916 @kindex C-c C-m s o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
917 @findex mml-secure-message-sign-pgp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
918
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
919 Digitally sign current message using @acronym{PGP}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
920
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
921 @item C-c C-m s p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
922 @kindex C-c C-m s p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
923 @findex mml-secure-message-sign-pgpmime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
924
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
925 Digitally sign current message using @acronym{PGP/MIME}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
926
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
927 @item C-c C-m c s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
928 @kindex C-c C-m c s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
929 @findex mml-secure-message-encrypt-smime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
930
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
931 Digitally encrypt current message using @acronym{S/MIME}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
932
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
933 @item C-c C-m c o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
934 @kindex C-c C-m c o
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
935 @findex mml-secure-message-encrypt-pgp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
936
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
937 Digitally encrypt current message using @acronym{PGP}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
938
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
939 @item C-c C-m c p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
940 @kindex C-c C-m c p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
941 @findex mml-secure-message-encrypt-pgpmime
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
942
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
943 Digitally encrypt current message using @acronym{PGP/MIME}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
944
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
945 @item C-c C-m C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
946 @kindex C-c C-m C-n
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
947 @findex mml-unsecure-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
948 Remove security related @acronym{MML} tags from message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
949
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
950 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
951
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
952 These commands do not immediately sign or encrypt the message, they
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
953 merely insert the proper @acronym{MML} secure tag to instruct the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
954 @acronym{MML} engine to perform that operation when the message is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
955 actually sent. They may perform other operations too, such as locating
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
956 and retrieving a @acronym{S/MIME} certificate of the person you wish to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
957 send encrypted mail to. When the mml parsing engine converts your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
958 @acronym{MML} into a properly encoded @acronym{MIME} message, the secure
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
959 tag will be replaced with either a part or a multipart tag. If your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
960 message contains other mml parts, a multipart tag will be used; if no
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
961 other parts are present in your message a single part tag will be used.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
962 This way, message mode will do the Right Thing (TM) with
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
963 signed/encrypted multipart messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
964
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
965 Since signing and especially encryption often is used when sensitive
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
966 information is sent, you may want to have some way to ensure that your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
967 mail is actually signed or encrypted. After invoking the above
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
968 sign/encrypt commands, it is possible to preview the raw article by
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
969 using @kbd{C-u C-c RET P} (@code{mml-preview}). Then you can
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
970 verify that your long rant about what your ex-significant other or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
971 whomever actually did with that funny looking person at that strange
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
972 party the other night, actually will be sent encrypted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
973
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
974 @emph{Note!} Neither @acronym{PGP/MIME} nor @acronym{S/MIME} encrypt/signs
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
975 RFC822 headers. They only operate on the @acronym{MIME} object. Keep this
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
976 in mind before sending mail with a sensitive Subject line.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
977
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
978 By default, when encrypting a message, Gnus will use the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
979 ``signencrypt'' mode, which means the message is both signed and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
980 encrypted. If you would like to disable this for a particular
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
981 message, give the @code{mml-secure-message-encrypt-*} command a prefix
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
982 argument, e.g., @kbd{C-u C-c C-m c p}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
983
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
984 Actually using the security commands above is not very difficult. At
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
985 least not compared with making sure all involved programs talk with each
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
986 other properly. Thus, we now describe what external libraries or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
987 programs are required to make things work, and some small general hints.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
988
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
989 @node Using S/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
990 @subsection Using S/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
991
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
992 @emph{Note!} This section assume you have a basic familiarity with
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
993 modern cryptography, @acronym{S/MIME}, various PKCS standards, OpenSSL and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
994 so on.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
995
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
996 The @acronym{S/MIME} support in Message (and @acronym{MML}) require
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
997 OpenSSL. OpenSSL performs the actual @acronym{S/MIME} sign/encrypt
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
998 operations. OpenSSL can be found at @uref{http://www.openssl.org/}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
999 OpenSSL 0.9.6 and later should work. Version 0.9.5a cannot extract mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1000 addresses from certificates, and it insert a spurious CR character into
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1001 @acronym{MIME} separators so you may wish to avoid it if you would like
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1002 to avoid being regarded as someone who send strange mail. (Although by
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1003 sending @acronym{S/MIME} messages you've probably already lost that
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1004 contest.)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1005
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1006 To be able to send encrypted mail, a personal certificate is not
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1007 required. Message (@acronym{MML}) need a certificate for the person to whom you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1008 wish to communicate with though. You're asked for this when you type
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1009 @kbd{C-c C-m c s}. Currently there are two ways to retrieve this
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1010 certificate, from a local file or from DNS. If you chose a local
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1011 file, it need to contain a X.509 certificate in @acronym{PEM} format.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1012 If you chose DNS, you're asked for the domain name where the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1013 certificate is stored, the default is a good guess. To my belief,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1014 Message (@acronym{MML}) is the first mail agent in the world to support
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1015 retrieving @acronym{S/MIME} certificates from DNS, so you're not
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1016 likely to find very many certificates out there. At least there
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1017 should be one, stored at the domain @code{simon.josefsson.org}. LDAP
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1018 is a more popular method of distributing certificates, support for it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1019 is planned. (Meanwhile, you can use @code{ldapsearch} from the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1020 command line to retrieve a certificate into a file and use it.)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1021
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1022 As for signing messages, OpenSSL can't perform signing operations
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1023 without some kind of configuration. Especially, you need to tell it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1024 where your private key and your certificate is stored. @acronym{MML}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1025 uses an Emacs interface to OpenSSL, aptly named @code{smime.el}, and it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1026 contain a @code{custom} group used for this configuration. So, try
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1027 @kbd{M-x customize-group RET smime RET} and look around.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1028
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1029 Currently there is no support for talking to a CA (or RA) to create
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1030 your own certificate. None is planned either. You need to do this
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1031 manually with OpenSSL or using some other program. I used Netscape
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1032 and got a free @acronym{S/MIME} certificate from one of the big CA's on the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1033 net. Netscape is able to export your private key and certificate in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1034 PKCS #12 format. Use OpenSSL to convert this into a plain X.509
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1035 certificate in PEM format as follows.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1036
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1037 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1038 $ openssl pkcs12 -in ns.p12 -clcerts -nodes > key+cert.pem
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1039 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1040
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1041 The @file{key+cert.pem} file should be pointed to from the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1042 @code{smime-keys} variable. You should now be able to send signed mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1043
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1044 @emph{Note!} Your private key is now stored unencrypted in the file,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1045 so take care in handling it. Storing encrypted keys on the disk are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1046 supported, and Gnus will ask you for a passphrase before invoking
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1047 OpenSSL. Read the OpenSSL documentation for how to achieve this. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1048 you use unencrypted keys (e.g., if they are on a secure storage, or if
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1049 you are on a secure single user machine) simply press @code{RET} at
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1050 the passphrase prompt.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1051
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1052 @node Using PGP/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1053 @subsection Using PGP/MIME
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1054
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1055 @acronym{PGP/MIME} requires an external OpenPGP implementation, such
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1056 as @uref{http://www.gnupg.org/, GNU Privacy Guard}. Pre-OpenPGP
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1057 implementations such as PGP 2.x and PGP 5.x are also supported. One
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1058 Emacs interface to the PGP implementations, PGG (@pxref{Top, ,PGG,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1059 pgg, PGG Manual}), is included, but Mailcrypt and Florian Weimer's
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1060 @code{gpg.el} are also supported. @xref{PGP Compatibility}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1061
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1062 @cindex gpg-agent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1063 Message internally calls GnuPG (the @command{gpg} command) to perform
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1064 data encryption, and in certain cases (decrypting or signing for
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1065 example), @command{gpg} requires user's passphrase. Currently the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1066 recommended way to supply your passphrase to @command{gpg} is to use the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1067 @command{gpg-agent} program.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1068
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1069 To use @command{gpg-agent} in Emacs, you need to run the following
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1070 command from the shell before starting Emacs.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1071
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1072 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1073 eval `gpg-agent --daemon`
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1074 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1075
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1076 This will invoke @command{gpg-agent} and set the environment variable
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1077 @code{GPG_AGENT_INFO} to allow @command{gpg} to communicate with it.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1078 It might be good idea to put this command in your @file{.xsession} or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1079 @file{.bash_profile}. @xref{Invoking GPG-AGENT, , , gnupg, Using the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1080 GNU Privacy Guard}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1081
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1082 Once your @command{gpg-agent} is set up, it will ask you for a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1083 passphrase as needed for @command{gpg}. Under the X Window System,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1084 you will see a new passphrase input dialog appear. The dialog is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1085 provided by PIN Entry (the @command{pinentry} command), and as of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1086 version 0.7.2, @command{pinentry} cannot cooperate with Emacs on a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1087 single tty. So, if you are using a text console, you may need to put
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1088 a passphrase into gpg-agent's cache beforehand. The following command
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1089 does the trick.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1090
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1091 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1092 gpg --use-agent --sign < /dev/null > /dev/null
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1093 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1094
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1095 The Lisp variable @code{pgg-gpg-use-agent} controls whether to use
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1096 @command{gpg-agent}. See also @xref{Caching passphrase, , , pgg, The
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1097 PGG Manual}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1098
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1099
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1100 @node PGP Compatibility
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1101 @subsection Compatibility with older implementations
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1102
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1103 @vindex gpg-temp-directory
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1104 Note, if you are using the @code{gpg.el} you must make sure that the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1105 directory specified by @code{gpg-temp-directory} have permissions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1106 0700.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1107
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1108 Creating your own key is described in detail in the documentation of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1109 your PGP implementation, so we refer to it.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1110
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1111 If you have imported your old PGP 2.x key into GnuPG, and want to send
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1112 signed and encrypted messages to your fellow PGP 2.x users, you'll
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1113 discover that the receiver cannot understand what you send. One
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1114 solution is to use PGP 2.x instead (i.e., if you use @code{pgg}, set
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1115 @code{pgg-default-scheme} to @code{pgp}). If you do want to use
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1116 GnuPG, you can use a compatibility script called @code{gpg-2comp}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1117 available from
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1118 @uref{http://muppet.faveve.uni-stuttgart.de/~gero/gpg-2comp/}. You
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1119 could also convince your fellow PGP 2.x users to convert to GnuPG.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1120 @vindex mml-signencrypt-style-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1121 As a final workaround, you can make the sign and encryption work in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1122 two steps; separately sign, then encrypt a message. If you would like
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1123 to change this behavior you can customize the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1124 @code{mml-signencrypt-style-alist} variable. For example:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1125
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1126 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1127 (setq mml-signencrypt-style-alist '(("smime" separate)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1128 ("pgp" separate)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1129 ("pgpauto" separate)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1130 ("pgpmime" separate)))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1131 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1132
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1133 This causes to sign and encrypt in two passes, thus generating a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1134 message that can be understood by PGP version 2.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1135
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1136 (Refer to @uref{http://www.gnupg.org/gph/en/pgp2x.html} for more
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1137 information about the problem.)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1138
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1139 @node Various Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1140 @section Various Commands
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1141
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1142 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1143
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1144 @item C-c C-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1145 @kindex C-c C-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1146 @findex message-caesar-buffer-body
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1147 Caesar rotate (aka. rot13) the current message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1148 (@code{message-caesar-buffer-body}). If narrowing is in effect, just
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1149 rotate the visible portion of the buffer. A numerical prefix says how
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1150 many places to rotate the text. The default is 13.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1151
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1152 @item C-c C-e
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1153 @kindex C-c C-e
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1154 @findex message-elide-region
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1155 @vindex message-elide-ellipsis
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1156 Elide the text between point and mark (@code{message-elide-region}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1157 The text is killed and replaced with the contents of the variable
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1158 @code{message-elide-ellipsis}. The default value is to use an ellipsis
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1159 (@samp{[...]}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1160
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1161 @item C-c M-k
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1162 @kindex C-c M-k
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1163 @findex message-kill-address
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1164 Kill the address under point.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1165
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1166 @item C-c C-z
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1167 @kindex C-c C-z
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1168 @findex message-kill-to-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1169 Kill all the text up to the signature, or if that's missing, up to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1170 end of the message (@code{message-kill-to-signature}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1171
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1172 @item C-c C-v
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1173 @kindex C-c C-v
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1174 @findex message-delete-not-region
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1175 Delete all text in the body of the message that is outside the region
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1176 (@code{message-delete-not-region}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1177
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1178 @item M-RET
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1179 @kindex M-RET
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1180 @findex message-newline-and-reformat
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1181 Insert four newlines, and then reformat if inside quoted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1182
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1183 Here's an example:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1184
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1185 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1186 > This is some quoted text. And here's more quoted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1187 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1188
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1189 If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1190
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1191 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1192 > This is some quoted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1193
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1194 *
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1195
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1196 > And here's more quoted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1197 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1198
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1199 @samp{*} says where point will be placed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1200
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1201 @item C-c M-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1202 @kindex C-c M-r
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1203 @findex message-rename-buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1204 Rename the buffer (@code{message-rename-buffer}). If given a prefix,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1205 prompt for a new buffer name.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1206
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1207 @item TAB
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1208 @kindex TAB
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1209 @findex message-tab
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1210 @vindex message-tab-body-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1211 If @code{message-tab-body-function} is non-@code{nil}, execute the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1212 function it specifies. Otherwise use the function bound to @kbd{TAB} in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1213 @code{text-mode-map} or @code{global-map}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1214
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1215 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1216
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1217
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1218 @node Sending
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1219 @section Sending
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1220
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1221 @table @kbd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1222 @item C-c C-c
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1223 @kindex C-c C-c
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1224 @findex message-send-and-exit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1225 Send the message and bury the current buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1226 (@code{message-send-and-exit}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1227
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1228 @item C-c C-s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1229 @kindex C-c C-s
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1230 @findex message-send
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1231 Send the message (@code{message-send}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1232
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1233 @item C-c C-d
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1234 @kindex C-c C-d
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1235 @findex message-dont-send
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1236 Bury the message buffer and exit (@code{message-dont-send}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1237
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1238 @item C-c C-k
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1239 @kindex C-c C-k
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1240 @findex message-kill-buffer
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1241 Kill the message buffer and exit (@code{message-kill-buffer}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1242
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1243 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1244
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1245
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1246
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1247 @node Mail Aliases
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1248 @section Mail Aliases
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1249 @cindex mail aliases
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1250 @cindex aliases
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1251 @cindex completion
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1252 @cindex ecomplete
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1253
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1254 @vindex message-mail-alias-type
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1255 The @code{message-mail-alias-type} variable controls what type of mail
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1256 alias expansion to use. Currently two forms are supported:
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1257 @code{mailabbrev} and @code{ecomplete}. If this variable is
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1258 @code{nil}, no mail alias expansion will be performed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1259
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1260 @code{mailabbrev} works by parsing the @file{/etc/mailrc} and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1261 @file{~/.mailrc} files. These files look like:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1262
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1263 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1264 alias lmi "Lars Magne Ingebrigtsen <larsi@@ifi.uio.no>"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1265 alias ding "ding@@ifi.uio.no (ding mailing list)"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1266 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1267
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1268 After adding lines like this to your @file{~/.mailrc} file, you should
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1269 be able to just write @samp{lmi} in the @code{To} or @code{Cc} (and so
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1270 on) headers and press @kbd{SPC} to expand the alias.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1271
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1272 No expansion will be performed upon sending of the message---all
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1273 expansions have to be done explicitly.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1274
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1275 If you're using @code{ecomplete}, all addresses from @code{To} and
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1276 @code{Cc} headers will automatically be put into the
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1277 @file{~/.ecompleterc} file. When you enter text in the @code{To} and
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1278 @code{Cc} headers, @code{ecomplete} will check out the values stored
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1279 there and ``electrically'' say what completions are possible. To
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1280 choose one of these completions, use the @kbd{M-n} command to move
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1281 down to the list. Use @kbd{M-n} and @kbd{M-p} to move down and up the
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1282 list, and @kbd{RET} to choose a completion.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1283
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1284 @node Spelling
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1285 @section Spelling
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1286 @cindex spelling
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1287 @findex ispell-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1288
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1289 There are two popular ways to have Emacs spell-check your messages:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1290 @code{ispell} and @code{flyspell}. @code{ispell} is the older and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1291 probably more popular package. You typically first write the message,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1292 and then run the entire thing through @code{ispell} and fix all the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1293 typos. To have this happen automatically when you send a message, put
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1294 something like the following in your @file{.emacs} file:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1295
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1296 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1297 (add-hook 'message-send-hook 'ispell-message)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1298 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1299
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1300 @vindex ispell-message-dictionary-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1301 If you're in the habit of writing in different languages, this can be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1302 controlled by the @code{ispell-message-dictionary-alist} variable:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1303
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1304 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1305 (setq ispell-message-dictionary-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1306 '(("^Newsgroups:.*\\bde\\." . "deutsch8")
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1307 (".*" . "default")))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1308 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1309
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1310 @code{ispell} depends on having the external @samp{ispell} command
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1311 installed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1312
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1313 The other popular method is using @code{flyspell}. This package checks
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1314 your spelling while you're writing, and marks any mis-spelled words in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1315 various ways.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1316
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1317 To use @code{flyspell}, put something like the following in your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1318 @file{.emacs} file:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1319
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1320 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1321 (defun my-message-setup-routine ()
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1322 (flyspell-mode 1))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1323 (add-hook 'message-setup-hook 'my-message-setup-routine)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1324 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1325
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1326 @code{flyspell} depends on having the external @samp{ispell} command
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1327 installed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1328
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1329
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1330 @node Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1331 @chapter Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1332
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1333 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1334 * Message Headers:: General message header stuff.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1335 * Mail Headers:: Customizing mail headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1336 * Mail Variables:: Other mail variables.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1337 * News Headers:: Customizing news headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1338 * News Variables:: Other news variables.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1339 * Insertion Variables:: Customizing how things are inserted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1340 * Various Message Variables:: Other message variables.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1341 * Sending Variables:: Variables for sending.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1342 * Message Buffers:: How Message names its buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1343 * Message Actions:: Actions to be performed when exiting.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1344 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1345
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1346
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1347 @node Message Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1348 @section Message Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1349
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1350 Message is quite aggressive on the message generation front. It has to
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1351 be---it's a combined news and mail agent. To be able to send combined
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1352 messages, it has to generate all headers itself (instead of letting the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1353 mail/news system do it) to ensure that mail and news copies of messages
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1354 look sufficiently similar.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1355
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1356 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1357
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1358 @item message-generate-headers-first
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1359 @vindex message-generate-headers-first
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1360 If @code{t}, generate all required headers before starting to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1361 compose the message. This can also be a list of headers to generate:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1362
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1363 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1364 (setq message-generate-headers-first
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1365 '(References))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1366 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1367
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1368 @vindex message-required-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1369 The variables @code{message-required-headers},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1370 @code{message-required-mail-headers} and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1371 @code{message-required-news-headers} specify which headers are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1372 required.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1373
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1374 Note that some headers will be removed and re-generated before posting,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1375 because of the variable @code{message-deletable-headers} (see below).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1376
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1377 @item message-draft-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1378 @vindex message-draft-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1379 When running Message from Gnus, the message buffers are associated
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1380 with a draft group. @code{message-draft-headers} says which headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1381 should be generated when a draft is written to the draft group.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1382
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1383 @item message-from-style
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1384 @vindex message-from-style
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1385 Specifies how @code{From} headers should look. There are four valid
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1386 values:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1387
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1388 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1389 @item nil
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1390 Just the address---@samp{king@@grassland.com}.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1391
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1392 @item parens
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1393 @samp{king@@grassland.com (Elvis Parsley)}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1394
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1395 @item angles
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1396 @samp{Elvis Parsley <king@@grassland.com>}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1397
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1398 @item default
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1399 Look like @code{angles} if that doesn't require quoting, and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1400 @code{parens} if it does. If even @code{parens} requires quoting, use
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1401 @code{angles} anyway.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1402
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1403 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1404
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1405 @item message-deletable-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1406 @vindex message-deletable-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1407 Headers in this list that were previously generated by Message will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1408 deleted before posting. Let's say you post an article. Then you decide
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1409 to post it again to some other group, you naughty boy, so you jump back
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1410 to the @code{*post-buf*} buffer, edit the @code{Newsgroups} line, and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1411 ship it off again. By default, this variable makes sure that the old
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1412 generated @code{Message-ID} is deleted, and a new one generated. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1413 this isn't done, the entire empire would probably crumble, anarchy would
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1414 prevail, and cats would start walking on two legs and rule the world.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1415 Allegedly.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1416
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1417 @item message-default-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1418 @vindex message-default-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1419 This string is inserted at the end of the headers in all message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1420 buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1421
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1422 @item message-subject-re-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1423 @vindex message-subject-re-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1424 @cindex Aw
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1425 @cindex Sv
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1426 @cindex Re
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1427 Responses to messages have subjects that start with @samp{Re: }. This
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1428 is @emph{not} an abbreviation of the English word ``response'', but is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1429 Latin, and means ``in response to''. Some illiterate nincompoops have
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1430 failed to grasp this fact, and have ``internationalized'' their software
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1431 to use abominations like @samp{Aw: } (``antwort'') or @samp{Sv: }
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1432 (``svar'') instead, which is meaningless and evil. However, you may
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1433 have to deal with users that use these evil tools, in which case you may
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1434 set this variable to a regexp that matches these prefixes. Myself, I
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1435 just throw away non-compliant mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1436
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1437 Here's an example of a value to deal with these headers when
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1438 responding to a message:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1439
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1440 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1441 (setq message-subject-re-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1442 (concat
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1443 "^[ \t]*"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1444 "\\("
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1445 "\\("
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1446 "[Aa][Nn][Tt][Ww]\\.?\\|" ; antw
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1447 "[Aa][Ww]\\|" ; aw
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1448 "[Ff][Ww][Dd]?\\|" ; fwd
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1449 "[Oo][Dd][Pp]\\|" ; odp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1450 "[Rr][Ee]\\|" ; re
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1451 "[Rr][\311\351][Ff]\\.?\\|" ; ref
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1452 "[Ss][Vv]" ; sv
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1453 "\\)"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1454 "\\(\\[[0-9]*\\]\\)"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1455 "*:[ \t]*"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1456 "\\)"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1457 "*[ \t]*"
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1458 ))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1459 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1460
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1461 @item message-subject-trailing-was-query
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1462 @vindex message-subject-trailing-was-query
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1463 @vindex message-subject-trailing-was-ask-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1464 @vindex message-subject-trailing-was-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1465 Controls what to do with trailing @samp{(was: <old subject>)} in subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1466 lines. If @code{nil}, leave the subject unchanged. If it is the symbol
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1467 @code{ask}, query the user what to do. In this case, the subject is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1468 matched against @code{message-subject-trailing-was-ask-regexp}. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1469 @code{message-subject-trailing-was-query} is @code{t}, always strip the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1470 trailing old subject. In this case,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1471 @code{message-subject-trailing-was-regexp} is used.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1472
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1473 @item message-alternative-emails
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1474 @vindex message-alternative-emails
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1475 Regexp matching alternative email addresses. The first address in the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1476 To, Cc or From headers of the original article matching this variable is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1477 used as the From field of outgoing messages, replacing the default From
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1478 value.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1479
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1480 For example, if you have two secondary email addresses john@@home.net
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1481 and john.doe@@work.com and want to use them in the From field when
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1482 composing a reply to a message addressed to one of them, you could set
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1483 this variable like this:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1484
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1485 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1486 (setq message-alternative-emails
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1487 (regexp-opt '("john@@home.net" "john.doe@@work.com")))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1488 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1489
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1490 This variable has precedence over posting styles and anything that runs
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1491 off @code{message-setup-hook}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1492
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1493 @item message-allow-no-recipients
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1494 @vindex message-allow-no-recipients
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1495 Specifies what to do when there are no recipients other than
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1496 @code{Gcc} or @code{Fcc}. If it is @code{always}, the posting is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1497 allowed. If it is @code{never}, the posting is not allowed. If it is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1498 @code{ask} (the default), you are prompted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1499
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1500 @item message-hidden-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1501 @vindex message-hidden-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1502 A regexp, a list of regexps, or a list where the first element is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1503 @code{not} and the rest are regexps. It says which headers to keep
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1504 hidden when composing a message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1505
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1506 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1507 (setq message-hidden-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1508 '(not "From" "Subject" "To" "Cc" "Newsgroups"))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1509 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1510
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1511 Headers are hidden using narrowing, you can use @kbd{M-x widen} to
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1512 expose them in the buffer.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1513
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1514 @item message-header-synonyms
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1515 @vindex message-header-synonyms
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1516 A list of lists of header synonyms. E.g., if this list contains a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1517 member list with elements @code{Cc} and @code{To}, then
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1518 @code{message-carefully-insert-headers} will not insert a @code{To}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1519 header when the message is already @code{Cc}ed to the recipient.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1520
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1521 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1522
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1523
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1524 @node Mail Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1525 @section Mail Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1526
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1527 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1528 @item message-required-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1529 @vindex message-required-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1530 @xref{News Headers}, for the syntax of this variable. It is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1531 @code{(From Subject Date (optional . In-Reply-To) Message-ID
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1532 (optional . User-Agent))} by default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1533
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1534 @item message-ignored-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1535 @vindex message-ignored-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1536 Regexp of headers to be removed before mailing. The default is@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1537 @samp{^[GF]cc:\\|^Resent-Fcc:\\|^Xref:\\|^X-Draft-From:\\|@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1538 ^X-Gnus-Agent-Meta-Information:}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1539
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1540 @item message-default-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1541 @vindex message-default-mail-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1542 This string is inserted at the end of the headers in all message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1543 buffers that are initialized as mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1544
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1545 @item message-generate-hashcash
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1546 @vindex message-generate-hashcash
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1547 Variable that indicates whether @samp{X-Hashcash} headers
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1548 should be computed for the message. @xref{Hashcash, ,Hashcash,gnus,
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1549 The Gnus Manual}. If @code{opportunistic}, only generate the headers
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1550 when it doesn't lead to the user having to wait.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1551
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1552 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1553
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1554
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1555 @node Mail Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1556 @section Mail Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1557
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1558 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1559 @item message-send-mail-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1560 @vindex message-send-mail-function
87647
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1561 @findex message-send-mail-function
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1562 @findex message-send-mail-with-sendmail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1563 @findex message-send-mail-with-mh
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1564 @findex message-send-mail-with-qmail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1565 @findex message-smtpmail-send-it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1566 @findex smtpmail-send-it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1567 @findex feedmail-send-it
87647
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1568 @findex message-send-mail-with-mailclient
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1569 Function used to send the current buffer as mail. The default is
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1570 @code{message-send-mail-with-sendmail}, or @code{smtpmail-send-it}
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1571 according to the system. Other valid values include
87647
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1572 @code{message-send-mail-with-mailclient},
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1573 @code{message-send-mail-with-mh}, @code{message-send-mail-with-qmail},
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1574 @code{message-smtpmail-send-it} and @code{feedmail-send-it}.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1575
87647
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1576 The function
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1577 @code{message-send-mail-with-sendmail} pipes your article to the
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1578 @code{sendmail} binary for further queuing and sending. When your local
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1579 system is not configured for sending mail using @code{sendmail}, and you
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1580 have access to a remote @acronym{SMTP} server, you can set
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1581 @code{message-send-mail-function} to @code{smtpmail-send-it} and make
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1582 sure to setup the @code{smtpmail} package correctly. An example:
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1583
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1584 @lisp
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1585 (setq message-send-mail-function 'smtpmail-send-it
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1586 smtpmail-default-smtp-server "YOUR SMTP HOST")
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1587 @end lisp
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1588
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1589 To the thing similar to this, there is
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1590 @code{message-smtpmail-send-it}. It is useful if your @acronym{ISP}
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1591 requires the @acronym{POP}-before-@acronym{SMTP} authentication.
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1592 @xref{POP before SMTP, , POP before SMTP, gnus, The Gnus Manual}.
b04073873562 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 85713
diff changeset
1593
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1594 @item message-mh-deletable-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1595 @vindex message-mh-deletable-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1596 Most versions of MH doesn't like being fed messages that contain the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1597 headers in this variable. If this variable is non-@code{nil} (which is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1598 the default), these headers will be removed before mailing when sending
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1599 messages via MH. Set it to @code{nil} if your MH can handle these
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1600 headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1601
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1602 @item message-qmail-inject-program
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1603 @vindex message-qmail-inject-program
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1604 @cindex qmail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1605 Location of the qmail-inject program.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1606
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1607 @item message-qmail-inject-args
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1608 @vindex message-qmail-inject-args
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1609 Arguments passed to qmail-inject programs.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1610 This should be a list of strings, one string for each argument. It
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1611 may also be a function.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1612
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1613 For e.g., if you wish to set the envelope sender address so that bounces
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1614 go to the right place or to deal with listserv's usage of that address, you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1615 might set this variable to @code{'("-f" "you@@some.where")}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1616
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1617 @item message-sendmail-f-is-evil
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1618 @vindex message-sendmail-f-is-evil
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1619 @cindex sendmail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1620 Non-@code{nil} means don't add @samp{-f username} to the sendmail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1621 command line. Doing so would be even more evil than leaving it out.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1622
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1623 @item message-sendmail-envelope-from
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1624 @vindex message-sendmail-envelope-from
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1625 When @code{message-sendmail-f-is-evil} is @code{nil}, this specifies
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1626 the address to use in the @acronym{SMTP} envelope. If it is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1627 @code{nil}, use @code{user-mail-address}. If it is the symbol
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1628 @code{header}, use the @samp{From} header of the message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1629
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1630 @item message-mailer-swallows-blank-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1631 @vindex message-mailer-swallows-blank-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1632 Set this to non-@code{nil} if the system's mailer runs the header and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1633 body together. (This problem exists on SunOS 4 when sendmail is run
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1634 in remote mode.) The value should be an expression to test whether
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1635 the problem will actually occur.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1636
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1637 @item message-send-mail-partially-limit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1638 @vindex message-send-mail-partially-limit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1639 @cindex split large message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1640 The limitation of messages sent as message/partial. The lower bound
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1641 of message size in characters, beyond which the message should be sent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1642 in several parts. If it is @code{nil}, the size is unlimited.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1643
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1644 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1645
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1646
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1647 @node News Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1648 @section News Headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1649
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1650 @vindex message-required-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1651 @code{message-required-news-headers} a list of header symbols. These
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1652 headers will either be automatically generated, or, if that's
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1653 impossible, they will be prompted for. The following symbols are valid:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1654
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1655 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1656
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1657 @item From
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1658 @cindex From
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1659 @findex user-full-name
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1660 @findex user-mail-address
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1661 This required header will be filled out with the result of the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1662 @code{message-make-from} function, which depends on the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1663 @code{message-from-style}, @code{user-full-name},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1664 @code{user-mail-address} variables.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1665
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1666 @item Subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1667 @cindex Subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1668 This required header will be prompted for if not present already.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1669
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1670 @item Newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1671 @cindex Newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1672 This required header says which newsgroups the article is to be posted
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1673 to. If it isn't present already, it will be prompted for.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1674
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1675 @item Organization
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1676 @cindex organization
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1677 @vindex message-user-organization
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1678 @vindex message-user-organization-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1679 This optional header will be filled out depending on the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1680 @code{message-user-organization} variable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1681 @code{message-user-organization-file} will be used if this variable is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1682 @code{t}. This variable can also be a string (in which case this string
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1683 will be used), or it can be a function (which will be called with no
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1684 parameters and should return a string to be used).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1685
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1686 @item Lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1687 @cindex Lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1688 This optional header will be computed by Message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1689
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1690 @item Message-ID
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1691 @cindex Message-ID
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1692 @vindex message-user-fqdn
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1693 @vindex mail-host-address
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1694 @vindex user-mail-address
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1695 @findex system-name
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1696 @cindex Sun
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1697 @cindex i-did-not-set--mail-host-address--so-tickle-me
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1698 This required header will be generated by Message. A unique ID will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1699 created based on the date, time, user name (for the local part) and the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1700 domain part. For the domain part, message will look (in this order) at
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1701 @code{message-user-fqdn}, @code{system-name}, @code{mail-host-address}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1702 and @code{message-user-mail-address} (i.e. @code{user-mail-address})
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1703 until a probably valid fully qualified domain name (FQDN) was found.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1704
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1705 @item User-Agent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1706 @cindex User-Agent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1707 This optional header will be filled out according to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1708 @code{message-newsreader} local variable.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1709
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1710 @item In-Reply-To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1711 This optional header is filled out using the @code{Date} and @code{From}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1712 header of the article being replied to.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1713
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1714 @item Expires
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1715 @cindex Expires
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1716 @vindex message-expires
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1717 This extremely optional header will be inserted according to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1718 @code{message-expires} variable. It is highly deprecated and shouldn't
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1719 be used unless you know what you're doing.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1720
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1721 @item Distribution
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1722 @cindex Distribution
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1723 @vindex message-distribution-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1724 This optional header is filled out according to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1725 @code{message-distribution-function} variable. It is a deprecated and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1726 much misunderstood header.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1727
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1728 @item Path
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1729 @cindex path
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1730 @vindex message-user-path
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1731 This extremely optional header should probably never be used.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1732 However, some @emph{very} old servers require that this header is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1733 present. @code{message-user-path} further controls how this
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1734 @code{Path} header is to look. If it is @code{nil}, use the server name
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1735 as the leaf node. If it is a string, use the string. If it is neither
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1736 a string nor @code{nil}, use the user name only. However, it is highly
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1737 unlikely that you should need to fiddle with this variable at all.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1738 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1739
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1740 @findex yow
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1741 @cindex Mime-Version
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1742 In addition, you can enter conses into this list. The @sc{car} of this cons
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1743 should be a symbol. This symbol's name is the name of the header, and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1744 the @sc{cdr} can either be a string to be entered verbatim as the value of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1745 this header, or it can be a function to be called. This function should
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1746 return a string to be inserted. For instance, if you want to insert
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1747 @code{Mime-Version: 1.0}, you should enter @code{(Mime-Version . "1.0")}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1748 into the list. If you want to insert a funny quote, you could enter
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1749 something like @code{(X-Yow . yow)} into the list. The function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1750 @code{yow} will then be called without any arguments.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1751
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1752 If the list contains a cons where the @sc{car} of the cons is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1753 @code{optional}, the @sc{cdr} of this cons will only be inserted if it is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1754 non-@code{nil}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1755
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1756 If you want to delete an entry from this list, the following Lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1757 snippet might be useful. Adjust accordingly if you want to remove
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1758 another element.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1759
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1760 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1761 (setq message-required-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1762 (delq 'Message-ID message-required-news-headers))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1763 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1764
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1765 Other variables for customizing outgoing news articles:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1766
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1767 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1768
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1769 @item message-syntax-checks
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1770 @vindex message-syntax-checks
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1771 Controls what syntax checks should not be performed on outgoing posts.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1772 To disable checking of long signatures, for instance, add
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1773
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1774 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1775 (signature . disabled)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1776 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1777
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1778 to this list.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1779
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1780 Valid checks are:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1781
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1782 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1783 @item approved
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1784 @cindex approved
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1785 Check whether the article has an @code{Approved} header, which is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1786 something only moderators should include.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1787 @item continuation-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1788 Check whether there are continuation header lines that don't begin with
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1789 whitespace.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1790 @item control-chars
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1791 Check for invalid characters.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1792 @item empty
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1793 Check whether the article is empty.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1794 @item existing-newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1795 Check whether the newsgroups mentioned in the @code{Newsgroups} and
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1796 @code{Followup-To} headers exist.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1797 @item from
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1798 Check whether the @code{From} header seems nice.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1799 @item illegible-text
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1800 Check whether there is any non-printable character in the body.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1801 @item invisible-text
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1802 Check whether there is any invisible text in the buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1803 @item long-header-lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1804 Check for too long header lines.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1805 @item long-lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1806 @cindex long lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1807 Check for too long lines in the body.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1808 @item message-id
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1809 Check whether the @code{Message-ID} looks syntactically ok.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1810 @item multiple-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1811 Check for the existence of multiple equal headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1812 @item new-text
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1813 Check whether there is any new text in the messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1814 @item newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1815 Check whether the @code{Newsgroups} header exists and is not empty.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1816 @item quoting-style
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1817 Check whether text follows last quoted portion.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1818 @item repeated-newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1819 Check whether the @code{Newsgroups} and @code{Followup-to} headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1820 contains repeated group names.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1821 @item reply-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1822 Check whether the @code{Reply-To} header looks ok.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1823 @item sender
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1824 @cindex Sender
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1825 Insert a new @code{Sender} header if the @code{From} header looks odd.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1826 @item sendsys
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1827 @cindex sendsys
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1828 Check for the existence of version and sendsys commands.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1829 @item shoot
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1830 Check whether the domain part of the @code{Message-ID} header looks ok.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1831 @item shorten-followup-to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1832 Check whether to add a @code{Followup-to} header to shorten the number
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1833 of groups to post to.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1834 @item signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1835 Check the length of the signature.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1836 @item size
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1837 Check for excessive size.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1838 @item subject
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1839 Check whether the @code{Subject} header exists and is not empty.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1840 @item subject-cmsg
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1841 Check the subject for commands.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1842 @item valid-newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1843 Check whether the @code{Newsgroups} and @code{Followup-to} headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1844 are valid syntactically.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1845 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1846
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1847 All these conditions are checked by default, except for @code{sender}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1848 for which the check is disabled by default if
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1849 @code{message-insert-canlock} is non-@code{nil} (@pxref{Canceling News}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1850
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1851 @item message-ignored-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1852 @vindex message-ignored-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1853 Regexp of headers to be removed before posting. The default is@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1854 @samp{^NNTP-Posting-Host:\\|^Xref:\\|^[BGF]cc:\\|^Resent-Fcc:\\|@*
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1855 ^X-Draft-From:\\|^X-Gnus-Agent-Meta-Information:}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1856
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1857 @item message-default-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1858 @vindex message-default-news-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1859 This string is inserted at the end of the headers in all message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1860 buffers that are initialized as news.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1861
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1862 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1863
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1864
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1865 @node News Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1866 @section News Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1867
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1868 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1869 @item message-send-news-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1870 @vindex message-send-news-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1871 Function used to send the current buffer as news. The default is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1872 @code{message-send-news}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1873
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1874 @item message-post-method
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1875 @vindex message-post-method
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1876 Gnusish @dfn{select method} (see the Gnus manual for details) used for
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1877 posting a prepared news message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1878
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1879 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1880
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1881
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1882 @node Insertion Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1883 @section Insertion Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1884
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1885 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1886 @item message-ignored-cited-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1887 @vindex message-ignored-cited-headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1888 All headers that match this regexp will be removed from yanked
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1889 messages. The default is @samp{.}, which means that all headers will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1890 removed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1891
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1892 @item message-cite-prefix-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1893 @vindex message-cite-prefix-regexp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1894 Regexp matching the longest possible citation prefix on a line.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1895
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1896 @item message-citation-line-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1897 @vindex message-citation-line-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1898 @cindex attribution line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1899 Function called to insert the citation line. The default is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1900 @code{message-insert-citation-line}, which will lead to citation lines
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1901 that look like:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1902
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1903 @example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1904 Hallvard B Furuseth <h.b.furuseth@@usit.uio.no> writes:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1905 @end example
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1906
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1907 @c FIXME: Add `message-insert-formated-citation-line' and
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1908 @c `message-citation-line-format'
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1909
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1910 Point will be at the beginning of the body of the message when this
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1911 function is called.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1912
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1913 Note that Gnus provides a feature where clicking on `writes:' hides the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1914 cited text. If you change the citation line too much, readers of your
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1915 messages will have to adjust their Gnus, too. See the variable
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1916 @code{gnus-cite-attribution-suffix}. @xref{Article Highlighting, ,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1917 Article Highlighting, gnus, The Gnus Manual}, for details.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1918
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1919 @item message-yank-prefix
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1920 @vindex message-yank-prefix
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1921 @cindex yanking
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1922 @cindex quoting
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1923 When you are replying to or following up an article, you normally want
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1924 to quote the person you are answering. Inserting quoted text is done by
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1925 @dfn{yanking}, and each line you yank will have
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1926 @code{message-yank-prefix} prepended to it (except for quoted lines
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1927 which use @code{message-yank-cited-prefix} and empty lines which use
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1928 @code{message-yank-empty-prefix}). The default is @samp{> }.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1929
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1930 @item message-yank-cited-prefix
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1931 @vindex message-yank-cited-prefix
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1932 @cindex yanking
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1933 @cindex cited
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1934 @cindex quoting
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1935 When yanking text from an article which contains already cited text,
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1936 each line will be prefixed with the contents of this variable. The
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1937 default is @samp{>}. See also @code{message-yank-prefix}.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1938
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1939 @item message-yank-empty-prefix
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1940 @vindex message-yank-empty-prefix
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1941 @cindex yanking
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1942 @cindex quoting
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1943 When yanking text from an article, each empty line will be prefixed with
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1944 the contents of this variable. The default is @samp{>}. You can set
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1945 this variable to an empty string to split the cited text into paragraphs
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1946 automatically. See also @code{message-yank-prefix}.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1947
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1948 @item message-indentation-spaces
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1949 @vindex message-indentation-spaces
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1950 Number of spaces to indent yanked messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1951
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1952 @item message-cite-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1953 @vindex message-cite-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1954 @findex message-cite-original
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1955 @findex sc-cite-original
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1956 @findex message-cite-original-without-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1957 @cindex Supercite
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1958 Function for citing an original message. The default is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1959 @code{message-cite-original}, which simply inserts the original message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1960 and prepends @samp{> } to each line.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1961 @code{message-cite-original-without-signature} does the same, but elides
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1962 the signature. You can also set it to @code{sc-cite-original} to use
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1963 Supercite.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1964
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1965 @item message-indent-citation-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1966 @vindex message-indent-citation-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1967 Function for modifying a citation just inserted in the mail buffer.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1968 This can also be a list of functions. Each function can find the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1969 citation between @code{(point)} and @code{(mark t)}. And each function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1970 should leave point and mark around the citation text as modified.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1971
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1972 @item message-mark-insert-begin
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1973 @vindex message-mark-insert-begin
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1974 String to mark the beginning of some inserted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1975
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1976 @item message-mark-insert-end
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1977 @vindex message-mark-insert-end
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1978 String to mark the end of some inserted text.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1979
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1980 @item message-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1981 @vindex message-signature
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1982 String to be inserted at the end of the message buffer. If @code{t}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1983 (which is the default), the @code{message-signature-file} file will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1984 inserted instead. If a function, the result from the function will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1985 used instead. If a form, the result from the form will be used instead.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1986 If this variable is @code{nil}, no signature will be inserted at all.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1987
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1988 @item message-signature-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1989 @vindex message-signature-file
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1990 File containing the signature to be inserted at the end of the buffer.
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1991 If a path is specified, the value of
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1992 @code{message-signature-directory} is ignored, even if set.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1993 The default is @file{~/.signature}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1994
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1995 @item message-signature-directory
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1996 @vindex message-signature-directory
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1997 Name of directory containing signature files. Comes in handy if you
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1998 have many such files, handled via Gnus posting styles for instance.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
1999 If @code{nil} (the default), @code{message-signature-file} is expected
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2000 to specify the directory if needed.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2001
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2002
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2003 @item message-signature-insert-empty-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2004 @vindex message-signature-insert-empty-line
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2005 If @code{t} (the default value) an empty line is inserted before the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2006 signature separator.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2007
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2008 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2009
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2010 Note that RFC1036bis says that a signature should be preceded by the three
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2011 characters @samp{-- } on a line by themselves. This is to make it
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2012 easier for the recipient to automatically recognize and process the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2013 signature. So don't remove those characters, even though you might feel
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2014 that they ruin your beautiful design, like, totally.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2015
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2016 Also note that no signature should be more than four lines long.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2017 Including @acronym{ASCII} graphics is an efficient way to get
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2018 everybody to believe that you are silly and have nothing important to
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2019 say.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2020
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2021
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2022 @node Various Message Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2023 @section Various Message Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2024
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2025 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2026 @item message-default-charset
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2027 @vindex message-default-charset
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2028 @cindex charset
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2029 Symbol naming a @acronym{MIME} charset. Non-@acronym{ASCII} characters
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2030 in messages are assumed to be encoded using this charset. The default
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2031 is @code{iso-8859-1} on non-@sc{mule} Emacsen; otherwise @code{nil},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2032 which means ask the user. (This variable is used only on non-@sc{mule}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2033 Emacsen.) @xref{Charset Translation, , Charset Translation, emacs-mime,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2034 Emacs MIME Manual}, for details on the @sc{mule}-to-@acronym{MIME}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2035 translation process.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2036
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2037 @item message-fill-column
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2038 @vindex message-fill-column
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2039 @cindex auto-fill
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2040 Local value for the column beyond which automatic line-wrapping should
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2041 happen for message buffers. If non-nil (the default), also turn on
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2042 auto-fill in message buffers.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2043
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2044 @item message-signature-separator
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2045 @vindex message-signature-separator
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2046 Regexp matching the signature separator. It is @samp{^-- *$} by
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2047 default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2048
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2049 @item mail-header-separator
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2050 @vindex mail-header-separator
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2051 String used to separate the headers from the body. It is @samp{--text
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2052 follows this line--} by default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2053
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2054 @item message-directory
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2055 @vindex message-directory
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2056 Directory used by many mailey things. The default is @file{~/Mail/}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2057 All other mail file variables are derived from @code{message-directory}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2058
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2059 @item message-auto-save-directory
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2060 @vindex message-auto-save-directory
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2061 Directory where Message auto-saves buffers if Gnus isn't running. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2062 @code{nil}, Message won't auto-save. The default is @file{~/Mail/drafts/}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2063
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2064 @item message-signature-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2065 @vindex message-signature-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2066 Hook run when initializing the message buffer. It is run after the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2067 headers have been inserted but before the signature has been inserted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2068
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2069 @item message-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2070 @vindex message-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2071 Hook run as the last thing when the message buffer has been initialized,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2072 but before yanked text is inserted.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2073
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2074 @item message-header-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2075 @vindex message-header-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2076 Hook called narrowed to the headers after initializing the headers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2077
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2078 For instance, if you're running Gnus and wish to insert a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2079 @samp{Mail-Copies-To} header in all your news articles and all messages
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2080 you send to mailing lists, you could do something like the following:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2081
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2082 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2083 (defun my-message-header-setup-hook ()
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2084 (let ((group (or gnus-newsgroup-name "")))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2085 (when (or (message-fetch-field "newsgroups")
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2086 (gnus-group-find-parameter group 'to-address)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2087 (gnus-group-find-parameter group 'to-list))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2088 (insert "Mail-Copies-To: never\n"))))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2089
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2090 (add-hook 'message-header-setup-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2091 'my-message-header-setup-hook)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2092 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2093
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2094 @item message-send-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2095 @vindex message-send-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2096 Hook run before sending messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2097
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2098 If you want to add certain headers before sending, you can use the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2099 @code{message-add-header} function in this hook. For instance:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2100 @findex message-add-header
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2101
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2102 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2103 (add-hook 'message-send-hook 'my-message-add-content)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2104 (defun my-message-add-content ()
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2105 (message-add-header "X-In-No-Sense: Nonsense")
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2106 (message-add-header "X-Whatever: no"))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2107 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2108
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2109 This function won't add the header if the header is already present.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2110
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2111 @item message-send-mail-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2112 @vindex message-send-mail-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2113 Hook run before sending mail messages. This hook is run very late --
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2114 just before the message is actually sent as mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2115
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2116 @item message-send-news-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2117 @vindex message-send-news-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2118 Hook run before sending news messages. This hook is run very late --
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2119 just before the message is actually sent as news.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2120
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2121 @item message-sent-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2122 @vindex message-sent-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2123 Hook run after sending messages.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2124
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2125 @item message-cancel-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2126 @vindex message-cancel-hook
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2127 Hook run when canceling news articles.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2128
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2129 @item message-mode-syntax-table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2130 @vindex message-mode-syntax-table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2131 Syntax table used in message mode buffers.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2132
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2133 @item message-cite-articles-with-x-no-archive
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2134 @vindex message-cite-articles-with-x-no-archive
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2135 If non-@code{nil}, don't strip quoted text from articles that have
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2136 @samp{X-No-Archive} set. Even if this variable isn't set, you can
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2137 undo the stripping by hitting the @code{undo} keystroke.
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2138
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2139 @item message-strip-special-text-properties
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2140 @vindex message-strip-special-text-properties
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2141 Emacs has a number of special text properties which can break message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2142 composing in various ways. If this option is set, message will strip
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2143 these properties from the message composition buffer. However, some
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2144 packages requires these properties to be present in order to work. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2145 you use one of these packages, turn this option off, and hope the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2146 message composition doesn't break too bad.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2147
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2148 @item message-send-method-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2149 @vindex message-send-method-alist
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2150 @findex message-mail-p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2151 @findex message-news-p
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2152 @findex message-send-via-mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2153 @findex message-send-via-news
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2154 Alist of ways to send outgoing messages. Each element has the form:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2155
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2156 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2157 (@var{type} @var{predicate} @var{function})
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2158 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2159
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2160 @table @var
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2161 @item type
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2162 A symbol that names the method.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2163
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2164 @item predicate
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2165 A function called without any parameters to determine whether the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2166 message is a message of type @var{type}. The function will be called in
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2167 the buffer where the message is.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2168
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2169 @item function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2170 A function to be called if @var{predicate} returns non-@code{nil}.
85712
a3c27999decb Update Gnus to No Gnus 0.7 from the Gnus CVS trunk
Miles Bader <miles@gnu.org>
parents: 84329
diff changeset
2171 @var{function} is called with one parameter---the prefix.
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2172 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2173
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2174 The default is:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2175
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2176 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2177 ((news message-news-p message-send-via-news)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2178 (mail message-mail-p message-send-via-mail))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2179 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2180
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2181 The @code{message-news-p} function returns non-@code{nil} if the message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2182 looks like news, and the @code{message-send-via-news} function sends the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2183 message according to the @code{message-send-news-function} variable
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2184 (@pxref{News Variables}). The @code{message-mail-p} function returns
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2185 non-@code{nil} if the message looks like mail, and the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2186 @code{message-send-via-mail} function sends the message according to the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2187 @code{message-send-mail-function} variable (@pxref{Mail Variables}).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2188
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2189 All the elements in this alist will be tried in order, so a message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2190 containing both a valid @samp{Newsgroups} header and a valid @samp{To}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2191 header, for example, will be sent as news, and then as mail.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2192 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2193
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2194
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2195
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2196 @node Sending Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2197 @section Sending Variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2198
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2199 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2200
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2201 @item message-fcc-handler-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2202 @vindex message-fcc-handler-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2203 A function called to save outgoing articles. This function will be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2204 called with the name of the file to store the article in. The default
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2205 function is @code{message-output} which saves in Unix mailbox format.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2206
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2207 @item message-courtesy-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2208 @vindex message-courtesy-message
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2209 When sending combined messages, this string is inserted at the start of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2210 the mailed copy. If the string contains the format spec @samp{%s}, the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2211 newsgroups the article has been posted to will be inserted there. If
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2212 this variable is @code{nil}, no such courtesy message will be added.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2213 The default value is @samp{"The following message is a courtesy copy of
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2214 an article\\nthat has been posted to %s as well.\\n\\n"}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2215
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2216 @item message-fcc-externalize-attachments
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2217 @vindex message-fcc-externalize-attachments
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2218 If @code{nil}, attach files as normal parts in Fcc copies; if it is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2219 non-@code{nil}, attach local files as external parts.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2220
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2221 @item message-interactive
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2222 @vindex message-interactive
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2223 If non-@code{nil} wait for and display errors when sending a message;
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2224 if @code{nil} let the mailer mail back a message to report errors.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2225
98344
7fa3e064d230 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 95937
diff changeset
2226 @item message-confirm-send
7fa3e064d230 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 95937
diff changeset
2227 @vindex message-confirm-send
98345
952d664ebd93 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 98344
diff changeset
2228 When non-@code{nil}, Gnus will ask for confirmation when sending a
98344
7fa3e064d230 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 95937
diff changeset
2229 message.
7fa3e064d230 Merge from gnus--devo--0
Miles Bader <miles@gnu.org>
parents: 95937
diff changeset
2230
84305
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2231 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2232
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2233
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2234 @node Message Buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2235 @section Message Buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2236
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2237 Message will generate new buffers with unique buffer names when you
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2238 request a message buffer. When you send the message, the buffer isn't
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2239 normally killed off. Its name is changed and a certain number of old
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2240 message buffers are kept alive.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2241
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2242 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2243 @item message-generate-new-buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2244 @vindex message-generate-new-buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2245 Controls whether to create a new message buffer to compose a message.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2246 Valid values include:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2247
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2248 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2249 @item nil
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2250 Generate the buffer name in the Message way (e.g., *mail*, *news*, *mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2251 to whom*, *news on group*, etc.) and continue editing in the existing
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2252 buffer of that name. If there is no such buffer, it will be newly
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2253 created.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2254
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2255 @item unique
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2256 @item t
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2257 Create the new buffer with the name generated in the Message way. This
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2258 is the default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2259
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2260 @item unsent
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2261 Similar to @code{unique} but the buffer name begins with "*unsent ".
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2262
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2263 @item standard
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2264 Similar to @code{nil} but the buffer name is simpler like *mail
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2265 message*.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2266 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2267 @table @var
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2268 @item function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2269 If this is a function, call that function with three parameters: The
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2270 type, the To address and the group name (any of these may be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2271 @code{nil}). The function should return the new buffer name.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2272 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2273
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2274 The default value is @code{unique}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2275
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2276 @item message-max-buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2277 @vindex message-max-buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2278 This variable says how many old message buffers to keep. If there are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2279 more message buffers than this, the oldest buffer will be killed. The
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2280 default is 10. If this variable is @code{nil}, no old message buffers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2281 will ever be killed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2282
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2283 @item message-send-rename-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2284 @vindex message-send-rename-function
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2285 After sending a message, the buffer is renamed from, for instance,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2286 @samp{*reply to Lars*} to @samp{*sent reply to Lars*}. If you don't
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2287 like this, set this variable to a function that renames the buffer in a
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2288 manner you like. If you don't want to rename the buffer at all, you can
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2289 say:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2290
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2291 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2292 (setq message-send-rename-function 'ignore)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2293 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2294
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2295 @item message-kill-buffer-on-exit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2296 @findex message-kill-buffer-on-exit
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2297 If non-@code{nil}, kill the buffer immediately on exit.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2298
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2299 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2300
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2301
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2302 @node Message Actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2303 @section Message Actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2304
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2305 When Message is being used from a news/mail reader, the reader is likely
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2306 to want to perform some task after the message has been sent. Perhaps
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2307 return to the previous window configuration or mark an article as
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2308 replied.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2309
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2310 @vindex message-kill-actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2311 @vindex message-postpone-actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2312 @vindex message-exit-actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2313 @vindex message-send-actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2314 The user may exit from the message buffer in various ways. The most
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2315 common is @kbd{C-c C-c}, which sends the message and exits. Other
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2316 possibilities are @kbd{C-c C-s} which just sends the message, @kbd{C-c
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2317 C-d} which postpones the message editing and buries the message buffer,
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2318 and @kbd{C-c C-k} which kills the message buffer. Each of these actions
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2319 have lists associated with them that contains actions to be executed:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2320 @code{message-send-actions}, @code{message-exit-actions},
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2321 @code{message-postpone-actions}, and @code{message-kill-actions}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2322
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2323 Message provides a function to interface with these lists:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2324 @code{message-add-action}. The first parameter is the action to be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2325 added, and the rest of the arguments are which lists to add this action
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2326 to. Here's an example from Gnus:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2327
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2328 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2329 (message-add-action
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2330 `(set-window-configuration ,(current-window-configuration))
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2331 'exit 'postpone 'kill)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2332 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2333
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2334 This restores the Gnus window configuration when the message buffer is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2335 killed, postponed or exited.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2336
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2337 An @dfn{action} can be either: a normal function, or a list where the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2338 @sc{car} is a function and the @sc{cdr} is the list of arguments, or
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2339 a form to be @code{eval}ed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2340
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2341
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2342 @node Compatibility
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2343 @chapter Compatibility
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2344 @cindex compatibility
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2345
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2346 Message uses virtually only its own variables---older @code{mail-}
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2347 variables aren't consulted. To force Message to take those variables
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2348 into account, you can put the following in your @file{.emacs} file:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2349
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2350 @lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2351 (require 'messcompat)
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2352 @end lisp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2353
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2354 This will initialize many Message variables from the values in the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2355 corresponding mail variables.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2356
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2357
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2358 @node Appendices
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2359 @chapter Appendices
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2360
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2361 @menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2362 * Responses:: Standard rules for determining where responses go.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2363 @end menu
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2364
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2365
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2366 @node Responses
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2367 @section Responses
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2368
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2369 To determine where a message is to go, the following algorithm is used
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2370 by default.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2371
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2372 @table @dfn
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2373 @item reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2374 A @dfn{reply} is when you want to respond @emph{just} to the person who
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2375 sent the message via mail. There will only be one recipient. To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2376 determine who the recipient will be, the following headers are
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2377 consulted, in turn:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2378
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2379 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2380 @item Reply-To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2381
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2382 @item From
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2383 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2384
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2385
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2386 @item wide reply
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2387 A @dfn{wide reply} is a mail response that includes @emph{all} entities
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2388 mentioned in the message you are responded to. All mailboxes from the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2389 following headers will be concatenated to form the outgoing
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2390 @code{To}/@code{Cc} headers:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2391
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2392 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2393 @item From
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2394 (unless there's a @code{Reply-To}, in which case that is used instead).
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2395
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2396 @item Cc
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2397
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2398 @item To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2399 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2400
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2401 If a @code{Mail-Copies-To} header is present, it will also be included
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2402 in the list of mailboxes. If this header is @samp{never}, that means
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2403 that the @code{From} (or @code{Reply-To}) mailbox will be suppressed.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2404
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2405
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2406 @item followup
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2407 A @dfn{followup} is a response sent via news. The following headers
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2408 (listed in order of precedence) determine where the response is to be
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2409 sent:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2410
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2411 @table @code
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2412
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2413 @item Followup-To
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2414
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2415 @item Newsgroups
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2416
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2417 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2418
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2419 If a @code{Mail-Copies-To} header is present, it will be used as the
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2420 basis of the new @code{Cc} header, except if this header is
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2421 @samp{never}.
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2422
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2423 @end table
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2424
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2425
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2426 @node GNU Free Documentation License
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2427 @chapter GNU Free Documentation License
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2428 @include doclicense.texi
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2429
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2430 @node Index
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2431 @chapter Index
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2432 @printindex cp
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2433
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2434 @node Key Index
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2435 @chapter Key Index
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2436 @printindex ky
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2437
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2438 @summarycontents
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2439 @contents
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2440 @bye
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2441
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2442 @c End:
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2443
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2444 @ignore
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2445 arch-tag: 16ab76af-a281-4e34-aed6-5624569f7601
7f53884455f2 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2446 @end ignore