annotate man/message.texi @ 59688:3761d1e2619d

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