annotate man/message.texi @ 59078:867a7d5055b2

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