annotate man/message.texi @ 74405:8289a04178f1

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