annotate man/message.texi @ 69395:973779d570da

(ispell-find-aspell-dictionaries): Add aliases before merging elements from the standard ispell-dictionary-alist. (ispell-aspell-add-aliases): Add aliases to the passed dictionary alist, and return the new alist.
author Eli Zaretskii <eliz@gnu.org>
date Sat, 11 Mar 2006 15:36:15 +0000
parents 04c2548593f7
children 11b616eddda4 7432ca837c8d
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
64890
3723093a21fd Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 63673
diff changeset
11 Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
68521
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
12 2005, 2006 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
65555
69b3598a61c5 Update all manuals to specify GFDL version 1.2.
Romain Francoise <romain@orebokech.com>
parents: 64890
diff changeset
16 under the terms of the GNU Free Documentation License, Version 1.2 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
59406
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
149 As you can see, this function should return a list. In this case, it
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
150 returns @code{((To . "Whom"))} if it has an opinion as to what the To
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
151 header should be. If it does not, it should just return @code{nil}, and
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
152 the normal methods for determining the To header will be used.
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
153
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
154 Each list element should be a cons, where the @sc{car} should be the
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
155 name of a header (e.g. @code{Cc}) and the @sc{cdr} should be the header
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
156 value (e.g. @samp{larsi@@ifi.uio.no}). All these headers will be
cf93431040c9 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-17
Miles Bader <miles@gnu.org>
parents: 58835
diff changeset
157 inserted into the head of the outgoing mail.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
158
Dave Love <fx@gnu.org>
parents:
diff changeset
159
Dave Love <fx@gnu.org>
parents:
diff changeset
160 @node Wide Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
161 @section Wide Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
162
Dave Love <fx@gnu.org>
parents:
diff changeset
163 @findex message-wide-reply
Dave Love <fx@gnu.org>
parents:
diff changeset
164 The @code{message-wide-reply} pops up a message buffer that's a wide
Dave Love <fx@gnu.org>
parents:
diff changeset
165 reply to the message in the current buffer. A @dfn{wide reply} is a
Dave Love <fx@gnu.org>
parents:
diff changeset
166 reply that goes out to all people listed in the @code{To}, @code{From}
Dave Love <fx@gnu.org>
parents:
diff changeset
167 (or @code{Reply-to}) and @code{Cc} headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
168
Dave Love <fx@gnu.org>
parents:
diff changeset
169 @vindex message-wide-reply-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
170 Message uses the normal methods to determine where wide replies are to go,
Dave Love <fx@gnu.org>
parents:
diff changeset
171 but you can change the behavior to suit your needs by fiddling with the
Dave Love <fx@gnu.org>
parents:
diff changeset
172 @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
173 @code{message-reply-to-function} (@pxref{Reply}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
174
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
175 @vindex message-dont-reply-to-names
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
176 Addresses that match the @code{message-dont-reply-to-names} regular
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
177 expression will be removed from the @code{Cc} header.
Dave Love <fx@gnu.org>
parents:
diff changeset
178
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
179 @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
180 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
181 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
182 recipients. The default is @code{nil}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
183
Dave Love <fx@gnu.org>
parents:
diff changeset
184 @node Followup
Dave Love <fx@gnu.org>
parents:
diff changeset
185 @section Followup
Dave Love <fx@gnu.org>
parents:
diff changeset
186
Dave Love <fx@gnu.org>
parents:
diff changeset
187 @findex message-followup
Dave Love <fx@gnu.org>
parents:
diff changeset
188 The @code{message-followup} command pops up a message buffer that's a
Dave Love <fx@gnu.org>
parents:
diff changeset
189 followup to the message in the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
190
Dave Love <fx@gnu.org>
parents:
diff changeset
191 @vindex message-followup-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
192 Message uses the normal methods to determine where followups are to go,
Dave Love <fx@gnu.org>
parents:
diff changeset
193 but you can change the behavior to suit your needs by fiddling with the
Dave Love <fx@gnu.org>
parents:
diff changeset
194 @code{message-followup-to-function}. It is used in the same way as
Dave Love <fx@gnu.org>
parents:
diff changeset
195 @code{message-reply-to-function} (@pxref{Reply}).
Dave Love <fx@gnu.org>
parents:
diff changeset
196
Dave Love <fx@gnu.org>
parents:
diff changeset
197 @vindex message-use-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
198 The @code{message-use-followup-to} variable says what to do about
Dave Love <fx@gnu.org>
parents:
diff changeset
199 @code{Followup-To} headers. If it is @code{use}, always use the value.
Dave Love <fx@gnu.org>
parents:
diff changeset
200 If it is @code{ask} (which is the default), ask whether to use the
Dave Love <fx@gnu.org>
parents:
diff changeset
201 value. If it is @code{t}, use the value unless it is @samp{poster}. If
Dave Love <fx@gnu.org>
parents:
diff changeset
202 it is @code{nil}, don't use the value.
Dave Love <fx@gnu.org>
parents:
diff changeset
203
Dave Love <fx@gnu.org>
parents:
diff changeset
204
Dave Love <fx@gnu.org>
parents:
diff changeset
205 @node Canceling News
Dave Love <fx@gnu.org>
parents:
diff changeset
206 @section Canceling News
Dave Love <fx@gnu.org>
parents:
diff changeset
207
Dave Love <fx@gnu.org>
parents:
diff changeset
208 @findex message-cancel-news
Dave Love <fx@gnu.org>
parents:
diff changeset
209 The @code{message-cancel-news} command cancels the article in the
Dave Love <fx@gnu.org>
parents:
diff changeset
210 current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
211
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
212 @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
213 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
214 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
215 article.}.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
216
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
217 @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
218 @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
219 @cindex canlock
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
220 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
221 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
222 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
223 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
224 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
225 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
226 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
227 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
228
505c55fe8dc9 Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-621
Miles Bader <miles@gnu.org>
parents: 57224
diff changeset
229 @lisp
57581
645f020dcc8a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-626
Miles Bader <miles@gnu.org>
parents: 57561
diff changeset
230 (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
231 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
232 @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
233
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
234 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
235 @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
236
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
237 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
238 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
239
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
240
Dave Love <fx@gnu.org>
parents:
diff changeset
241 @node Superseding
Dave Love <fx@gnu.org>
parents:
diff changeset
242 @section Superseding
Dave Love <fx@gnu.org>
parents:
diff changeset
243
Dave Love <fx@gnu.org>
parents:
diff changeset
244 @findex message-supersede
Dave Love <fx@gnu.org>
parents:
diff changeset
245 The @code{message-supersede} command pops up a message buffer that will
Dave Love <fx@gnu.org>
parents:
diff changeset
246 supersede the message in the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
247
Dave Love <fx@gnu.org>
parents:
diff changeset
248 @vindex message-ignored-supersedes-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
249 Headers matching the @code{message-ignored-supersedes-headers} are
Dave Love <fx@gnu.org>
parents:
diff changeset
250 removed before popping up the new message buffer. The default is@*
Dave Love <fx@gnu.org>
parents:
diff changeset
251 @samp{^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|@*
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
252 ^Received:\\|^X-From-Line:\\|^X-Trace:\\|^X-Complaints-To:\\|@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
253 Return-Path:\\|^Supersedes:\\|^NNTP-Posting-Date:\\|^X-Trace:\\|@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
254 ^X-Complaints-To:\\|^Cancel-Lock:\\|^Cancel-Key:\\|^X-Hashcash:\\|@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
255 ^X-Payment:}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
256
Dave Love <fx@gnu.org>
parents:
diff changeset
257
Dave Love <fx@gnu.org>
parents:
diff changeset
258
Dave Love <fx@gnu.org>
parents:
diff changeset
259 @node Forwarding
Dave Love <fx@gnu.org>
parents:
diff changeset
260 @section Forwarding
Dave Love <fx@gnu.org>
parents:
diff changeset
261
Dave Love <fx@gnu.org>
parents:
diff changeset
262 @findex message-forward
Dave Love <fx@gnu.org>
parents:
diff changeset
263 The @code{message-forward} command pops up a message buffer to forward
Dave Love <fx@gnu.org>
parents:
diff changeset
264 the message in the current buffer. If given a prefix, forward using
Dave Love <fx@gnu.org>
parents:
diff changeset
265 news.
Dave Love <fx@gnu.org>
parents:
diff changeset
266
Dave Love <fx@gnu.org>
parents:
diff changeset
267 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
268 @item message-forward-ignored-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
269 @vindex message-forward-ignored-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
270 All headers that match this regexp will be deleted when forwarding a message.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
271
Dave Love <fx@gnu.org>
parents:
diff changeset
272 @item message-make-forward-subject-function
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @vindex message-make-forward-subject-function
Dave Love <fx@gnu.org>
parents:
diff changeset
274 A list of functions that are called to generate a subject header for
Dave Love <fx@gnu.org>
parents:
diff changeset
275 forwarded messages. The subject generated by the previous function is
Dave Love <fx@gnu.org>
parents:
diff changeset
276 passed into each successive function.
Dave Love <fx@gnu.org>
parents:
diff changeset
277
Dave Love <fx@gnu.org>
parents:
diff changeset
278 The provided functions are:
Dave Love <fx@gnu.org>
parents:
diff changeset
279
Dave Love <fx@gnu.org>
parents:
diff changeset
280 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
281 @item message-forward-subject-author-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
282 @findex message-forward-subject-author-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
283 Source of article (author or newsgroup), in brackets followed by the
Dave Love <fx@gnu.org>
parents:
diff changeset
284 subject.
Dave Love <fx@gnu.org>
parents:
diff changeset
285
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @item message-forward-subject-fwd
Dave Love <fx@gnu.org>
parents:
diff changeset
287 Subject of article with @samp{Fwd:} prepended to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
289
Dave Love <fx@gnu.org>
parents:
diff changeset
290 @item message-wash-forwarded-subjects
Dave Love <fx@gnu.org>
parents:
diff changeset
291 @vindex message-wash-forwarded-subjects
Dave Love <fx@gnu.org>
parents:
diff changeset
292 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
293 the evidence of previous forwards (such as @samp{Fwd:}, @samp{Re:},
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
294 @samp{(fwd)}) removed before the new subject is
Dave Love <fx@gnu.org>
parents:
diff changeset
295 constructed. The default value is @code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
296
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
297 @item message-forward-as-mime
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
298 @vindex message-forward-as-mime
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
299 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
300 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
301 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
302 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
303
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
304 @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
305 @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
306 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
307
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
308 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
309
Dave Love <fx@gnu.org>
parents:
diff changeset
310
Dave Love <fx@gnu.org>
parents:
diff changeset
311 @node Resending
Dave Love <fx@gnu.org>
parents:
diff changeset
312 @section Resending
Dave Love <fx@gnu.org>
parents:
diff changeset
313
Dave Love <fx@gnu.org>
parents:
diff changeset
314 @findex message-resend
Dave Love <fx@gnu.org>
parents:
diff changeset
315 The @code{message-resend} command will prompt the user for an address
Dave Love <fx@gnu.org>
parents:
diff changeset
316 and resend the message in the current buffer to that address.
Dave Love <fx@gnu.org>
parents:
diff changeset
317
Dave Love <fx@gnu.org>
parents:
diff changeset
318 @vindex message-ignored-resent-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
319 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
320 be removed before sending the message.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
321
Dave Love <fx@gnu.org>
parents:
diff changeset
322
Dave Love <fx@gnu.org>
parents:
diff changeset
323 @node Bouncing
Dave Love <fx@gnu.org>
parents:
diff changeset
324 @section Bouncing
Dave Love <fx@gnu.org>
parents:
diff changeset
325
Dave Love <fx@gnu.org>
parents:
diff changeset
326 @findex message-bounce
Dave Love <fx@gnu.org>
parents:
diff changeset
327 The @code{message-bounce} command will, if the current buffer contains a
Dave Love <fx@gnu.org>
parents:
diff changeset
328 bounced mail message, pop up a message buffer stripped of the bounce
Dave Love <fx@gnu.org>
parents:
diff changeset
329 information. A @dfn{bounced message} is typically a mail you've sent
Dave Love <fx@gnu.org>
parents:
diff changeset
330 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
331 undeliverable.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
332
Dave Love <fx@gnu.org>
parents:
diff changeset
333 @vindex message-ignored-bounced-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
334 Headers that match the @code{message-ignored-bounced-headers} regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
335 will be removed before popping up the buffer. The default is
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
336 @samp{^\\(Received\\|Return-Path\\|Delivered-To\\):}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
337
Dave Love <fx@gnu.org>
parents:
diff changeset
338
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
339 @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
340 @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
341
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
342 @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
343 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
344 followups to the post to specific places. The Mail-Followup-To (MFT)
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
345 was created to enable just this. Three example scenarios where this is
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
346 useful:
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
347
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
348 @itemize @bullet
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
349 @item
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
350 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
351 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
352 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
353
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
354 @item
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
355 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
356 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
357 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
358
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
359 @item
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
360 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
361 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
362 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
363 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
364
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
365 @end itemize
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
366
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
367 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
368 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
369 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
370
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
371 @c @menu
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
372 @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
373 @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
374 @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
375
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
376 @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
377 @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
378
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
379 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
380 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
381 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
382 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
383
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
384 @table @code
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
385
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
386 @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
387 @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
388 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
389 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
390 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
391 (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
392 '("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
393 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
394
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
395 @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
396 @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
397 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
398 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
399 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
400 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
401 (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
402 '("\\(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
403 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
404
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
405 @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
406 @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
407 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
408 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
409 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
410
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
411 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
412 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
413 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
414 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
415 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
416 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
417
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
418 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
419 (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
420 '(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
421 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
422
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
423 @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
424 @item message-subscribed-address-file
63636
75c04f750f89 Fix spellings.
Juanma Barranquero <lekktu@gmail.com>
parents: 63600
diff changeset
425 You might be one organized human freak and have a list of addresses of
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
426 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
427 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
428
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
429 @end table
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
430
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
431 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
432 ``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
433
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
434 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
435 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
436 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
437 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
438 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
439 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
440 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
441 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
442 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
443 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
444 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
445
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-a
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-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
448 @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
449 @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
450 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
451 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
452 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
453 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
454 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
455 @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
456 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
457 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
458 (@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
459
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
460 @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
461 @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
462
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
463 @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
464 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
465 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
466 @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
467
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
468 @table @code
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
469 @item use
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
470 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
471 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
472
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
473 @item nil
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
474 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
475
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
476 @item ask
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
477 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
478
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
479 @end table
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
480
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
481 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
482 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
483 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
484
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
485 @node Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
486 @chapter Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
487
Dave Love <fx@gnu.org>
parents:
diff changeset
488 @menu
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
489 * 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
490 * Header Commands:: Commands for moving headers or changing headers.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
491 * Movement:: Moving around in message buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
492 * 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
493 * 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
494 * 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
495 * Security:: Signing and encrypting messages.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
496 * Various Commands:: Various things.
Dave Love <fx@gnu.org>
parents:
diff changeset
497 * Sending:: Actually sending the message.
Dave Love <fx@gnu.org>
parents:
diff changeset
498 * Mail Aliases:: How to use mail aliases.
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
499 * Spelling:: Having Emacs check your spelling.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
500 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
501
Dave Love <fx@gnu.org>
parents:
diff changeset
502
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
503 @node Buffer Entry
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
504 @section Buffer Entry
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
505 @cindex undo
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
506 @kindex C-_
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
507
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
508 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
509 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
510 may remove signatures, reformat the text, or the like---depending on
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
511 which used settings you're using. Message usually gets things right,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
512 but sometimes it stumbles. To help the user unwind these stumblings,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
513 Message sets the undo boundary before each major automatic action it
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
514 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
515 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
516
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
517
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
518 @node Header Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
519 @section Header Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
520
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
521 @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
522
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
523 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
524 exist, it will be inserted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
525
Dave Love <fx@gnu.org>
parents:
diff changeset
526 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
527
Dave Love <fx@gnu.org>
parents:
diff changeset
528 @item C-c ?
Dave Love <fx@gnu.org>
parents:
diff changeset
529 @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
530 @findex describe-mode
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
531 Describe the message mode.
Dave Love <fx@gnu.org>
parents:
diff changeset
532
Dave Love <fx@gnu.org>
parents:
diff changeset
533 @item C-c C-f C-t
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
534 @kindex C-c C-f C-t
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
535 @findex message-goto-to
Dave Love <fx@gnu.org>
parents:
diff changeset
536 Go to the @code{To} header (@code{message-goto-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
537
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
538 @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
539 @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
540 @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
541 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
542 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
543
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
544 @item C-c C-f C-b
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
545 @kindex C-c C-f C-b
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
546 @findex message-goto-bcc
Dave Love <fx@gnu.org>
parents:
diff changeset
547 Go to the @code{Bcc} header (@code{message-goto-bcc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
548
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
549 @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
550 @kindex C-c C-f C-f
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
551 @findex message-goto-fcc
Dave Love <fx@gnu.org>
parents:
diff changeset
552 Go to the @code{Fcc} header (@code{message-goto-fcc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
553
Dave Love <fx@gnu.org>
parents:
diff changeset
554 @item C-c C-f C-c
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
555 @kindex C-c C-f C-c
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
556 @findex message-goto-cc
Dave Love <fx@gnu.org>
parents:
diff changeset
557 Go to the @code{Cc} header (@code{message-goto-cc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
558
Dave Love <fx@gnu.org>
parents:
diff changeset
559 @item C-c C-f C-s
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
560 @kindex C-c C-f C-s
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
561 @findex message-goto-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
562 Go to the @code{Subject} header (@code{message-goto-subject}).
Dave Love <fx@gnu.org>
parents:
diff changeset
563
Dave Love <fx@gnu.org>
parents:
diff changeset
564 @item C-c C-f C-r
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
565 @kindex C-c C-f C-r
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
566 @findex message-goto-reply-to
Dave Love <fx@gnu.org>
parents:
diff changeset
567 Go to the @code{Reply-To} header (@code{message-goto-reply-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
568
Dave Love <fx@gnu.org>
parents:
diff changeset
569 @item C-c C-f C-n
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
570 @kindex C-c C-f C-n
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
571 @findex message-goto-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
572 Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}).
Dave Love <fx@gnu.org>
parents:
diff changeset
573
Dave Love <fx@gnu.org>
parents:
diff changeset
574 @item C-c C-f C-d
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
575 @kindex C-c C-f C-d
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
576 @findex message-goto-distribution
Dave Love <fx@gnu.org>
parents:
diff changeset
577 Go to the @code{Distribution} header (@code{message-goto-distribution}).
Dave Love <fx@gnu.org>
parents:
diff changeset
578
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
579 @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
580 @kindex C-c C-f C-o
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
581 @findex message-goto-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
582 Go to the @code{Followup-To} header (@code{message-goto-followup-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
583
Dave Love <fx@gnu.org>
parents:
diff changeset
584 @item C-c C-f C-k
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
585 @kindex C-c C-f C-k
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
586 @findex message-goto-keywords
Dave Love <fx@gnu.org>
parents:
diff changeset
587 Go to the @code{Keywords} header (@code{message-goto-keywords}).
Dave Love <fx@gnu.org>
parents:
diff changeset
588
Dave Love <fx@gnu.org>
parents:
diff changeset
589 @item C-c C-f C-u
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
590 @kindex C-c C-f C-u
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
591 @findex message-goto-summary
Dave Love <fx@gnu.org>
parents:
diff changeset
592 Go to the @code{Summary} header (@code{message-goto-summary}).
Dave Love <fx@gnu.org>
parents:
diff changeset
593
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
594 @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
595 @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
596 @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
597 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
598 @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
599 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
600 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
601 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
602
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
603 @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
604 @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
605 @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
606 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
607 (@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
608 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
609 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
610 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
611 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
612 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
613 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
614
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
615 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
616 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
617 @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
618
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
619 @end table
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 @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
622
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
623 @table @kbd
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
624
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
625 @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
626 @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
627 @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
628 @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
629 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
630 (@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
631
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
632 @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
633 @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
634 @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
635 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
636 @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
637 (@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
638
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
639 @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
640 @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
641 @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
642 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
643 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
644 (@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
645
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
646 @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
647 @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
648 @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
649 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
650 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
651
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
652 @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
653 @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
654 @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
655 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
656 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
657 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
658 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
659
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
660 @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
661 @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
662 @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
663 @cindex Importance
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
664 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
665 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
666
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
667 @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
668 @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
669 @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
670 @cindex Importance
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
671 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
672 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
673
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
674 @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
675 @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
676 @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
677 @cindex Subject
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
678 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
679 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
680 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
681 (@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
682
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
683 @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
684 @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
685 @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
686 @vindex message-cross-post-default
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
687 @vindex message-cross-post-note-function
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
688 @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
689 @cindex cross-post
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
690 Set up the @samp{FollowUp-To} header with a target newsgroup for a
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
691 cross-post, add that target newsgroup to the @samp{Newsgroups} header if
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
692 it is not a member of @samp{Newsgroups}, and insert a note in the body.
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
693 If @code{message-cross-post-default} is @code{nil} or if this command is
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
694 called with a prefix-argument, only the @samp{FollowUp-To} header will
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
695 be set but the the target newsgroup will not be added to the
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
696 @samp{Newsgroups} header. The function to insert a note is controlled
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
697 by the @code{message-cross-post-note-function} variable.
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
698
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
699 @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
700 @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
701 @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
702 Replace contents of @samp{To} header with contents of @samp{Cc} or
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
703 @samp{Bcc} header. (Iff @samp{Cc} header is not present, @samp{Bcc}
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
704 header will be used instead.)
56927
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 w
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 w
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-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
709 Insert @samp{To} and @samp{Cc} headers as if you were doing a wide
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
710 reply even if the message was not made for a wide reply first.
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
711
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
712 @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
713 @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
714 @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
715 @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
716 @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
717 @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
718 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
719 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
720 @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
721 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
722 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
723 @code{nil}.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
724
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
725 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
726
Dave Love <fx@gnu.org>
parents:
diff changeset
727
Dave Love <fx@gnu.org>
parents:
diff changeset
728 @node Movement
Dave Love <fx@gnu.org>
parents:
diff changeset
729 @section Movement
Dave Love <fx@gnu.org>
parents:
diff changeset
730
Dave Love <fx@gnu.org>
parents:
diff changeset
731 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
732 @item C-c C-b
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
733 @kindex C-c C-b
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
734 @findex message-goto-body
Dave Love <fx@gnu.org>
parents:
diff changeset
735 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
736 (@code{message-goto-body}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
737
Dave Love <fx@gnu.org>
parents:
diff changeset
738 @item C-c C-i
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
739 @kindex C-c C-i
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
740 @findex message-goto-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
741 Move to the signature of the message (@code{message-goto-signature}).
Dave Love <fx@gnu.org>
parents:
diff changeset
742
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
743 @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
744 @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
745 @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
746 @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
747 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
748 beginning of header value. (The header value comes after the header
63600
c8b57e4594b8 Fix spellings.
Juanma Barranquero <lekktu@gmail.com>
parents: 61126
diff changeset
749 name and the colon.) This behavior can be disabled by toggling
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
750 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
751
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
752 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
753
Dave Love <fx@gnu.org>
parents:
diff changeset
754
Dave Love <fx@gnu.org>
parents:
diff changeset
755 @node Insertion
Dave Love <fx@gnu.org>
parents:
diff changeset
756 @section Insertion
Dave Love <fx@gnu.org>
parents:
diff changeset
757
Dave Love <fx@gnu.org>
parents:
diff changeset
758 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
759
Dave Love <fx@gnu.org>
parents:
diff changeset
760 @item C-c C-y
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
761 @kindex C-c C-y
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
762 @findex message-yank-original
Dave Love <fx@gnu.org>
parents:
diff changeset
763 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
764 (@code{message-yank-original}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
765
40705
421e0a91a1d1 Replace M-C- with C-M-
Eli Zaretskii <eliz@gnu.org>
parents: 38865
diff changeset
766 @item C-c C-M-y
421e0a91a1d1 Replace M-C- with C-M-
Eli Zaretskii <eliz@gnu.org>
parents: 38865
diff changeset
767 @kindex C-c C-M-y
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
768 @findex message-yank-buffer
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
769 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
770 message buffer (@code{message-yank-buffer}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
771
Dave Love <fx@gnu.org>
parents:
diff changeset
772 @item C-c C-q
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
773 @kindex C-c C-q
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
774 @findex message-fill-yanked-message
Dave Love <fx@gnu.org>
parents:
diff changeset
775 Fill the yanked message (@code{message-fill-yanked-message}). Warning:
Dave Love <fx@gnu.org>
parents:
diff changeset
776 Can severely mess up the yanked text if its quoting conventions are
Dave Love <fx@gnu.org>
parents:
diff changeset
777 strange. You'll quickly get a feel for when it's safe, though. Anyway,
Dave Love <fx@gnu.org>
parents:
diff changeset
778 just remember that @kbd{C-x u} (@code{undo}) is available and you'll be
Dave Love <fx@gnu.org>
parents:
diff changeset
779 all right.
Dave Love <fx@gnu.org>
parents:
diff changeset
780
Dave Love <fx@gnu.org>
parents:
diff changeset
781 @item C-c C-w
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
782 @kindex C-c C-w
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
783 @findex message-insert-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
784 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
785 (@code{message-insert-signature}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
786
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
787 @item C-c M-h
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
788 @kindex C-c M-h
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
789 @findex message-insert-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
790 Insert the message headers (@code{message-insert-headers}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
791
56927
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-m
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-m
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-inserted-region
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
795 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
796 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
797
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
798 @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
799 @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
800 @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
801 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
802 See @code{message-mark-insert-begin} and @code{message-mark-insert-end}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
803
Dave Love <fx@gnu.org>
parents:
diff changeset
804 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
805
Dave Love <fx@gnu.org>
parents:
diff changeset
806
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
807 @node MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
808 @section MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
809 @cindex MML
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
810 @cindex MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
811 @cindex multipart
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
812 @cindex attachment
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
813
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
814 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
815 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
816 automatically add the @code{Content-Type} and
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
817 @code{Content-Transfer-Encoding} headers.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
818
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
819 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
820 @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
821 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
822 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
823
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
824 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
825 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
826 Manual}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
827
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
828 @node IDNA
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
829 @section IDNA
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
830 @cindex IDNA
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
831 @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
832 @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
833
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
834 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
835 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
836 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
837 @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
838
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
839 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
840 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
841 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
842 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
843 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
844
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
845 @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
846 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
847 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
848 ever happen, if it is set to the symbol @code{ask} the user will be
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
849 queried, and if set to @code{t} (which is the default if @acronym{IDNA}
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
850 is fully available) @acronym{IDNA} encoding happens automatically.
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
851
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
852 @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
853 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
854 invoke @kbd{M-x message-idna-to-ascii-rhs RET} in the message buffer
65742
8e46fef0174c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-566
Miles Bader <miles@gnu.org>
parents: 65555
diff changeset
855 to have the non-@acronym{ASCII} domain names encoded while you edit
8e46fef0174c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-566
Miles Bader <miles@gnu.org>
parents: 65555
diff changeset
856 the message.
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
857
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
858 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
859 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
860
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
861 @node Security
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
862 @section Security
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
863 @cindex Security
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
864 @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
865 @cindex PGP
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
866 @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
867 @cindex sign
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
868 @cindex encrypt
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
869 @cindex secure
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
870
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
871 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
872 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
873 @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
874 @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
875 @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
876 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
877 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
878
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
879 @table @kbd
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
880
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
881 @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
882 @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
883 @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
884
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
885 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
886
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
887 @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
888 @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
889 @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
890
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
891 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
892
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
893 @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
894 @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
895 @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
896
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
897 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
898
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
899 @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
900 @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
901 @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
902
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
903 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
904
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
905 @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
906 @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
907 @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
908
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
909 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
910
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
911 @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
912 @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
913 @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
914
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
915 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
916
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
917 @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
918 @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
919 @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
920 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
921
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
922 @end table
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
923
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
924 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
925 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
926 @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
927 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
928 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
929 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
930 @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
931 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
932 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
933 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
934 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
935 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
936
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
937 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
938 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
939 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
940 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
941 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
942 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
943 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
944 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
945
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
946 @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
947 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
948 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
949
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
950 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
951 ``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
952 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
953 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
954 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
955
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
956 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
957 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
958 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
959 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
960
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
961 @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
962
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
963 @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
964 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
965 so on.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
966
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
967 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
968 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
969 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
970 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
971 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
972 @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
973 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
974 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
975 contest.)
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
976
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
977 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
978 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
979 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
980 @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
981 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
982 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
983 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
984 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
985 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
986 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
987 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
988 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
989 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
990 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
991 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
992
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
993 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
994 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
995 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
996 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
997 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
998 @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
999
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1000 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
1001 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
1002 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
1003 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
1004 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
1005 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
1006 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
1007
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1008 @example
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1009 $ 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
1010 @end example
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1011
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1012 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
1013 @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
1014
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1015 @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
1016 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
1017 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
1018 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
1019 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
1020 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
1021 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
1022
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1023 @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
1024
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1025 @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
1026 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
1027 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
1028 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
1029 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
1030 @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
1031
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1032 @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
1033 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
1034 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
1035 0700.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1036
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1037 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
1038 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
1039
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1040 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
1041 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
1042 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
1043 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
1044 @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
1045 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
1046 available from
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1047 @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
1048 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
1049 @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
1050 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
1051 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
1052 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
1053 @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
1054
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1055 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1056 (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
1057 ("pgp" separate)
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1058 ("pgpauto" separate)
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1059 ("pgpmime" separate)))
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1060 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1061
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1062 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
1063 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
1064
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1065 (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
1066 information about the problem.)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1067
Dave Love <fx@gnu.org>
parents:
diff changeset
1068 @node Various Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
1069 @section Various Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
1070
Dave Love <fx@gnu.org>
parents:
diff changeset
1071 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
1072
Dave Love <fx@gnu.org>
parents:
diff changeset
1073 @item C-c C-r
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1074 @kindex C-c C-r
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1075 @findex message-caesar-buffer-body
Dave Love <fx@gnu.org>
parents:
diff changeset
1076 Caesar rotate (aka. rot13) the current message
Dave Love <fx@gnu.org>
parents:
diff changeset
1077 (@code{message-caesar-buffer-body}). If narrowing is in effect, just
Dave Love <fx@gnu.org>
parents:
diff changeset
1078 rotate the visible portion of the buffer. A numerical prefix says how
Dave Love <fx@gnu.org>
parents:
diff changeset
1079 many places to rotate the text. The default is 13.
Dave Love <fx@gnu.org>
parents:
diff changeset
1080
Dave Love <fx@gnu.org>
parents:
diff changeset
1081 @item C-c C-e
Dave Love <fx@gnu.org>
parents:
diff changeset
1082 @kindex C-c C-e
Dave Love <fx@gnu.org>
parents:
diff changeset
1083 @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
1084 @vindex message-elide-ellipsis
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1085 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
1086 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
1087 @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
1088 (@samp{[...]}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1089
Dave Love <fx@gnu.org>
parents:
diff changeset
1090 @item C-c C-z
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1091 @kindex C-c C-z
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1092 @findex message-kill-to-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
1093 Kill all the text up to the signature, or if that's missing, up to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1094 end of the message (@code{message-kill-to-signature}).
Dave Love <fx@gnu.org>
parents:
diff changeset
1095
Dave Love <fx@gnu.org>
parents:
diff changeset
1096 @item C-c C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
1097 @kindex C-c C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
1098 @findex message-delete-not-region
Dave Love <fx@gnu.org>
parents:
diff changeset
1099 Delete all text in the body of the message that is outside the region
Dave Love <fx@gnu.org>
parents:
diff changeset
1100 (@code{message-delete-not-region}).
Dave Love <fx@gnu.org>
parents:
diff changeset
1101
Dave Love <fx@gnu.org>
parents:
diff changeset
1102 @item M-RET
Dave Love <fx@gnu.org>
parents:
diff changeset
1103 @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
1104 @findex message-newline-and-reformat
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1105 Insert four newlines, and then reformat if inside quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
1106
Dave Love <fx@gnu.org>
parents:
diff changeset
1107 Here's an example:
Dave Love <fx@gnu.org>
parents:
diff changeset
1108
Dave Love <fx@gnu.org>
parents:
diff changeset
1109 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1110 > This is some quoted text. And here's more quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
1111 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1112
Dave Love <fx@gnu.org>
parents:
diff changeset
1113 If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
Dave Love <fx@gnu.org>
parents:
diff changeset
1114
Dave Love <fx@gnu.org>
parents:
diff changeset
1115 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1116 > This is some quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
1117
Dave Love <fx@gnu.org>
parents:
diff changeset
1118 *
Dave Love <fx@gnu.org>
parents:
diff changeset
1119
Dave Love <fx@gnu.org>
parents:
diff changeset
1120 > And here's more quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
1121 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1122
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1123 @samp{*} says where point will be placed.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1124
Dave Love <fx@gnu.org>
parents:
diff changeset
1125 @item C-c M-r
Dave Love <fx@gnu.org>
parents:
diff changeset
1126 @kindex C-c M-r
Dave Love <fx@gnu.org>
parents:
diff changeset
1127 @findex message-rename-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
1128 Rename the buffer (@code{message-rename-buffer}). If given a prefix,
Dave Love <fx@gnu.org>
parents:
diff changeset
1129 prompt for a new buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
1130
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1131 @item TAB
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1132 @kindex TAB
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1133 @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
1134 @vindex message-tab-body-function
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1135 If @code{message-tab-body-function} is non-@code{nil}, execute the
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1136 function it specifies. Otherwise use the function bound to @kbd{TAB} in
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1137 @code{text-mode-map} or @code{global-map}.
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1138
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1139 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1140
Dave Love <fx@gnu.org>
parents:
diff changeset
1141
Dave Love <fx@gnu.org>
parents:
diff changeset
1142 @node Sending
Dave Love <fx@gnu.org>
parents:
diff changeset
1143 @section Sending
Dave Love <fx@gnu.org>
parents:
diff changeset
1144
Dave Love <fx@gnu.org>
parents:
diff changeset
1145 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
1146 @item C-c C-c
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1147 @kindex C-c C-c
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1148 @findex message-send-and-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
1149 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
1150 (@code{message-send-and-exit}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1151
Dave Love <fx@gnu.org>
parents:
diff changeset
1152 @item C-c C-s
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1153 @kindex C-c C-s
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1154 @findex message-send
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1155 Send the message (@code{message-send}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1156
Dave Love <fx@gnu.org>
parents:
diff changeset
1157 @item C-c C-d
Dave Love <fx@gnu.org>
parents:
diff changeset
1158 @kindex C-c C-d
Dave Love <fx@gnu.org>
parents:
diff changeset
1159 @findex message-dont-send
Dave Love <fx@gnu.org>
parents:
diff changeset
1160 Bury the message buffer and exit (@code{message-dont-send}).
Dave Love <fx@gnu.org>
parents:
diff changeset
1161
Dave Love <fx@gnu.org>
parents:
diff changeset
1162 @item C-c C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
1163 @kindex C-c C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
1164 @findex message-kill-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
1165 Kill the message buffer and exit (@code{message-kill-buffer}).
Dave Love <fx@gnu.org>
parents:
diff changeset
1166
Dave Love <fx@gnu.org>
parents:
diff changeset
1167 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1168
Dave Love <fx@gnu.org>
parents:
diff changeset
1169
Dave Love <fx@gnu.org>
parents:
diff changeset
1170
Dave Love <fx@gnu.org>
parents:
diff changeset
1171 @node Mail Aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
1172 @section Mail Aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
1173 @cindex mail aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
1174 @cindex aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
1175
Dave Love <fx@gnu.org>
parents:
diff changeset
1176 @vindex message-mail-alias-type
Dave Love <fx@gnu.org>
parents:
diff changeset
1177 The @code{message-mail-alias-type} variable controls what type of mail
Dave Love <fx@gnu.org>
parents:
diff changeset
1178 alias expansion to use. Currently only one form is supported---Message
Dave Love <fx@gnu.org>
parents:
diff changeset
1179 uses @code{mailabbrev} to handle mail aliases. If this variable is
Dave Love <fx@gnu.org>
parents:
diff changeset
1180 @code{nil}, no mail alias expansion will be performed.
Dave Love <fx@gnu.org>
parents:
diff changeset
1181
Dave Love <fx@gnu.org>
parents:
diff changeset
1182 @code{mailabbrev} works by parsing the @file{/etc/mailrc} and
Dave Love <fx@gnu.org>
parents:
diff changeset
1183 @file{~/.mailrc} files. These files look like:
Dave Love <fx@gnu.org>
parents:
diff changeset
1184
Dave Love <fx@gnu.org>
parents:
diff changeset
1185 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1186 alias lmi "Lars Magne Ingebrigtsen <larsi@@ifi.uio.no>"
Dave Love <fx@gnu.org>
parents:
diff changeset
1187 alias ding "ding@@ifi.uio.no (ding mailing list)"
Dave Love <fx@gnu.org>
parents:
diff changeset
1188 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1189
Dave Love <fx@gnu.org>
parents:
diff changeset
1190 After adding lines like this to your @file{~/.mailrc} file, you should
Dave Love <fx@gnu.org>
parents:
diff changeset
1191 be able to just write @samp{lmi} in the @code{To} or @code{Cc} (and so
Dave Love <fx@gnu.org>
parents:
diff changeset
1192 on) headers and press @kbd{SPC} to expand the alias.
Dave Love <fx@gnu.org>
parents:
diff changeset
1193
Dave Love <fx@gnu.org>
parents:
diff changeset
1194 No expansion will be performed upon sending of the message---all
Dave Love <fx@gnu.org>
parents:
diff changeset
1195 expansions have to be done explicitly.
Dave Love <fx@gnu.org>
parents:
diff changeset
1196
Dave Love <fx@gnu.org>
parents:
diff changeset
1197
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1198 @node Spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1199 @section Spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1200 @cindex spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1201 @findex ispell-message
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 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
1204 @code{ispell} and @code{flyspell}. @code{ispell} is the older and
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1205 probably more popular package. You typically first write the message,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1206 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
1207 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
1208 something like the following in your @file{.emacs} file:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1209
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1210 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1211 (add-hook 'message-send-hook 'ispell-message)
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1212 @end lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1213
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1214 @vindex ispell-message-dictionary-alist
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1215 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
1216 controlled by the @code{ispell-message-dictionary-alist} variable:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1217
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1218 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1219 (setq ispell-message-dictionary-alist
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1220 '(("^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
1221 (".*" . "default")))
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1222 @end lisp
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 @code{ispell} depends on having the external @samp{ispell} command
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1225 installed.
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 The other popular method is using @code{flyspell}. This package checks
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1228 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
1229 various ways.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1230
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1231 To use @code{flyspell}, put something like the following in your
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1232 @file{.emacs} file:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1233
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1234 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1235 (defun my-message-setup-routine ()
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1236 (flyspell-mode 1))
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1237 (add-hook 'message-setup-hook 'my-message-setup-routine)
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1238 @end lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1239
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1240 @code{flyspell} depends on having the external @samp{ispell} command
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1241 installed.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1242
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1243
Dave Love <fx@gnu.org>
parents:
diff changeset
1244 @node Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1245 @chapter Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1246
Dave Love <fx@gnu.org>
parents:
diff changeset
1247 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1248 * Message Headers:: General message header stuff.
Dave Love <fx@gnu.org>
parents:
diff changeset
1249 * Mail Headers:: Customizing mail headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1250 * Mail Variables:: Other mail variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
1251 * News Headers:: Customizing news headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1252 * 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
1253 * Insertion Variables:: Customizing how things are inserted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1254 * Various Message Variables:: Other message variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
1255 * Sending Variables:: Variables for sending.
Dave Love <fx@gnu.org>
parents:
diff changeset
1256 * Message Buffers:: How Message names its buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1257 * Message Actions:: Actions to be performed when exiting.
Dave Love <fx@gnu.org>
parents:
diff changeset
1258 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1259
Dave Love <fx@gnu.org>
parents:
diff changeset
1260
Dave Love <fx@gnu.org>
parents:
diff changeset
1261 @node Message Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1262 @section Message Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1263
Dave Love <fx@gnu.org>
parents:
diff changeset
1264 Message is quite aggressive on the message generation front. It has to
Dave Love <fx@gnu.org>
parents:
diff changeset
1265 be -- it's a combined news and mail agent. To be able to send combined
Dave Love <fx@gnu.org>
parents:
diff changeset
1266 messages, it has to generate all headers itself (instead of letting the
Dave Love <fx@gnu.org>
parents:
diff changeset
1267 mail/news system do it) to ensure that mail and news copies of messages
Dave Love <fx@gnu.org>
parents:
diff changeset
1268 look sufficiently similar.
Dave Love <fx@gnu.org>
parents:
diff changeset
1269
Dave Love <fx@gnu.org>
parents:
diff changeset
1270 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1271
Dave Love <fx@gnu.org>
parents:
diff changeset
1272 @item message-generate-headers-first
Dave Love <fx@gnu.org>
parents:
diff changeset
1273 @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
1274 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
1275 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
1276
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1277 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1278 (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
1279 '(References))
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1280 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1281
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1282 @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
1283 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
1284 @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
1285 @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
1286 required.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1287
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1288 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
1289 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
1290
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1291 @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
1292 @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
1293 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
1294 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
1295 should be generated when a draft is written to the draft group.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1296
Dave Love <fx@gnu.org>
parents:
diff changeset
1297 @item message-from-style
Dave Love <fx@gnu.org>
parents:
diff changeset
1298 @vindex message-from-style
Dave Love <fx@gnu.org>
parents:
diff changeset
1299 Specifies how @code{From} headers should look. There are four valid
Dave Love <fx@gnu.org>
parents:
diff changeset
1300 values:
Dave Love <fx@gnu.org>
parents:
diff changeset
1301
Dave Love <fx@gnu.org>
parents:
diff changeset
1302 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1303 @item nil
Dave Love <fx@gnu.org>
parents:
diff changeset
1304 Just the address -- @samp{king@@grassland.com}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1305
Dave Love <fx@gnu.org>
parents:
diff changeset
1306 @item parens
Dave Love <fx@gnu.org>
parents:
diff changeset
1307 @samp{king@@grassland.com (Elvis Parsley)}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1308
Dave Love <fx@gnu.org>
parents:
diff changeset
1309 @item angles
Dave Love <fx@gnu.org>
parents:
diff changeset
1310 @samp{Elvis Parsley <king@@grassland.com>}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1311
Dave Love <fx@gnu.org>
parents:
diff changeset
1312 @item default
Dave Love <fx@gnu.org>
parents:
diff changeset
1313 Look like @code{angles} if that doesn't require quoting, and
Dave Love <fx@gnu.org>
parents:
diff changeset
1314 @code{parens} if it does. If even @code{parens} requires quoting, use
Dave Love <fx@gnu.org>
parents:
diff changeset
1315 @code{angles} anyway.
Dave Love <fx@gnu.org>
parents:
diff changeset
1316
Dave Love <fx@gnu.org>
parents:
diff changeset
1317 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1318
Dave Love <fx@gnu.org>
parents:
diff changeset
1319 @item message-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1320 @vindex message-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1321 Headers in this list that were previously generated by Message will be
Dave Love <fx@gnu.org>
parents:
diff changeset
1322 deleted before posting. Let's say you post an article. Then you decide
Dave Love <fx@gnu.org>
parents:
diff changeset
1323 to post it again to some other group, you naughty boy, so you jump back
Dave Love <fx@gnu.org>
parents:
diff changeset
1324 to the @code{*post-buf*} buffer, edit the @code{Newsgroups} line, and
Dave Love <fx@gnu.org>
parents:
diff changeset
1325 ship it off again. By default, this variable makes sure that the old
Dave Love <fx@gnu.org>
parents:
diff changeset
1326 generated @code{Message-ID} is deleted, and a new one generated. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1327 this isn't done, the entire empire would probably crumble, anarchy would
Dave Love <fx@gnu.org>
parents:
diff changeset
1328 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
1329 Allegedly.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1330
Dave Love <fx@gnu.org>
parents:
diff changeset
1331 @item message-default-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1332 @vindex message-default-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1333 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
1334 buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1335
Dave Love <fx@gnu.org>
parents:
diff changeset
1336 @item message-subject-re-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
1337 @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
1338 @cindex Aw
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1339 @cindex Sv
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1340 @cindex Re
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1341 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
1342 is @emph{not} an abbreviation of the English word ``response'', but is
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1343 Latin, and means ``in response to''. Some illiterate nincompoops have
Dave Love <fx@gnu.org>
parents:
diff changeset
1344 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
1345 to use abominations like @samp{Aw: } (``antwort'') or @samp{Sv: }
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1346 (``svar'') instead, which is meaningless and evil. However, you may
Dave Love <fx@gnu.org>
parents:
diff changeset
1347 have to deal with users that use these evil tools, in which case you may
Dave Love <fx@gnu.org>
parents:
diff changeset
1348 set this variable to a regexp that matches these prefixes. Myself, I
Dave Love <fx@gnu.org>
parents:
diff changeset
1349 just throw away non-compliant mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
1350
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1351 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
1352 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
1353
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1354 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1355 (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
1356 (concat
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1357 "^[ \t]*"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1358 "\\("
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1359 "\\("
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1360 "[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
1361 "[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
1362 "[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
1363 "[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
1364 "[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
1365 "[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
1366 "[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
1367 "\\)"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1368 "\\(\\[[0-9]*\\]\\)"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1369 "*:[ \t]*"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1370 "\\)"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1371 "*[ \t]*"
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1372 ))
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1373 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1374
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1375 @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
1376 @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
1377 @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
1378 @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
1379 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
1380 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
1381 @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
1382 matched against @code{message-subject-trailing-was-ask-regexp}. If
63673
574430323b5c (Message Headers): Texinfo usage fix.
Juanma Barranquero <lekktu@gmail.com>
parents: 63636
diff changeset
1383 @code{message-subject-trailing-was-query} is @code{t}, always strip the
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1384 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
1385 @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
1386
32314
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
1387 @item message-alternative-emails
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
1388 @vindex message-alternative-emails
68521
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1389 Regexp matching alternative email addresses. The first address in the
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1390 To, Cc or From headers of the original article matching this variable is
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1391 used as the From field of outgoing messages, replacing the default From
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1392 value.
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1393
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1394 For example, if you have two secondary email addresses john@@home.net
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1395 and john.doe@@work.com and want to use them in the From field when
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1396 composing a reply to a message addressed to one of them, you could set
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1397 this variable like this:
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1398
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1399 @lisp
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1400 (setq message-alternative-emails
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1401 (regexp-opt '("john@@home.net" "john.doe@@work.com")))
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1402 @end lisp
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1403
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1404 This variable has precedence over posting styles and anything that runs
04c2548593f7 Revision: emacs@sv.gnu.org/emacs--devo--0--patch-33
Miles Bader <miles@gnu.org>
parents: 67418
diff changeset
1405 off @code{message-setup-hook}.
32314
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
1406
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1407 @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
1408 @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
1409 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
1410 @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
1411 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
1412 @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
1413
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1414 @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
1415 @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
1416 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
1417 @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
1418 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
1419
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1420 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1421 (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
1422 '(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
1423 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1424
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1425 @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
1426 @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
1427 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
1428 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
1429 @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
1430 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
1431
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1432 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1433
Dave Love <fx@gnu.org>
parents:
diff changeset
1434
Dave Love <fx@gnu.org>
parents:
diff changeset
1435 @node Mail Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1436 @section Mail Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1437
Dave Love <fx@gnu.org>
parents:
diff changeset
1438 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1439 @item message-required-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1440 @vindex message-required-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1441 @xref{News Headers}, for the syntax of this variable. It is
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1442 @code{(From Subject Date (optional . In-Reply-To) Message-ID
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1443 (optional . User-Agent))} by default.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1444
Dave Love <fx@gnu.org>
parents:
diff changeset
1445 @item message-ignored-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1446 @vindex message-ignored-mail-headers
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1447 Regexp of headers to be removed before mailing. The default is@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1448 @samp{^[GF]cc:\\|^Resent-Fcc:\\|^Xref:\\|^X-Draft-From:\\|@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1449 ^X-Gnus-Agent-Meta-Information:}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1450
Dave Love <fx@gnu.org>
parents:
diff changeset
1451 @item message-default-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1452 @vindex message-default-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1453 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
1454 buffers that are initialized as mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
1455
Dave Love <fx@gnu.org>
parents:
diff changeset
1456 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1457
Dave Love <fx@gnu.org>
parents:
diff changeset
1458
Dave Love <fx@gnu.org>
parents:
diff changeset
1459 @node Mail Variables
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1460 @section Mail Variables
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1461
Dave Love <fx@gnu.org>
parents:
diff changeset
1462 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1463 @item message-send-mail-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1464 @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
1465 @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
1466 @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
1467 @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
1468 @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
1469 @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
1470 @findex feedmail-send-it
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1471 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
1472 @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
1473 @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
1474 @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
1475 @code{feedmail-send-it}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1476
Dave Love <fx@gnu.org>
parents:
diff changeset
1477 @item message-mh-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1478 @vindex message-mh-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1479 Most versions of MH doesn't like being fed messages that contain the
Dave Love <fx@gnu.org>
parents:
diff changeset
1480 headers in this variable. If this variable is non-@code{nil} (which is
Dave Love <fx@gnu.org>
parents:
diff changeset
1481 the default), these headers will be removed before mailing when sending
Dave Love <fx@gnu.org>
parents:
diff changeset
1482 messages via MH. Set it to @code{nil} if your MH can handle these
Dave Love <fx@gnu.org>
parents:
diff changeset
1483 headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1484
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1485 @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
1486 @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
1487 @cindex qmail
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1488 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
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-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
1491 @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
1492 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
1493 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
1494 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
1495
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1496 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
1497 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
1498 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
1499
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1500 @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
1501 @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
1502 @cindex sendmail
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1503 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
1504 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
1505
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1506 @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
1507 @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
1508 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
1509 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
1510 @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
1511 @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
1512
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1513 @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
1514 @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
1515 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
1516 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
1517 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
1518 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
1519
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1520 @item message-send-mail-partially-limit
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1521 @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
1522 @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
1523 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
1524 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
1525 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
1526
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1527 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1528
Dave Love <fx@gnu.org>
parents:
diff changeset
1529
Dave Love <fx@gnu.org>
parents:
diff changeset
1530 @node News Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1531 @section News Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1532
Dave Love <fx@gnu.org>
parents:
diff changeset
1533 @vindex message-required-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1534 @code{message-required-news-headers} a list of header symbols. These
Dave Love <fx@gnu.org>
parents:
diff changeset
1535 headers will either be automatically generated, or, if that's
Dave Love <fx@gnu.org>
parents:
diff changeset
1536 impossible, they will be prompted for. The following symbols are valid:
Dave Love <fx@gnu.org>
parents:
diff changeset
1537
Dave Love <fx@gnu.org>
parents:
diff changeset
1538 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1539
Dave Love <fx@gnu.org>
parents:
diff changeset
1540 @item From
Dave Love <fx@gnu.org>
parents:
diff changeset
1541 @cindex From
Dave Love <fx@gnu.org>
parents:
diff changeset
1542 @findex user-full-name
Dave Love <fx@gnu.org>
parents:
diff changeset
1543 @findex user-mail-address
Dave Love <fx@gnu.org>
parents:
diff changeset
1544 This required header will be filled out with the result of the
Dave Love <fx@gnu.org>
parents:
diff changeset
1545 @code{message-make-from} function, which depends on the
Dave Love <fx@gnu.org>
parents:
diff changeset
1546 @code{message-from-style}, @code{user-full-name},
Dave Love <fx@gnu.org>
parents:
diff changeset
1547 @code{user-mail-address} variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
1548
Dave Love <fx@gnu.org>
parents:
diff changeset
1549 @item Subject
Dave Love <fx@gnu.org>
parents:
diff changeset
1550 @cindex Subject
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1551 This required header will be prompted for if not present already.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1552
Dave Love <fx@gnu.org>
parents:
diff changeset
1553 @item Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1554 @cindex Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1555 This required header says which newsgroups the article is to be posted
Dave Love <fx@gnu.org>
parents:
diff changeset
1556 to. If it isn't present already, it will be prompted for.
Dave Love <fx@gnu.org>
parents:
diff changeset
1557
Dave Love <fx@gnu.org>
parents:
diff changeset
1558 @item Organization
Dave Love <fx@gnu.org>
parents:
diff changeset
1559 @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
1560 @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
1561 @vindex message-user-organization-file
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1562 This optional header will be filled out depending on the
Dave Love <fx@gnu.org>
parents:
diff changeset
1563 @code{message-user-organization} variable.
Dave Love <fx@gnu.org>
parents:
diff changeset
1564 @code{message-user-organization-file} will be used if this variable is
Dave Love <fx@gnu.org>
parents:
diff changeset
1565 @code{t}. This variable can also be a string (in which case this string
Dave Love <fx@gnu.org>
parents:
diff changeset
1566 will be used), or it can be a function (which will be called with no
Dave Love <fx@gnu.org>
parents:
diff changeset
1567 parameters and should return a string to be used).
Dave Love <fx@gnu.org>
parents:
diff changeset
1568
Dave Love <fx@gnu.org>
parents:
diff changeset
1569 @item Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1570 @cindex Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1571 This optional header will be computed by Message.
Dave Love <fx@gnu.org>
parents:
diff changeset
1572
Dave Love <fx@gnu.org>
parents:
diff changeset
1573 @item Message-ID
Dave Love <fx@gnu.org>
parents:
diff changeset
1574 @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
1575 @vindex message-user-fqdn
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1576 @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
1577 @vindex user-mail-address
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1578 @findex system-name
Dave Love <fx@gnu.org>
parents:
diff changeset
1579 @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
1580 @cindex i-did-not-set--mail-host-address--so-tickle-me
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1581 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
1582 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
1583 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
1584 @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
1585 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
1586 until a probably valid fully qualified domain name (FQDN) was found.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1587
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1588 @item User-Agent
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1589 @cindex User-Agent
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1590 This optional header will be filled out according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1591 @code{message-newsreader} local variable.
Dave Love <fx@gnu.org>
parents:
diff changeset
1592
Dave Love <fx@gnu.org>
parents:
diff changeset
1593 @item In-Reply-To
Dave Love <fx@gnu.org>
parents:
diff changeset
1594 This optional header is filled out using the @code{Date} and @code{From}
Dave Love <fx@gnu.org>
parents:
diff changeset
1595 header of the article being replied to.
Dave Love <fx@gnu.org>
parents:
diff changeset
1596
Dave Love <fx@gnu.org>
parents:
diff changeset
1597 @item Expires
Dave Love <fx@gnu.org>
parents:
diff changeset
1598 @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
1599 @vindex message-expires
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1600 This extremely optional header will be inserted according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1601 @code{message-expires} variable. It is highly deprecated and shouldn't
Dave Love <fx@gnu.org>
parents:
diff changeset
1602 be used unless you know what you're doing.
Dave Love <fx@gnu.org>
parents:
diff changeset
1603
Dave Love <fx@gnu.org>
parents:
diff changeset
1604 @item Distribution
Dave Love <fx@gnu.org>
parents:
diff changeset
1605 @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
1606 @vindex message-distribution-function
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1607 This optional header is filled out according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
1608 @code{message-distribution-function} variable. It is a deprecated and
Dave Love <fx@gnu.org>
parents:
diff changeset
1609 much misunderstood header.
Dave Love <fx@gnu.org>
parents:
diff changeset
1610
Dave Love <fx@gnu.org>
parents:
diff changeset
1611 @item Path
Dave Love <fx@gnu.org>
parents:
diff changeset
1612 @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
1613 @vindex message-user-path
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1614 This extremely optional header should probably never be used.
Dave Love <fx@gnu.org>
parents:
diff changeset
1615 However, some @emph{very} old servers require that this header is
Dave Love <fx@gnu.org>
parents:
diff changeset
1616 present. @code{message-user-path} further controls how this
Dave Love <fx@gnu.org>
parents:
diff changeset
1617 @code{Path} header is to look. If it is @code{nil}, use the server name
Dave Love <fx@gnu.org>
parents:
diff changeset
1618 as the leaf node. If it is a string, use the string. If it is neither
Dave Love <fx@gnu.org>
parents:
diff changeset
1619 a string nor @code{nil}, use the user name only. However, it is highly
Dave Love <fx@gnu.org>
parents:
diff changeset
1620 unlikely that you should need to fiddle with this variable at all.
Dave Love <fx@gnu.org>
parents:
diff changeset
1621 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1622
Dave Love <fx@gnu.org>
parents:
diff changeset
1623 @findex yow
Dave Love <fx@gnu.org>
parents:
diff changeset
1624 @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
1625 In addition, you can enter conses into this list. The @sc{car} of this cons
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1626 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
1627 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
1628 this header, or it can be a function to be called. This function should
Dave Love <fx@gnu.org>
parents:
diff changeset
1629 return a string to be inserted. For instance, if you want to insert
Dave Love <fx@gnu.org>
parents:
diff changeset
1630 @code{Mime-Version: 1.0}, you should enter @code{(Mime-Version . "1.0")}
Dave Love <fx@gnu.org>
parents:
diff changeset
1631 into the list. If you want to insert a funny quote, you could enter
Dave Love <fx@gnu.org>
parents:
diff changeset
1632 something like @code{(X-Yow . yow)} into the list. The function
Dave Love <fx@gnu.org>
parents:
diff changeset
1633 @code{yow} will then be called without any arguments.
Dave Love <fx@gnu.org>
parents:
diff changeset
1634
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1635 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
1636 @code{optional}, the @sc{cdr} of this cons will only be inserted if it is
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1637 non-@code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1638
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1639 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
1640 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
1641 another element.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1642
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1643 @lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1644 (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
1645 (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
1646 @end lisp
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1647
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1648 Other variables for customizing outgoing news articles:
Dave Love <fx@gnu.org>
parents:
diff changeset
1649
Dave Love <fx@gnu.org>
parents:
diff changeset
1650 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1651
Dave Love <fx@gnu.org>
parents:
diff changeset
1652 @item message-syntax-checks
Dave Love <fx@gnu.org>
parents:
diff changeset
1653 @vindex message-syntax-checks
Dave Love <fx@gnu.org>
parents:
diff changeset
1654 Controls what syntax checks should not be performed on outgoing posts.
Dave Love <fx@gnu.org>
parents:
diff changeset
1655 To disable checking of long signatures, for instance, add
Dave Love <fx@gnu.org>
parents:
diff changeset
1656
Dave Love <fx@gnu.org>
parents:
diff changeset
1657 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1658 (signature . disabled)
Dave Love <fx@gnu.org>
parents:
diff changeset
1659 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1660
Dave Love <fx@gnu.org>
parents:
diff changeset
1661 to this list.
Dave Love <fx@gnu.org>
parents:
diff changeset
1662
Dave Love <fx@gnu.org>
parents:
diff changeset
1663 Valid checks are:
Dave Love <fx@gnu.org>
parents:
diff changeset
1664
Dave Love <fx@gnu.org>
parents:
diff changeset
1665 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1666 @item subject-cmsg
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1667 Check the subject for commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
1668 @item sender
Dave Love <fx@gnu.org>
parents:
diff changeset
1669 @cindex Sender
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1670 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
1671 @item multiple-headers
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1672 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
1673 @item sendsys
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1674 @cindex sendsys
Dave Love <fx@gnu.org>
parents:
diff changeset
1675 Check for the existence of version and sendsys commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
1676 @item message-id
Dave Love <fx@gnu.org>
parents:
diff changeset
1677 Check whether the @code{Message-ID} looks ok.
Dave Love <fx@gnu.org>
parents:
diff changeset
1678 @item from
Dave Love <fx@gnu.org>
parents:
diff changeset
1679 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
1680 @item long-lines
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1681 @cindex long lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1682 Check for too long lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
1683 @item control-chars
Dave Love <fx@gnu.org>
parents:
diff changeset
1684 Check for invalid characters.
Dave Love <fx@gnu.org>
parents:
diff changeset
1685 @item size
Dave Love <fx@gnu.org>
parents:
diff changeset
1686 Check for excessive size.
Dave Love <fx@gnu.org>
parents:
diff changeset
1687 @item new-text
Dave Love <fx@gnu.org>
parents:
diff changeset
1688 Check whether there is any new text in the messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1689 @item signature
Dave Love <fx@gnu.org>
parents:
diff changeset
1690 Check the length of the signature.
Dave Love <fx@gnu.org>
parents:
diff changeset
1691 @item approved
Dave Love <fx@gnu.org>
parents:
diff changeset
1692 @cindex approved
Dave Love <fx@gnu.org>
parents:
diff changeset
1693 Check whether the article has an @code{Approved} header, which is
Dave Love <fx@gnu.org>
parents:
diff changeset
1694 something only moderators should include.
Dave Love <fx@gnu.org>
parents:
diff changeset
1695 @item empty
Dave Love <fx@gnu.org>
parents:
diff changeset
1696 Check whether the article is empty.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1697 @item invisible-text
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1698 Check whether there is any invisible text in the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1699 @item empty-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1700 Check whether any of the headers are empty.
Dave Love <fx@gnu.org>
parents:
diff changeset
1701 @item existing-newsgroups
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1702 Check whether the newsgroups mentioned in the @code{Newsgroups} and
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1703 @code{Followup-To} headers exist.
Dave Love <fx@gnu.org>
parents:
diff changeset
1704 @item valid-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1705 Check whether the @code{Newsgroups} and @code{Followup-to} headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1706 are valid syntactically.
Dave Love <fx@gnu.org>
parents:
diff changeset
1707 @item repeated-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1708 Check whether the @code{Newsgroups} and @code{Followup-to} headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1709 contains repeated group names.
Dave Love <fx@gnu.org>
parents:
diff changeset
1710 @item shorten-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
1711 Check whether to add a @code{Followup-to} header to shorten the number
Dave Love <fx@gnu.org>
parents:
diff changeset
1712 of groups to post to.
Dave Love <fx@gnu.org>
parents:
diff changeset
1713 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1714
Dave Love <fx@gnu.org>
parents:
diff changeset
1715 All these conditions are checked by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1716
Dave Love <fx@gnu.org>
parents:
diff changeset
1717 @item message-ignored-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1718 @vindex message-ignored-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1719 Regexp of headers to be removed before posting. The default is@*
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1720 @samp{^NNTP-Posting-Host:\\|^Xref:\\|^[BGF]cc:\\|^Resent-Fcc:\\|@*
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1721 ^X-Draft-From:\\|^X-Gnus-Agent-Meta-Information:}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1722
Dave Love <fx@gnu.org>
parents:
diff changeset
1723 @item message-default-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1724 @vindex message-default-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1725 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
1726 buffers that are initialized as news.
Dave Love <fx@gnu.org>
parents:
diff changeset
1727
Dave Love <fx@gnu.org>
parents:
diff changeset
1728 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1729
Dave Love <fx@gnu.org>
parents:
diff changeset
1730
Dave Love <fx@gnu.org>
parents:
diff changeset
1731 @node News Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1732 @section News Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1733
Dave Love <fx@gnu.org>
parents:
diff changeset
1734 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1735 @item message-send-news-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1736 @vindex message-send-news-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1737 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
1738 @code{message-send-news}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1739
Dave Love <fx@gnu.org>
parents:
diff changeset
1740 @item message-post-method
Dave Love <fx@gnu.org>
parents:
diff changeset
1741 @vindex message-post-method
Dave Love <fx@gnu.org>
parents:
diff changeset
1742 Gnusish @dfn{select method} (see the Gnus manual for details) used for
Dave Love <fx@gnu.org>
parents:
diff changeset
1743 posting a prepared news message.
Dave Love <fx@gnu.org>
parents:
diff changeset
1744
Dave Love <fx@gnu.org>
parents:
diff changeset
1745 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1746
Dave Love <fx@gnu.org>
parents:
diff changeset
1747
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1748 @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
1749 @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
1750
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1751 @table @code
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1752 @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
1753 @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
1754 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
1755 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
1756 removed.
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-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
1759 @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
1760 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
1761
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1762 @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
1763 @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
1764 @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
1765 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
1766 @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
1767 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
1768
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1769 @example
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1770 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
1771 @end example
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1772
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1773 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
1774 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
1775
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1776 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
1777 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
1778 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
1779 @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
1780 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
1781
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1782 @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
1783 @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
1784 @cindex yanking
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1785 @cindex quoting
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1786 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
1787 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
1788 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
1789 @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
1790 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
1791 is @samp{> }.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1792
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1793 @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
1794 @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
1795 @cindex yanking
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1796 @cindex cited
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1797 @cindex quoting
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1798 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
1799 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
1800 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
1801 @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
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-indentation-spaces
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-indentation-spaces
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1805 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
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-cite-function
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-cite-function
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1809 @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
1810 @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
1811 @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
1812 @cindex Supercite
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1813 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
1814 @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
1815 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
1816 @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
1817 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
1818 Supercite.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1819
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1820 @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
1821 @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
1822 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
1823 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
1824 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
1825 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
1826
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1827 @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
1828 @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
1829 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
1830
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1831 @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
1832 @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
1833 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
1834
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1835 @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
1836 @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
1837 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
1838 (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
1839 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
1840 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
1841 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
1842
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1843 @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
1844 @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
1845 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
1846 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
1847
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1848 @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
1849 @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
1850 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
1851 signature separator.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1852
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1853 @end table
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1854
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1855 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
1856 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
1857 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
1858 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
1859 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
1860
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1861 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
1862 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
1863 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
1864 say.
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1865
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1866
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1867 @node Various Message Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1868 @section Various Message Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1869
Dave Love <fx@gnu.org>
parents:
diff changeset
1870 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1871 @item message-default-charset
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1872 @vindex message-default-charset
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1873 @cindex charset
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1874 Symbol naming a @acronym{MIME} charset. Non-@acronym{ASCII} characters
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1875 in messages are assumed to be encoded using this charset. The default
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1876 is @code{iso-8859-1} on non-@sc{mule} Emacsen; otherwise @code{nil},
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1877 which means ask the user. (This variable is used only on non-@sc{mule}
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1878 Emacsen.) @xref{Charset Translation, , Charset Translation, emacs-mime,
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1879 Emacs MIME Manual}, for details on the @sc{mule}-to-@acronym{MIME}
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1880 translation process.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1881
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1882 @item message-signature-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1883 @vindex message-signature-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1884 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
1885 default.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1886
Dave Love <fx@gnu.org>
parents:
diff changeset
1887 @item mail-header-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1888 @vindex mail-header-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1889 String used to separate the headers from the body. It is @samp{--text
Dave Love <fx@gnu.org>
parents:
diff changeset
1890 follows this line--} by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1891
Dave Love <fx@gnu.org>
parents:
diff changeset
1892 @item message-directory
Dave Love <fx@gnu.org>
parents:
diff changeset
1893 @vindex message-directory
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1894 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
1895 All other mail file variables are derived from @code{message-directory}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1896
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1897 @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
1898 @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
1899 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
1900 @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
1901
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1902 @item message-signature-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1903 @vindex message-signature-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1904 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
1905 headers have been inserted but before the signature has been inserted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1906
Dave Love <fx@gnu.org>
parents:
diff changeset
1907 @item message-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1908 @vindex message-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1909 Hook run as the last thing when the message buffer has been initialized,
Dave Love <fx@gnu.org>
parents:
diff changeset
1910 but before yanked text is inserted.
Dave Love <fx@gnu.org>
parents:
diff changeset
1911
Dave Love <fx@gnu.org>
parents:
diff changeset
1912 @item message-header-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1913 @vindex message-header-setup-hook
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1914 Hook called narrowed to the headers after initializing the headers.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1915
Dave Love <fx@gnu.org>
parents:
diff changeset
1916 For instance, if you're running Gnus and wish to insert a
Dave Love <fx@gnu.org>
parents:
diff changeset
1917 @samp{Mail-Copies-To} header in all your news articles and all messages
Dave Love <fx@gnu.org>
parents:
diff changeset
1918 you send to mailing lists, you could do something like the following:
Dave Love <fx@gnu.org>
parents:
diff changeset
1919
Dave Love <fx@gnu.org>
parents:
diff changeset
1920 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1921 (defun my-message-header-setup-hook ()
Dave Love <fx@gnu.org>
parents:
diff changeset
1922 (let ((group (or gnus-newsgroup-name "")))
Dave Love <fx@gnu.org>
parents:
diff changeset
1923 (when (or (message-fetch-field "newsgroups")
Dave Love <fx@gnu.org>
parents:
diff changeset
1924 (gnus-group-find-parameter group 'to-address)
Dave Love <fx@gnu.org>
parents:
diff changeset
1925 (gnus-group-find-parameter group 'to-list))
Dave Love <fx@gnu.org>
parents:
diff changeset
1926 (insert "Mail-Copies-To: never\n"))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1927
Dave Love <fx@gnu.org>
parents:
diff changeset
1928 (add-hook 'message-header-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1929 'my-message-header-setup-hook)
Dave Love <fx@gnu.org>
parents:
diff changeset
1930 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1931
Dave Love <fx@gnu.org>
parents:
diff changeset
1932 @item message-send-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1933 @vindex message-send-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1934 Hook run before sending messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1935
Dave Love <fx@gnu.org>
parents:
diff changeset
1936 If you want to add certain headers before sending, you can use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1937 @code{message-add-header} function in this hook. For instance:
Dave Love <fx@gnu.org>
parents:
diff changeset
1938 @findex message-add-header
Dave Love <fx@gnu.org>
parents:
diff changeset
1939
Dave Love <fx@gnu.org>
parents:
diff changeset
1940 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1941 (add-hook 'message-send-hook 'my-message-add-content)
Dave Love <fx@gnu.org>
parents:
diff changeset
1942 (defun my-message-add-content ()
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1943 (message-add-header "X-In-No-Sense: Nonsense")
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1944 (message-add-header "X-Whatever: no"))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1945 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1946
Dave Love <fx@gnu.org>
parents:
diff changeset
1947 This function won't add the header if the header is already present.
Dave Love <fx@gnu.org>
parents:
diff changeset
1948
Dave Love <fx@gnu.org>
parents:
diff changeset
1949 @item message-send-mail-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1950 @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
1951 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
1952 just before the message is actually sent as mail.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1953
Dave Love <fx@gnu.org>
parents:
diff changeset
1954 @item message-send-news-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1955 @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
1956 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
1957 just before the message is actually sent as news.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1958
Dave Love <fx@gnu.org>
parents:
diff changeset
1959 @item message-sent-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1960 @vindex message-sent-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1961 Hook run after sending messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1962
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1963 @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
1964 @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
1965 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
1966
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1967 @item message-mode-syntax-table
Dave Love <fx@gnu.org>
parents:
diff changeset
1968 @vindex message-mode-syntax-table
Dave Love <fx@gnu.org>
parents:
diff changeset
1969 Syntax table used in message mode buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1970
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1971 @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
1972 @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
1973 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
1974 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
1975 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
1976 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
1977 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
1978 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
1979
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1980 @item message-send-method-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1981 @vindex message-send-method-alist
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1982 @findex message-mail-p
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1983 @findex message-news-p
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1984 @findex message-send-via-mail
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1985 @findex message-send-via-news
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1986 Alist of ways to send outgoing messages. Each element has the form:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1987
Dave Love <fx@gnu.org>
parents:
diff changeset
1988 @lisp
56927
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
1989 (@var{type} @var{predicate} @var{function})
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1990 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1991
Dave Love <fx@gnu.org>
parents:
diff changeset
1992 @table @var
Dave Love <fx@gnu.org>
parents:
diff changeset
1993 @item type
Dave Love <fx@gnu.org>
parents:
diff changeset
1994 A symbol that names the method.
Dave Love <fx@gnu.org>
parents:
diff changeset
1995
Dave Love <fx@gnu.org>
parents:
diff changeset
1996 @item predicate
Dave Love <fx@gnu.org>
parents:
diff changeset
1997 A function called without any parameters to determine whether the
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1998 message is a message of type @var{type}. The function will be called in
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
1999 the buffer where the message is.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2000
Dave Love <fx@gnu.org>
parents:
diff changeset
2001 @item function
Dave Love <fx@gnu.org>
parents:
diff changeset
2002 A function to be called if @var{predicate} returns non-@code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2003 @var{function} is called with one parameter -- the prefix.
Dave Love <fx@gnu.org>
parents:
diff changeset
2004 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2005
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2006 The default is:
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2007
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2008 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2009 ((news message-news-p message-send-via-news)
Dave Love <fx@gnu.org>
parents:
diff changeset
2010 (mail message-mail-p message-send-via-mail))
Dave Love <fx@gnu.org>
parents:
diff changeset
2011 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2012
67418
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2013 The @code{message-news-p} function returns non-@code{nil} if the message
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2014 looks like news, and the @code{message-send-via-news} function sends the
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2015 message according to the @code{message-send-news-function} variable
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2016 (@pxref{News Variables}). The @code{message-mail-p} function returns
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2017 non-@code{nil} if the message looks like mail, and the
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2018 @code{message-send-via-mail} function sends the message according to the
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2019 @code{message-send-mail-function} variable (@pxref{Mail Variables}).
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2020
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2021 All the elements in this alist will be tried in order, so a message
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2022 containing both a valid @samp{Newsgroups} header and a valid @samp{To}
28264c86d408 Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-668
Miles Bader <miles@gnu.org>
parents: 65742
diff changeset
2023 header, for example, will be sent as news, and then as mail.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2024 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2025
Dave Love <fx@gnu.org>
parents:
diff changeset
2026
Dave Love <fx@gnu.org>
parents:
diff changeset
2027
Dave Love <fx@gnu.org>
parents:
diff changeset
2028 @node Sending Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
2029 @section Sending Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
2030
Dave Love <fx@gnu.org>
parents:
diff changeset
2031 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
2032
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
2033 @item message-fcc-handler-function
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
2034 @vindex message-fcc-handler-function
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2035 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
2036 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
2037 function is @code{message-output} which saves in Unix mailbox format.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2038
Dave Love <fx@gnu.org>
parents:
diff changeset
2039 @item message-courtesy-message
Dave Love <fx@gnu.org>
parents:
diff changeset
2040 @vindex message-courtesy-message
Dave Love <fx@gnu.org>
parents:
diff changeset
2041 When sending combined messages, this string is inserted at the start of
Dave Love <fx@gnu.org>
parents:
diff changeset
2042 the mailed copy. If the string contains the format spec @samp{%s}, the
Dave Love <fx@gnu.org>
parents:
diff changeset
2043 newsgroups the article has been posted to will be inserted there. If
Dave Love <fx@gnu.org>
parents:
diff changeset
2044 this variable is @code{nil}, no such courtesy message will be added.
Dave Love <fx@gnu.org>
parents:
diff changeset
2045 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
2046 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
2047
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
2048 @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
2049 @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
2050 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
2051 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
2052
55fd4f77387a Revision: miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-523
Miles Bader <miles@gnu.org>
parents: 52401
diff changeset
2053 @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
2054 @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
2055 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
2056 if @code{nil} let the mailer mail back a message to report errors.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2057
Dave Love <fx@gnu.org>
parents:
diff changeset
2058 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2059
Dave Love <fx@gnu.org>
parents:
diff changeset
2060
Dave Love <fx@gnu.org>
parents:
diff changeset
2061 @node Message Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2062 @section Message Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2063
Dave Love <fx@gnu.org>
parents:
diff changeset
2064 Message will generate new buffers with unique buffer names when you
Dave Love <fx@gnu.org>
parents:
diff changeset
2065 request a message buffer. When you send the message, the buffer isn't
Dave Love <fx@gnu.org>
parents:
diff changeset
2066 normally killed off. Its name is changed and a certain number of old
Dave Love <fx@gnu.org>
parents:
diff changeset
2067 message buffers are kept alive.
Dave Love <fx@gnu.org>
parents:
diff changeset
2068
Dave Love <fx@gnu.org>
parents:
diff changeset
2069 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
2070 @item message-generate-new-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2071 @vindex message-generate-new-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2072 If non-@code{nil}, generate new buffers. The default is @code{t}. If
Dave Love <fx@gnu.org>
parents:
diff changeset
2073 this is a function, call that function with three parameters: The type,
Dave Love <fx@gnu.org>
parents:
diff changeset
2074 the to address and the group name. (Any of these may be @code{nil}.)
Dave Love <fx@gnu.org>
parents:
diff changeset
2075 The function should return the new buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
2076
Dave Love <fx@gnu.org>
parents:
diff changeset
2077 @item message-max-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2078 @vindex message-max-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2079 This variable says how many old message buffers to keep. If there are
Dave Love <fx@gnu.org>
parents:
diff changeset
2080 more message buffers than this, the oldest buffer will be killed. The
Dave Love <fx@gnu.org>
parents:
diff changeset
2081 default is 10. If this variable is @code{nil}, no old message buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2082 will ever be killed.
Dave Love <fx@gnu.org>
parents:
diff changeset
2083
Dave Love <fx@gnu.org>
parents:
diff changeset
2084 @item message-send-rename-function
Dave Love <fx@gnu.org>
parents:
diff changeset
2085 @vindex message-send-rename-function
Dave Love <fx@gnu.org>
parents:
diff changeset
2086 After sending a message, the buffer is renamed from, for instance,
Dave Love <fx@gnu.org>
parents:
diff changeset
2087 @samp{*reply to Lars*} to @samp{*sent reply to Lars*}. If you don't
Dave Love <fx@gnu.org>
parents:
diff changeset
2088 like this, set this variable to a function that renames the buffer in a
Dave Love <fx@gnu.org>
parents:
diff changeset
2089 manner you like. If you don't want to rename the buffer at all, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
2090 say:
Dave Love <fx@gnu.org>
parents:
diff changeset
2091
Dave Love <fx@gnu.org>
parents:
diff changeset
2092 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2093 (setq message-send-rename-function 'ignore)
Dave Love <fx@gnu.org>
parents:
diff changeset
2094 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2095
Dave Love <fx@gnu.org>
parents:
diff changeset
2096 @item message-kill-buffer-on-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
2097 @findex message-kill-buffer-on-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
2098 If non-@code{nil}, kill the buffer immediately on exit.
Dave Love <fx@gnu.org>
parents:
diff changeset
2099
Dave Love <fx@gnu.org>
parents:
diff changeset
2100 @end table
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 Message Actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2104 @section Message Actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2105
Dave Love <fx@gnu.org>
parents:
diff changeset
2106 When Message is being used from a news/mail reader, the reader is likely
Dave Love <fx@gnu.org>
parents:
diff changeset
2107 to want to perform some task after the message has been sent. Perhaps
Dave Love <fx@gnu.org>
parents:
diff changeset
2108 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
2109 replied.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2110
Dave Love <fx@gnu.org>
parents:
diff changeset
2111 @vindex message-kill-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2112 @vindex message-postpone-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2113 @vindex message-exit-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2114 @vindex message-send-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2115 The user may exit from the message buffer in various ways. The most
Dave Love <fx@gnu.org>
parents:
diff changeset
2116 common is @kbd{C-c C-c}, which sends the message and exits. Other
Dave Love <fx@gnu.org>
parents:
diff changeset
2117 possibilities are @kbd{C-c C-s} which just sends the message, @kbd{C-c
Dave Love <fx@gnu.org>
parents:
diff changeset
2118 C-d} which postpones the message editing and buries the message buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
2119 and @kbd{C-c C-k} which kills the message buffer. Each of these actions
Dave Love <fx@gnu.org>
parents:
diff changeset
2120 have lists associated with them that contains actions to be executed:
Dave Love <fx@gnu.org>
parents:
diff changeset
2121 @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
2122 @code{message-postpone-actions}, and @code{message-kill-actions}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2123
Dave Love <fx@gnu.org>
parents:
diff changeset
2124 Message provides a function to interface with these lists:
Dave Love <fx@gnu.org>
parents:
diff changeset
2125 @code{message-add-action}. The first parameter is the action to be
Dave Love <fx@gnu.org>
parents:
diff changeset
2126 added, and the rest of the arguments are which lists to add this action
Dave Love <fx@gnu.org>
parents:
diff changeset
2127 to. Here's an example from Gnus:
Dave Love <fx@gnu.org>
parents:
diff changeset
2128
Dave Love <fx@gnu.org>
parents:
diff changeset
2129 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2130 (message-add-action
Dave Love <fx@gnu.org>
parents:
diff changeset
2131 `(set-window-configuration ,(current-window-configuration))
Dave Love <fx@gnu.org>
parents:
diff changeset
2132 'exit 'postpone 'kill)
Dave Love <fx@gnu.org>
parents:
diff changeset
2133 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2134
Dave Love <fx@gnu.org>
parents:
diff changeset
2135 This restores the Gnus window configuration when the message buffer is
Dave Love <fx@gnu.org>
parents:
diff changeset
2136 killed, postponed or exited.
Dave Love <fx@gnu.org>
parents:
diff changeset
2137
Dave Love <fx@gnu.org>
parents:
diff changeset
2138 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
2139 @sc{car} is a function and the @sc{cdr} is the list of arguments, or
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2140 a form to be @code{eval}ed.
Dave Love <fx@gnu.org>
parents:
diff changeset
2141
Dave Love <fx@gnu.org>
parents:
diff changeset
2142
Dave Love <fx@gnu.org>
parents:
diff changeset
2143 @node Compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
2144 @chapter Compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
2145 @cindex compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
2146
Dave Love <fx@gnu.org>
parents:
diff changeset
2147 Message uses virtually only its own variables---older @code{mail-}
Dave Love <fx@gnu.org>
parents:
diff changeset
2148 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
2149 into account, you can put the following in your @file{.emacs} file:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2150
Dave Love <fx@gnu.org>
parents:
diff changeset
2151 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2152 (require 'messcompat)
Dave Love <fx@gnu.org>
parents:
diff changeset
2153 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2154
Dave Love <fx@gnu.org>
parents:
diff changeset
2155 This will initialize many Message variables from the values in the
Dave Love <fx@gnu.org>
parents:
diff changeset
2156 corresponding mail variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
2157
Dave Love <fx@gnu.org>
parents:
diff changeset
2158
Dave Love <fx@gnu.org>
parents:
diff changeset
2159 @node Appendices
Dave Love <fx@gnu.org>
parents:
diff changeset
2160 @chapter Appendices
Dave Love <fx@gnu.org>
parents:
diff changeset
2161
Dave Love <fx@gnu.org>
parents:
diff changeset
2162 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
2163 * Responses:: Standard rules for determining where responses go.
Dave Love <fx@gnu.org>
parents:
diff changeset
2164 @end menu
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 @node Responses
Dave Love <fx@gnu.org>
parents:
diff changeset
2168 @section Responses
Dave Love <fx@gnu.org>
parents:
diff changeset
2169
Dave Love <fx@gnu.org>
parents:
diff changeset
2170 To determine where a message is to go, the following algorithm is used
Dave Love <fx@gnu.org>
parents:
diff changeset
2171 by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
2172
Dave Love <fx@gnu.org>
parents:
diff changeset
2173 @table @dfn
Dave Love <fx@gnu.org>
parents:
diff changeset
2174 @item reply
Dave Love <fx@gnu.org>
parents:
diff changeset
2175 A @dfn{reply} is when you want to respond @emph{just} to the person who
Dave Love <fx@gnu.org>
parents:
diff changeset
2176 sent the message via mail. There will only be one recipient. To
Dave Love <fx@gnu.org>
parents:
diff changeset
2177 determine who the recipient will be, the following headers are
Dave Love <fx@gnu.org>
parents:
diff changeset
2178 consulted, in turn:
Dave Love <fx@gnu.org>
parents:
diff changeset
2179
Dave Love <fx@gnu.org>
parents:
diff changeset
2180 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
2181 @item Reply-To
Dave Love <fx@gnu.org>
parents:
diff changeset
2182
Dave Love <fx@gnu.org>
parents:
diff changeset
2183 @item From
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 @item wide reply
Dave Love <fx@gnu.org>
parents:
diff changeset
2188 A @dfn{wide reply} is a mail response that includes @emph{all} entities
Dave Love <fx@gnu.org>
parents:
diff changeset
2189 mentioned in the message you are responded to. All mailboxes from the
Dave Love <fx@gnu.org>
parents:
diff changeset
2190 following headers will be concatenated to form the outgoing
Dave Love <fx@gnu.org>
parents:
diff changeset
2191 @code{To}/@code{Cc} headers:
Dave Love <fx@gnu.org>
parents:
diff changeset
2192
Dave Love <fx@gnu.org>
parents:
diff changeset
2193 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
2194 @item From
Dave Love <fx@gnu.org>
parents:
diff changeset
2195 (unless there's a @code{Reply-To}, in which case that is used instead).
Dave Love <fx@gnu.org>
parents:
diff changeset
2196
Dave Love <fx@gnu.org>
parents:
diff changeset
2197 @item Cc
Dave Love <fx@gnu.org>
parents:
diff changeset
2198
Dave Love <fx@gnu.org>
parents:
diff changeset
2199 @item To
Dave Love <fx@gnu.org>
parents:
diff changeset
2200 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2201
Dave Love <fx@gnu.org>
parents:
diff changeset
2202 If a @code{Mail-Copies-To} header is present, it will also be included
Dave Love <fx@gnu.org>
parents:
diff changeset
2203 in the list of mailboxes. If this header is @samp{never}, that means
Dave Love <fx@gnu.org>
parents:
diff changeset
2204 that the @code{From} (or @code{Reply-To}) mailbox will be suppressed.
Dave Love <fx@gnu.org>
parents:
diff changeset
2205
Dave Love <fx@gnu.org>
parents:
diff changeset
2206
Dave Love <fx@gnu.org>
parents:
diff changeset
2207 @item followup
Dave Love <fx@gnu.org>
parents:
diff changeset
2208 A @dfn{followup} is a response sent via news. The following headers
Dave Love <fx@gnu.org>
parents:
diff changeset
2209 (listed in order of precedence) determine where the response is to be
Dave Love <fx@gnu.org>
parents:
diff changeset
2210 sent:
Dave Love <fx@gnu.org>
parents:
diff changeset
2211
Dave Love <fx@gnu.org>
parents:
diff changeset
2212 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
2213
Dave Love <fx@gnu.org>
parents:
diff changeset
2214 @item Followup-To
Dave Love <fx@gnu.org>
parents:
diff changeset
2215
Dave Love <fx@gnu.org>
parents:
diff changeset
2216 @item Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
2217
Dave Love <fx@gnu.org>
parents:
diff changeset
2218 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2219
Dave Love <fx@gnu.org>
parents:
diff changeset
2220 If a @code{Mail-Copies-To} header is present, it will be used as the
Dave Love <fx@gnu.org>
parents:
diff changeset
2221 basis of the new @code{Cc} header, except if this header is
Dave Love <fx@gnu.org>
parents:
diff changeset
2222 @samp{never}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2223
Dave Love <fx@gnu.org>
parents:
diff changeset
2224 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2225
Dave Love <fx@gnu.org>
parents:
diff changeset
2226
Dave Love <fx@gnu.org>
parents:
diff changeset
2227
Dave Love <fx@gnu.org>
parents:
diff changeset
2228 @node Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2229 @chapter Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2230 @printindex cp
Dave Love <fx@gnu.org>
parents:
diff changeset
2231
Dave Love <fx@gnu.org>
parents:
diff changeset
2232 @node Key Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2233 @chapter Key Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2234 @printindex ky
Dave Love <fx@gnu.org>
parents:
diff changeset
2235
Dave Love <fx@gnu.org>
parents:
diff changeset
2236 @summarycontents
Dave Love <fx@gnu.org>
parents:
diff changeset
2237 @contents
Dave Love <fx@gnu.org>
parents:
diff changeset
2238 @bye
Dave Love <fx@gnu.org>
parents:
diff changeset
2239
Dave Love <fx@gnu.org>
parents:
diff changeset
2240 @c End:
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
2241
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
2242 @ignore
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
2243 arch-tag: 16ab76af-a281-4e34-aed6-5624569f7601
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 49600
diff changeset
2244 @end ignore