annotate man/message.texi @ 43290:3198ecb4e71f

Minor clarification.
author Richard M. Stallman <rms@gnu.org>
date Thu, 14 Feb 2002 01:38:49 +0000
parents 421e0a91a1d1
children 82d113655734
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
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
4 @settitle Message 5.9.0 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
33671
90acc0606378 Change @dircategory.
Dave Love <fx@gnu.org>
parents: 32314
diff changeset
8 @dircategory Emacs
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
9 @direntry
Dave Love <fx@gnu.org>
parents:
diff changeset
10 * Message: (message). Mail and news composition mode that goes with Gnus.
Dave Love <fx@gnu.org>
parents:
diff changeset
11 @end direntry
Dave Love <fx@gnu.org>
parents:
diff changeset
12 @iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
13 @finalout
Dave Love <fx@gnu.org>
parents:
diff changeset
14 @end iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
15 @setchapternewpage odd
Dave Love <fx@gnu.org>
parents:
diff changeset
16
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
17 @ifnottex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
18
Dave Love <fx@gnu.org>
parents:
diff changeset
19 This file documents Message, the Emacs message composition mode.
Dave Love <fx@gnu.org>
parents:
diff changeset
20
36056
6caf2957c4a8 Expand on message-signature-file.
Dave Love <fx@gnu.org>
parents: 35614
diff changeset
21 Copyright (C) 1996,97,98,99,2000,2001 Free Software Foundation, Inc.
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 Permission is granted to copy, distribute and/or modify this document
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
24 under the terms of the GNU Free Documentation License, Version 1.1 or
32314
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
25 any later version published by the Free Software Foundation; with no
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
26 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
27 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
28 license is included in the section entitled ``GNU Free Documentation
32249
d656fc261560 Modify licence notice.
Dave Love <fx@gnu.org>
parents: 32008
diff changeset
29 License'' in the Emacs manual.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
30
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
31 (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
32 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
33 Software Foundation raise funds for GNU development.''
32249
d656fc261560 Modify licence notice.
Dave Love <fx@gnu.org>
parents: 32008
diff changeset
34
d656fc261560 Modify licence notice.
Dave Love <fx@gnu.org>
parents: 32008
diff changeset
35 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
36 Documentation License. If you want to distribute this document
d656fc261560 Modify licence notice.
Dave Love <fx@gnu.org>
parents: 32008
diff changeset
37 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
38 license to the document, as described in section 6 of the license.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
39 @end ifnottex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
40
Dave Love <fx@gnu.org>
parents:
diff changeset
41 @tex
Dave Love <fx@gnu.org>
parents:
diff changeset
42
Dave Love <fx@gnu.org>
parents:
diff changeset
43 @titlepage
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
44 @title Message 5.9.0 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
Dave Love <fx@gnu.org>
parents:
diff changeset
48
Dave Love <fx@gnu.org>
parents:
diff changeset
49 @vskip 0pt plus 1filll
36056
6caf2957c4a8 Expand on message-signature-file.
Dave Love <fx@gnu.org>
parents: 35614
diff changeset
50 Copyright @copyright{} 1996,97,98,99,2000,2001 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
51
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
52 Permission is granted to copy, distribute and/or modify this document
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
53 under the terms of the GNU Free Documentation License, Version 1.1 or
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
54 any later version published by the Free Software Foundation; with the
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
55 Invariant Sections being none, with the Front-Cover texts being ``A GNU
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
56 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
57 license is included in the section entitled ``GNU Free Documentation
32250
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
58 License'' in the Emacs manual.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
59
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
60 (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
61 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
62 Software Foundation raise funds for GNU development.''
32250
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
63
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
64 This document is part of a collection distributed under the GNU Free
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
65 Documentation License. If you want to distribute this document
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
66 separately from the collection, you can do so by adding a copy of the
949f454d6d76 Fix last.
Dave Love <fx@gnu.org>
parents: 32249
diff changeset
67 license to the document, as described in section 6 of the license.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
68 @end titlepage
Dave Love <fx@gnu.org>
parents:
diff changeset
69 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
70
Dave Love <fx@gnu.org>
parents:
diff changeset
71 @end tex
Dave Love <fx@gnu.org>
parents:
diff changeset
72
Dave Love <fx@gnu.org>
parents:
diff changeset
73 @node Top
Dave Love <fx@gnu.org>
parents:
diff changeset
74 @top Message
Dave Love <fx@gnu.org>
parents:
diff changeset
75
Dave Love <fx@gnu.org>
parents:
diff changeset
76 All message composition from Gnus (both mail and news) takes place in
Dave Love <fx@gnu.org>
parents:
diff changeset
77 Message mode buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
78
Dave Love <fx@gnu.org>
parents:
diff changeset
79 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
80 * Interface:: Setting up message buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
81 * Commands:: Commands you can execute in message mode buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
82 * Variables:: Customizing the message buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
83 * Compatibility:: Making Message backwards compatible.
Dave Love <fx@gnu.org>
parents:
diff changeset
84 * Appendices:: More technical things.
Dave Love <fx@gnu.org>
parents:
diff changeset
85 * Index:: Variable, function and concept index.
Dave Love <fx@gnu.org>
parents:
diff changeset
86 * Key Index:: List of Message mode keys.
Dave Love <fx@gnu.org>
parents:
diff changeset
87 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
88
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
89 This manual corresponds to Message 5.9.0. Message is distributed with
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
90 the Gnus distribution bearing the same version number as this manual.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
91
Dave Love <fx@gnu.org>
parents:
diff changeset
92
Dave Love <fx@gnu.org>
parents:
diff changeset
93 @node Interface
Dave Love <fx@gnu.org>
parents:
diff changeset
94 @chapter Interface
Dave Love <fx@gnu.org>
parents:
diff changeset
95
Dave Love <fx@gnu.org>
parents:
diff changeset
96 When a program (or a person) wants to respond to a message -- reply,
Dave Love <fx@gnu.org>
parents:
diff changeset
97 follow up, forward, cancel -- the program (or person) should just put
Dave Love <fx@gnu.org>
parents:
diff changeset
98 point in the buffer where the message is and call the required command.
Dave Love <fx@gnu.org>
parents:
diff changeset
99 @code{Message} will then pop up a new @code{message} mode buffer with
Dave Love <fx@gnu.org>
parents:
diff changeset
100 appropriate headers filled out, and the user can edit the message before
Dave Love <fx@gnu.org>
parents:
diff changeset
101 sending it.
Dave Love <fx@gnu.org>
parents:
diff changeset
102
Dave Love <fx@gnu.org>
parents:
diff changeset
103 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
104 * New Mail Message:: Editing a brand new mail message.
Dave Love <fx@gnu.org>
parents:
diff changeset
105 * New News Message:: Editing a brand new news message.
Dave Love <fx@gnu.org>
parents:
diff changeset
106 * Reply:: Replying via mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
107 * Wide Reply:: Responding to all people via mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
108 * Followup:: Following up via news.
Dave Love <fx@gnu.org>
parents:
diff changeset
109 * Canceling News:: Canceling a news article.
Dave Love <fx@gnu.org>
parents:
diff changeset
110 * Superseding:: Superseding a message.
Dave Love <fx@gnu.org>
parents:
diff changeset
111 * Forwarding:: Forwarding a message via news or mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
112 * Resending:: Resending a mail message.
Dave Love <fx@gnu.org>
parents:
diff changeset
113 * Bouncing:: Bouncing a mail message.
Dave Love <fx@gnu.org>
parents:
diff changeset
114 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
115
Dave Love <fx@gnu.org>
parents:
diff changeset
116
Dave Love <fx@gnu.org>
parents:
diff changeset
117 @node New Mail Message
Dave Love <fx@gnu.org>
parents:
diff changeset
118 @section New Mail Message
Dave Love <fx@gnu.org>
parents:
diff changeset
119
Dave Love <fx@gnu.org>
parents:
diff changeset
120 @findex message-mail
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
121 The @code{message-mail} command pops up a new message buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
122
Dave Love <fx@gnu.org>
parents:
diff changeset
123 Two optional parameters are accepted: The first will be used as the
Dave Love <fx@gnu.org>
parents:
diff changeset
124 @code{To} header and the second as the @code{Subject} header. If these
Dave Love <fx@gnu.org>
parents:
diff changeset
125 are @code{nil}, those two headers will be empty.
Dave Love <fx@gnu.org>
parents:
diff changeset
126
Dave Love <fx@gnu.org>
parents:
diff changeset
127
Dave Love <fx@gnu.org>
parents:
diff changeset
128 @node New News Message
Dave Love <fx@gnu.org>
parents:
diff changeset
129 @section New News Message
Dave Love <fx@gnu.org>
parents:
diff changeset
130
Dave Love <fx@gnu.org>
parents:
diff changeset
131 @findex message-news
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
132 The @code{message-news} command pops up a new message buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
133
Dave Love <fx@gnu.org>
parents:
diff changeset
134 This function accepts two optional parameters. The first will be used
Dave Love <fx@gnu.org>
parents:
diff changeset
135 as the @code{Newsgroups} header and the second as the @code{Subject}
Dave Love <fx@gnu.org>
parents:
diff changeset
136 header. If these are @code{nil}, those two headers will be empty.
Dave Love <fx@gnu.org>
parents:
diff changeset
137
Dave Love <fx@gnu.org>
parents:
diff changeset
138
Dave Love <fx@gnu.org>
parents:
diff changeset
139 @node Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
140 @section Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
141
Dave Love <fx@gnu.org>
parents:
diff changeset
142 @findex message-reply
Dave Love <fx@gnu.org>
parents:
diff changeset
143 The @code{message-reply} function pops up a message buffer that's a
Dave Love <fx@gnu.org>
parents:
diff changeset
144 reply to the message in the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
145
Dave Love <fx@gnu.org>
parents:
diff changeset
146 @vindex message-reply-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
147 Message uses the normal methods to determine where replies are to go
Dave Love <fx@gnu.org>
parents:
diff changeset
148 (@pxref{Responses}), but you can change the behavior to suit your needs
Dave Love <fx@gnu.org>
parents:
diff changeset
149 by fiddling with the @code{message-reply-to-function} variable.
Dave Love <fx@gnu.org>
parents:
diff changeset
150
Dave Love <fx@gnu.org>
parents:
diff changeset
151 If you want the replies to go to the @code{Sender} instead of the
Dave Love <fx@gnu.org>
parents:
diff changeset
152 @code{From}, you could do something like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
153
Dave Love <fx@gnu.org>
parents:
diff changeset
154 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
155 (setq message-reply-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
156 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
157 (cond ((equal (mail-fetch-field "from") "somebody")
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
158 (list (cons 'To (mail-fetch-field "sender"))))
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
159 (t
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
160 nil))))
Dave Love <fx@gnu.org>
parents:
diff changeset
161 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
162
Dave Love <fx@gnu.org>
parents:
diff changeset
163 This function will be called narrowed to the head of the article that is
Dave Love <fx@gnu.org>
parents:
diff changeset
164 being replied to.
Dave Love <fx@gnu.org>
parents:
diff changeset
165
Dave Love <fx@gnu.org>
parents:
diff changeset
166 As you can see, this function should return a string if it has an
Dave Love <fx@gnu.org>
parents:
diff changeset
167 opinion as to what the To header should be. If it does not, it should
Dave Love <fx@gnu.org>
parents:
diff changeset
168 just return @code{nil}, and the normal methods for determining the To
Dave Love <fx@gnu.org>
parents:
diff changeset
169 header will be used.
Dave Love <fx@gnu.org>
parents:
diff changeset
170
Dave Love <fx@gnu.org>
parents:
diff changeset
171 This function can also return a list. In that case, each list element
Dave Love <fx@gnu.org>
parents:
diff changeset
172 should be a cons, where the car should be the name of an header
Dave Love <fx@gnu.org>
parents:
diff changeset
173 (eg. @code{Cc}) and the cdr should be the header value
Dave Love <fx@gnu.org>
parents:
diff changeset
174 (eg. @samp{larsi@@ifi.uio.no}). All these headers will be inserted into
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
175 the head of the outgoing mail.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
176
Dave Love <fx@gnu.org>
parents:
diff changeset
177
Dave Love <fx@gnu.org>
parents:
diff changeset
178 @node Wide Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
179 @section Wide Reply
Dave Love <fx@gnu.org>
parents:
diff changeset
180
Dave Love <fx@gnu.org>
parents:
diff changeset
181 @findex message-wide-reply
Dave Love <fx@gnu.org>
parents:
diff changeset
182 The @code{message-wide-reply} pops up a message buffer that's a wide
Dave Love <fx@gnu.org>
parents:
diff changeset
183 reply to the message in the current buffer. A @dfn{wide reply} is a
Dave Love <fx@gnu.org>
parents:
diff changeset
184 reply that goes out to all people listed in the @code{To}, @code{From}
Dave Love <fx@gnu.org>
parents:
diff changeset
185 (or @code{Reply-to}) and @code{Cc} headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
186
Dave Love <fx@gnu.org>
parents:
diff changeset
187 @vindex message-wide-reply-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
188 Message uses the normal methods to determine where wide replies are to go,
Dave Love <fx@gnu.org>
parents:
diff changeset
189 but you can change the behavior to suit your needs by fiddling with the
Dave Love <fx@gnu.org>
parents:
diff changeset
190 @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
191 @code{message-reply-to-function} (@pxref{Reply}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
192
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
193 @findex message-dont-reply-to-names
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
194 Addresses that match the @code{message-dont-reply-to-names} regular
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
195 expression will be removed from the @code{Cc} header.
Dave Love <fx@gnu.org>
parents:
diff changeset
196
Dave Love <fx@gnu.org>
parents:
diff changeset
197
Dave Love <fx@gnu.org>
parents:
diff changeset
198 @node Followup
Dave Love <fx@gnu.org>
parents:
diff changeset
199 @section Followup
Dave Love <fx@gnu.org>
parents:
diff changeset
200
Dave Love <fx@gnu.org>
parents:
diff changeset
201 @findex message-followup
Dave Love <fx@gnu.org>
parents:
diff changeset
202 The @code{message-followup} command pops up a message buffer that's a
Dave Love <fx@gnu.org>
parents:
diff changeset
203 followup to the message in the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
204
Dave Love <fx@gnu.org>
parents:
diff changeset
205 @vindex message-followup-to-function
Dave Love <fx@gnu.org>
parents:
diff changeset
206 Message uses the normal methods to determine where followups are to go,
Dave Love <fx@gnu.org>
parents:
diff changeset
207 but you can change the behavior to suit your needs by fiddling with the
Dave Love <fx@gnu.org>
parents:
diff changeset
208 @code{message-followup-to-function}. It is used in the same way as
Dave Love <fx@gnu.org>
parents:
diff changeset
209 @code{message-reply-to-function} (@pxref{Reply}).
Dave Love <fx@gnu.org>
parents:
diff changeset
210
Dave Love <fx@gnu.org>
parents:
diff changeset
211 @vindex message-use-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
212 The @code{message-use-followup-to} variable says what to do about
Dave Love <fx@gnu.org>
parents:
diff changeset
213 @code{Followup-To} headers. If it is @code{use}, always use the value.
Dave Love <fx@gnu.org>
parents:
diff changeset
214 If it is @code{ask} (which is the default), ask whether to use the
Dave Love <fx@gnu.org>
parents:
diff changeset
215 value. If it is @code{t}, use the value unless it is @samp{poster}. If
Dave Love <fx@gnu.org>
parents:
diff changeset
216 it is @code{nil}, don't use the value.
Dave Love <fx@gnu.org>
parents:
diff changeset
217
Dave Love <fx@gnu.org>
parents:
diff changeset
218
Dave Love <fx@gnu.org>
parents:
diff changeset
219 @node Canceling News
Dave Love <fx@gnu.org>
parents:
diff changeset
220 @section Canceling News
Dave Love <fx@gnu.org>
parents:
diff changeset
221
Dave Love <fx@gnu.org>
parents:
diff changeset
222 @findex message-cancel-news
Dave Love <fx@gnu.org>
parents:
diff changeset
223 The @code{message-cancel-news} command cancels the article in the
Dave Love <fx@gnu.org>
parents:
diff changeset
224 current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
225
Dave Love <fx@gnu.org>
parents:
diff changeset
226
Dave Love <fx@gnu.org>
parents:
diff changeset
227 @node Superseding
Dave Love <fx@gnu.org>
parents:
diff changeset
228 @section Superseding
Dave Love <fx@gnu.org>
parents:
diff changeset
229
Dave Love <fx@gnu.org>
parents:
diff changeset
230 @findex message-supersede
Dave Love <fx@gnu.org>
parents:
diff changeset
231 The @code{message-supersede} command pops up a message buffer that will
Dave Love <fx@gnu.org>
parents:
diff changeset
232 supersede the message in the current buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
233
Dave Love <fx@gnu.org>
parents:
diff changeset
234 @vindex message-ignored-supersedes-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
235 Headers matching the @code{message-ignored-supersedes-headers} are
Dave Love <fx@gnu.org>
parents:
diff changeset
236 removed before popping up the new message buffer. The default is@*
Dave Love <fx@gnu.org>
parents:
diff changeset
237 @samp{^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|@*
Dave Love <fx@gnu.org>
parents:
diff changeset
238 ^Received:\\|^X-From-Line:\\|Return-Path:\\|^Supersedes:}.
Dave Love <fx@gnu.org>
parents:
diff changeset
239
Dave Love <fx@gnu.org>
parents:
diff changeset
240
Dave Love <fx@gnu.org>
parents:
diff changeset
241
Dave Love <fx@gnu.org>
parents:
diff changeset
242 @node Forwarding
Dave Love <fx@gnu.org>
parents:
diff changeset
243 @section Forwarding
Dave Love <fx@gnu.org>
parents:
diff changeset
244
Dave Love <fx@gnu.org>
parents:
diff changeset
245 @findex message-forward
Dave Love <fx@gnu.org>
parents:
diff changeset
246 The @code{message-forward} command pops up a message buffer to forward
Dave Love <fx@gnu.org>
parents:
diff changeset
247 the message in the current buffer. If given a prefix, forward using
Dave Love <fx@gnu.org>
parents:
diff changeset
248 news.
Dave Love <fx@gnu.org>
parents:
diff changeset
249
Dave Love <fx@gnu.org>
parents:
diff changeset
250 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
251 @item message-forward-ignored-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
252 @vindex message-forward-ignored-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
253 All headers that match this regexp will be deleted when forwarding a message.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
254
Dave Love <fx@gnu.org>
parents:
diff changeset
255 @item message-make-forward-subject-function
Dave Love <fx@gnu.org>
parents:
diff changeset
256 @vindex message-make-forward-subject-function
Dave Love <fx@gnu.org>
parents:
diff changeset
257 A list of functions that are called to generate a subject header for
Dave Love <fx@gnu.org>
parents:
diff changeset
258 forwarded messages. The subject generated by the previous function is
Dave Love <fx@gnu.org>
parents:
diff changeset
259 passed into each successive function.
Dave Love <fx@gnu.org>
parents:
diff changeset
260
Dave Love <fx@gnu.org>
parents:
diff changeset
261 The provided functions are:
Dave Love <fx@gnu.org>
parents:
diff changeset
262
Dave Love <fx@gnu.org>
parents:
diff changeset
263 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
264 @item message-forward-subject-author-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
265 @findex message-forward-subject-author-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
266 Source of article (author or newsgroup), in brackets followed by the
Dave Love <fx@gnu.org>
parents:
diff changeset
267 subject.
Dave Love <fx@gnu.org>
parents:
diff changeset
268
Dave Love <fx@gnu.org>
parents:
diff changeset
269 @item message-forward-subject-fwd
Dave Love <fx@gnu.org>
parents:
diff changeset
270 Subject of article with @samp{Fwd:} prepended to it.
Dave Love <fx@gnu.org>
parents:
diff changeset
271 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
272
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @item message-wash-forwarded-subjects
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @vindex message-wash-forwarded-subjects
Dave Love <fx@gnu.org>
parents:
diff changeset
275 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
276 the evidence of previous forwards (such as @samp{Fwd:}, @samp{Re:},
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
277 @samp{(fwd)}) removed before the new subject is
Dave Love <fx@gnu.org>
parents:
diff changeset
278 constructed. The default value is @code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
279
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
280 @item message-forward-as-mime
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
281 @vindex message-forward-as-mime
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
282 If this variable is @code{t} (the default), forwarded messages are
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
283 included as inline MIME RFC822 parts. If it's @code{nil}, forwarded
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
284 messages will just be copied inline to the new message, like previous,
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
285 non MIME-savvy versions of gnus would do.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
286 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
287
Dave Love <fx@gnu.org>
parents:
diff changeset
288
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @node Resending
Dave Love <fx@gnu.org>
parents:
diff changeset
290 @section Resending
Dave Love <fx@gnu.org>
parents:
diff changeset
291
Dave Love <fx@gnu.org>
parents:
diff changeset
292 @findex message-resend
Dave Love <fx@gnu.org>
parents:
diff changeset
293 The @code{message-resend} command will prompt the user for an address
Dave Love <fx@gnu.org>
parents:
diff changeset
294 and resend the message in the current buffer to that address.
Dave Love <fx@gnu.org>
parents:
diff changeset
295
Dave Love <fx@gnu.org>
parents:
diff changeset
296 @vindex message-ignored-resent-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
297 Headers that match the @code{message-ignored-resent-headers} regexp will
Dave Love <fx@gnu.org>
parents:
diff changeset
298 be removed before sending the message. The default is
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
299 @samp{^Return-receipt}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
300
Dave Love <fx@gnu.org>
parents:
diff changeset
301
Dave Love <fx@gnu.org>
parents:
diff changeset
302 @node Bouncing
Dave Love <fx@gnu.org>
parents:
diff changeset
303 @section Bouncing
Dave Love <fx@gnu.org>
parents:
diff changeset
304
Dave Love <fx@gnu.org>
parents:
diff changeset
305 @findex message-bounce
Dave Love <fx@gnu.org>
parents:
diff changeset
306 The @code{message-bounce} command will, if the current buffer contains a
Dave Love <fx@gnu.org>
parents:
diff changeset
307 bounced mail message, pop up a message buffer stripped of the bounce
Dave Love <fx@gnu.org>
parents:
diff changeset
308 information. A @dfn{bounced message} is typically a mail you've sent
Dave Love <fx@gnu.org>
parents:
diff changeset
309 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
310 undeliverable.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
311
Dave Love <fx@gnu.org>
parents:
diff changeset
312 @vindex message-ignored-bounced-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
313 Headers that match the @code{message-ignored-bounced-headers} regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
314 will be removed before popping up the buffer. The default is
Dave Love <fx@gnu.org>
parents:
diff changeset
315 @samp{^\\(Received\\|Return-Path\\):}.
Dave Love <fx@gnu.org>
parents:
diff changeset
316
Dave Love <fx@gnu.org>
parents:
diff changeset
317
Dave Love <fx@gnu.org>
parents:
diff changeset
318 @node Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
319 @chapter Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
320
Dave Love <fx@gnu.org>
parents:
diff changeset
321 @menu
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
322 * Buffer Entry:: Commands after entering a Message buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
323 * Header Commands:: Commands for moving to headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
324 * Movement:: Moving around in message buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
325 * Insertion:: Inserting things into message buffers.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
326 * MIME:: @sc{mime} considerations.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
327 * Various Commands:: Various things.
Dave Love <fx@gnu.org>
parents:
diff changeset
328 * Sending:: Actually sending the message.
Dave Love <fx@gnu.org>
parents:
diff changeset
329 * Mail Aliases:: How to use mail aliases.
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
330 * Spelling:: Having Emacs check your spelling.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
331 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
332
Dave Love <fx@gnu.org>
parents:
diff changeset
333
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
334 @node Buffer Entry
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
335 @section Buffer Entry
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
336 @cindex undo
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
337 @kindex C-_
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
338
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
339 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
340 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
341 may remove signatures, reformat the text, or the like---depending on
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
342 which used settings you're using. Message usually gets things right,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
343 but sometimes it stumbles. To help the user unwind these stumblings,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
344 Message sets the undo boundary before each major automatic action it
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
345 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
346 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
347
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
348
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
349 @node Header Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
350 @section Header Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
351
Dave Love <fx@gnu.org>
parents:
diff changeset
352 All these commands move to the header in question. If it doesn't exist,
Dave Love <fx@gnu.org>
parents:
diff changeset
353 it will be inserted.
Dave Love <fx@gnu.org>
parents:
diff changeset
354
Dave Love <fx@gnu.org>
parents:
diff changeset
355 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
356
Dave Love <fx@gnu.org>
parents:
diff changeset
357 @item C-c ?
Dave Love <fx@gnu.org>
parents:
diff changeset
358 @kindex C-c ?
Dave Love <fx@gnu.org>
parents:
diff changeset
359 @findex message-goto-to
Dave Love <fx@gnu.org>
parents:
diff changeset
360 Describe the message mode.
Dave Love <fx@gnu.org>
parents:
diff changeset
361
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @item C-c C-f C-t
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
363 @kindex C-c C-f C-t
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
364 @findex message-goto-to
Dave Love <fx@gnu.org>
parents:
diff changeset
365 Go to the @code{To} header (@code{message-goto-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
366
Dave Love <fx@gnu.org>
parents:
diff changeset
367 @item C-c C-f C-b
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
368 @kindex C-c C-f C-b
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
369 @findex message-goto-bcc
Dave Love <fx@gnu.org>
parents:
diff changeset
370 Go to the @code{Bcc} header (@code{message-goto-bcc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
371
33985
ed6683e4a5af Fix goto-... keybindings.
Dave Love <fx@gnu.org>
parents: 33671
diff changeset
372 @item C-c C-f C-w
ed6683e4a5af Fix goto-... keybindings.
Dave Love <fx@gnu.org>
parents: 33671
diff changeset
373 @kindex C-c C-f C-w
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
374 @findex message-goto-fcc
Dave Love <fx@gnu.org>
parents:
diff changeset
375 Go to the @code{Fcc} header (@code{message-goto-fcc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
376
Dave Love <fx@gnu.org>
parents:
diff changeset
377 @item C-c C-f C-c
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
378 @kindex C-c C-f C-c
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
379 @findex message-goto-cc
Dave Love <fx@gnu.org>
parents:
diff changeset
380 Go to the @code{Cc} header (@code{message-goto-cc}).
Dave Love <fx@gnu.org>
parents:
diff changeset
381
Dave Love <fx@gnu.org>
parents:
diff changeset
382 @item C-c C-f C-s
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
383 @kindex C-c C-f C-s
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
384 @findex message-goto-subject
Dave Love <fx@gnu.org>
parents:
diff changeset
385 Go to the @code{Subject} header (@code{message-goto-subject}).
Dave Love <fx@gnu.org>
parents:
diff changeset
386
Dave Love <fx@gnu.org>
parents:
diff changeset
387 @item C-c C-f C-r
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
388 @kindex C-c C-f C-r
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
389 @findex message-goto-reply-to
Dave Love <fx@gnu.org>
parents:
diff changeset
390 Go to the @code{Reply-To} header (@code{message-goto-reply-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
391
Dave Love <fx@gnu.org>
parents:
diff changeset
392 @item C-c C-f C-n
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
393 @kindex C-c C-f C-n
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
394 @findex message-goto-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
395 Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}).
Dave Love <fx@gnu.org>
parents:
diff changeset
396
Dave Love <fx@gnu.org>
parents:
diff changeset
397 @item C-c C-f C-d
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
398 @kindex C-c C-f C-d
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
399 @findex message-goto-distribution
Dave Love <fx@gnu.org>
parents:
diff changeset
400 Go to the @code{Distribution} header (@code{message-goto-distribution}).
Dave Love <fx@gnu.org>
parents:
diff changeset
401
33985
ed6683e4a5af Fix goto-... keybindings.
Dave Love <fx@gnu.org>
parents: 33671
diff changeset
402 @item C-c C-f C-f
ed6683e4a5af Fix goto-... keybindings.
Dave Love <fx@gnu.org>
parents: 33671
diff changeset
403 @kindex C-c C-f C-f
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
404 @findex message-goto-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
405 Go to the @code{Followup-To} header (@code{message-goto-followup-to}).
Dave Love <fx@gnu.org>
parents:
diff changeset
406
Dave Love <fx@gnu.org>
parents:
diff changeset
407 @item C-c C-f C-k
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
408 @kindex C-c C-f C-k
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
409 @findex message-goto-keywords
Dave Love <fx@gnu.org>
parents:
diff changeset
410 Go to the @code{Keywords} header (@code{message-goto-keywords}).
Dave Love <fx@gnu.org>
parents:
diff changeset
411
Dave Love <fx@gnu.org>
parents:
diff changeset
412 @item C-c C-f C-u
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
413 @kindex C-c C-f C-u
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
414 @findex message-goto-summary
Dave Love <fx@gnu.org>
parents:
diff changeset
415 Go to the @code{Summary} header (@code{message-goto-summary}).
Dave Love <fx@gnu.org>
parents:
diff changeset
416
Dave Love <fx@gnu.org>
parents:
diff changeset
417 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
418
Dave Love <fx@gnu.org>
parents:
diff changeset
419
Dave Love <fx@gnu.org>
parents:
diff changeset
420 @node Movement
Dave Love <fx@gnu.org>
parents:
diff changeset
421 @section Movement
Dave Love <fx@gnu.org>
parents:
diff changeset
422
Dave Love <fx@gnu.org>
parents:
diff changeset
423 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
424 @item C-c C-b
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
425 @kindex C-c C-b
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
426 @findex message-goto-body
Dave Love <fx@gnu.org>
parents:
diff changeset
427 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
428 (@code{message-goto-body}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
429
Dave Love <fx@gnu.org>
parents:
diff changeset
430 @item C-c C-i
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
431 @kindex C-c C-i
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
432 @findex message-goto-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
433 Move to the signature of the message (@code{message-goto-signature}).
Dave Love <fx@gnu.org>
parents:
diff changeset
434
Dave Love <fx@gnu.org>
parents:
diff changeset
435 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
436
Dave Love <fx@gnu.org>
parents:
diff changeset
437
Dave Love <fx@gnu.org>
parents:
diff changeset
438 @node Insertion
Dave Love <fx@gnu.org>
parents:
diff changeset
439 @section Insertion
Dave Love <fx@gnu.org>
parents:
diff changeset
440
Dave Love <fx@gnu.org>
parents:
diff changeset
441 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
442
Dave Love <fx@gnu.org>
parents:
diff changeset
443 @item C-c C-y
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
444 @kindex C-c C-y
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
445 @findex message-yank-original
Dave Love <fx@gnu.org>
parents:
diff changeset
446 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
447 (@code{message-yank-original}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
448
40705
421e0a91a1d1 Replace M-C- with C-M-
Eli Zaretskii <eliz@gnu.org>
parents: 38865
diff changeset
449 @item C-c C-M-y
421e0a91a1d1 Replace M-C- with C-M-
Eli Zaretskii <eliz@gnu.org>
parents: 38865
diff changeset
450 @kindex C-c C-M-y
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
451 @findex message-yank-buffer
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
452 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
453 message buffer (@code{message-yank-buffer}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
454
Dave Love <fx@gnu.org>
parents:
diff changeset
455 @item C-c C-q
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
456 @kindex C-c C-q
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
457 @findex message-fill-yanked-message
Dave Love <fx@gnu.org>
parents:
diff changeset
458 Fill the yanked message (@code{message-fill-yanked-message}). Warning:
Dave Love <fx@gnu.org>
parents:
diff changeset
459 Can severely mess up the yanked text if its quoting conventions are
Dave Love <fx@gnu.org>
parents:
diff changeset
460 strange. You'll quickly get a feel for when it's safe, though. Anyway,
Dave Love <fx@gnu.org>
parents:
diff changeset
461 just remember that @kbd{C-x u} (@code{undo}) is available and you'll be
Dave Love <fx@gnu.org>
parents:
diff changeset
462 all right.
Dave Love <fx@gnu.org>
parents:
diff changeset
463
Dave Love <fx@gnu.org>
parents:
diff changeset
464 @item C-c C-w
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
465 @kindex C-c C-w
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
466 @findex message-insert-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
467 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
468 (@code{message-insert-signature}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
469
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
470 @item C-c M-h
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
471 @kindex C-c M-h
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
472 @findex message-insert-headers
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
473 Insert the message headers (@code{message-insert-headers}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
474
Dave Love <fx@gnu.org>
parents:
diff changeset
475 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
476
Dave Love <fx@gnu.org>
parents:
diff changeset
477 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
478 @item message-ignored-cited-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
479 @vindex message-ignored-cited-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
480 All headers that match this regexp will be removed from yanked
Dave Love <fx@gnu.org>
parents:
diff changeset
481 messages. The default is @samp{.}, which means that all headers will be
Dave Love <fx@gnu.org>
parents:
diff changeset
482 removed.
Dave Love <fx@gnu.org>
parents:
diff changeset
483
Dave Love <fx@gnu.org>
parents:
diff changeset
484 @item message-citation-line-function
Dave Love <fx@gnu.org>
parents:
diff changeset
485 @vindex message-citation-line-function
Dave Love <fx@gnu.org>
parents:
diff changeset
486 Function called to insert the citation line. The default is
Dave Love <fx@gnu.org>
parents:
diff changeset
487 @code{message-insert-citation-line}, which will lead to citation lines
Dave Love <fx@gnu.org>
parents:
diff changeset
488 that look like:
Dave Love <fx@gnu.org>
parents:
diff changeset
489
Dave Love <fx@gnu.org>
parents:
diff changeset
490 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
491 Hallvard B Furuseth <h.b.furuseth@@usit.uio.no> writes:
Dave Love <fx@gnu.org>
parents:
diff changeset
492 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
493
Dave Love <fx@gnu.org>
parents:
diff changeset
494 Point will be at the beginning of the body of the message when this
Dave Love <fx@gnu.org>
parents:
diff changeset
495 function is called.
Dave Love <fx@gnu.org>
parents:
diff changeset
496
Dave Love <fx@gnu.org>
parents:
diff changeset
497 @item message-yank-prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
498 @vindex message-yank-prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
499 @cindex yanking
Dave Love <fx@gnu.org>
parents:
diff changeset
500 @cindex quoting
Dave Love <fx@gnu.org>
parents:
diff changeset
501 When you are replying to or following up an article, you normally want
Dave Love <fx@gnu.org>
parents:
diff changeset
502 to quote the person you are answering. Inserting quoted text is done by
Dave Love <fx@gnu.org>
parents:
diff changeset
503 @dfn{yanking}, and each quoted line you yank will have
Dave Love <fx@gnu.org>
parents:
diff changeset
504 @code{message-yank-prefix} prepended to it. The default is @samp{> }.
Dave Love <fx@gnu.org>
parents:
diff changeset
505
Dave Love <fx@gnu.org>
parents:
diff changeset
506 @item message-indentation-spaces
Dave Love <fx@gnu.org>
parents:
diff changeset
507 @vindex message-indentation-spaces
Dave Love <fx@gnu.org>
parents:
diff changeset
508 Number of spaces to indent yanked messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
509
Dave Love <fx@gnu.org>
parents:
diff changeset
510 @item message-cite-function
Dave Love <fx@gnu.org>
parents:
diff changeset
511 @vindex message-cite-function
Dave Love <fx@gnu.org>
parents:
diff changeset
512 @findex message-cite-original
Dave Love <fx@gnu.org>
parents:
diff changeset
513 @findex sc-cite-original
Dave Love <fx@gnu.org>
parents:
diff changeset
514 @findex message-cite-original-without-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
515 @cindex Supercite
Dave Love <fx@gnu.org>
parents:
diff changeset
516 Function for citing an original message. The default is
Dave Love <fx@gnu.org>
parents:
diff changeset
517 @code{message-cite-original}, which simply inserts the original message
Dave Love <fx@gnu.org>
parents:
diff changeset
518 and prepends @samp{> } to each line.
Dave Love <fx@gnu.org>
parents:
diff changeset
519 @code{message-cite-original-without-signature} does the same, but elides
Dave Love <fx@gnu.org>
parents:
diff changeset
520 the signature. You can also set it to @code{sc-cite-original} to use
Dave Love <fx@gnu.org>
parents:
diff changeset
521 Supercite.
Dave Love <fx@gnu.org>
parents:
diff changeset
522
Dave Love <fx@gnu.org>
parents:
diff changeset
523 @item message-indent-citation-function
Dave Love <fx@gnu.org>
parents:
diff changeset
524 @vindex message-indent-citation-function
Dave Love <fx@gnu.org>
parents:
diff changeset
525 Function for modifying a citation just inserted in the mail buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
526 This can also be a list of functions. Each function can find the
Dave Love <fx@gnu.org>
parents:
diff changeset
527 citation between @code{(point)} and @code{(mark t)}. And each function
Dave Love <fx@gnu.org>
parents:
diff changeset
528 should leave point and mark around the citation text as modified.
Dave Love <fx@gnu.org>
parents:
diff changeset
529
Dave Love <fx@gnu.org>
parents:
diff changeset
530 @item message-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
531 @vindex message-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
532 String to be inserted at the end of the message buffer. If @code{t}
Dave Love <fx@gnu.org>
parents:
diff changeset
533 (which is the default), the @code{message-signature-file} file will be
Dave Love <fx@gnu.org>
parents:
diff changeset
534 inserted instead. If a function, the result from the function will be
Dave Love <fx@gnu.org>
parents:
diff changeset
535 used instead. If a form, the result from the form will be used instead.
Dave Love <fx@gnu.org>
parents:
diff changeset
536 If this variable is @code{nil}, no signature will be inserted at all.
Dave Love <fx@gnu.org>
parents:
diff changeset
537
Dave Love <fx@gnu.org>
parents:
diff changeset
538 @item message-signature-file
Dave Love <fx@gnu.org>
parents:
diff changeset
539 @vindex message-signature-file
36056
6caf2957c4a8 Expand on message-signature-file.
Dave Love <fx@gnu.org>
parents: 35614
diff changeset
540 If non-@code{nil} the name of a file containing the signature to be
6caf2957c4a8 Expand on message-signature-file.
Dave Love <fx@gnu.org>
parents: 35614
diff changeset
541 inserted at the end of the buffer. This is ignored if the file
6caf2957c4a8 Expand on message-signature-file.
Dave Love <fx@gnu.org>
parents: 35614
diff changeset
542 doesn't exist. The default is @samp{~/.signature}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
543
Dave Love <fx@gnu.org>
parents:
diff changeset
544 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
545
Dave Love <fx@gnu.org>
parents:
diff changeset
546 Note that RFC1036bis says that a signature should be preceded by the three
Dave Love <fx@gnu.org>
parents:
diff changeset
547 characters @samp{-- } on a line by themselves. This is to make it
Dave Love <fx@gnu.org>
parents:
diff changeset
548 easier for the recipient to automatically recognize and process the
Dave Love <fx@gnu.org>
parents:
diff changeset
549 signature. So don't remove those characters, even though you might feel
Dave Love <fx@gnu.org>
parents:
diff changeset
550 that they ruin your beautiful design, like, totally.
Dave Love <fx@gnu.org>
parents:
diff changeset
551
Dave Love <fx@gnu.org>
parents:
diff changeset
552 Also note that no signature should be more than four lines long.
Dave Love <fx@gnu.org>
parents:
diff changeset
553 Including ASCII graphics is an efficient way to get everybody to believe
Dave Love <fx@gnu.org>
parents:
diff changeset
554 that you are silly and have nothing important to say.
Dave Love <fx@gnu.org>
parents:
diff changeset
555
Dave Love <fx@gnu.org>
parents:
diff changeset
556
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
557 @node MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
558 @section MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
559 @cindex MML
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
560 @cindex MIME
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
561 @cindex multipart
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
562 @cindex attachment
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
563
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
564 Message is a @sc{mime}-compliant posting agent. The user generally
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
565 doesn't have to do anything to make the @sc{mime} happen---Message will
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
566 automatically add the @code{Content-Type} and
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
567 @code{Content-Transfer-Encoding} headers.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
568
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
569 The most typical thing users want to use the multipart things in
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
570 @sc{mime} for is to add ``attachments'' to mail they send out. This can
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
571 be done with the @code{C-c C-a} command, which will prompt for a file
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
572 name and a @sc{mime} type.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
573
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
574 You can also create arbitrarily complex multiparts using the MML
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
575 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
576 Manual}).
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
577
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
578
Dave Love <fx@gnu.org>
parents:
diff changeset
579 @node Various Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
580 @section Various Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
581
Dave Love <fx@gnu.org>
parents:
diff changeset
582 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
583
Dave Love <fx@gnu.org>
parents:
diff changeset
584 @item C-c C-r
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
585 @kindex C-c C-r
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
586 @findex message-caesar-buffer-body
Dave Love <fx@gnu.org>
parents:
diff changeset
587 Caesar rotate (aka. rot13) the current message
Dave Love <fx@gnu.org>
parents:
diff changeset
588 (@code{message-caesar-buffer-body}). If narrowing is in effect, just
Dave Love <fx@gnu.org>
parents:
diff changeset
589 rotate the visible portion of the buffer. A numerical prefix says how
Dave Love <fx@gnu.org>
parents:
diff changeset
590 many places to rotate the text. The default is 13.
Dave Love <fx@gnu.org>
parents:
diff changeset
591
Dave Love <fx@gnu.org>
parents:
diff changeset
592 @item C-c C-e
Dave Love <fx@gnu.org>
parents:
diff changeset
593 @kindex C-c C-e
Dave Love <fx@gnu.org>
parents:
diff changeset
594 @findex message-elide-region
Dave Love <fx@gnu.org>
parents:
diff changeset
595 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
596 The text is killed and replaced with the contents of the variable
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
597 @code{message-elide-ellipsis}. The default value is to use an ellipsis
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
598 (@samp{[...]}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
599
Dave Love <fx@gnu.org>
parents:
diff changeset
600 @item C-c C-z
Dave Love <fx@gnu.org>
parents:
diff changeset
601 @kindex C-c C-x
Dave Love <fx@gnu.org>
parents:
diff changeset
602 @findex message-kill-to-signature
Dave Love <fx@gnu.org>
parents:
diff changeset
603 Kill all the text up to the signature, or if that's missing, up to the
Dave Love <fx@gnu.org>
parents:
diff changeset
604 end of the message (@code{message-kill-to-signature}).
Dave Love <fx@gnu.org>
parents:
diff changeset
605
Dave Love <fx@gnu.org>
parents:
diff changeset
606 @item C-c C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
607 @kindex C-c C-v
Dave Love <fx@gnu.org>
parents:
diff changeset
608 @findex message-delete-not-region
Dave Love <fx@gnu.org>
parents:
diff changeset
609 Delete all text in the body of the message that is outside the region
Dave Love <fx@gnu.org>
parents:
diff changeset
610 (@code{message-delete-not-region}).
Dave Love <fx@gnu.org>
parents:
diff changeset
611
Dave Love <fx@gnu.org>
parents:
diff changeset
612 @item M-RET
Dave Love <fx@gnu.org>
parents:
diff changeset
613 @kindex M-RET
Dave Love <fx@gnu.org>
parents:
diff changeset
614 @kindex message-newline-and-reformat
Dave Love <fx@gnu.org>
parents:
diff changeset
615 Insert four newlines, and then reformat if inside quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
616
Dave Love <fx@gnu.org>
parents:
diff changeset
617 Here's an example:
Dave Love <fx@gnu.org>
parents:
diff changeset
618
Dave Love <fx@gnu.org>
parents:
diff changeset
619 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
620 > This is some quoted text. And here's more quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
621 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
622
Dave Love <fx@gnu.org>
parents:
diff changeset
623 If point is before @samp{And} and you press @kbd{M-RET}, you'll get:
Dave Love <fx@gnu.org>
parents:
diff changeset
624
Dave Love <fx@gnu.org>
parents:
diff changeset
625 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
626 > This is some quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
627
Dave Love <fx@gnu.org>
parents:
diff changeset
628 *
Dave Love <fx@gnu.org>
parents:
diff changeset
629
Dave Love <fx@gnu.org>
parents:
diff changeset
630 > And here's more quoted text.
Dave Love <fx@gnu.org>
parents:
diff changeset
631 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
632
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
633 @samp{*} says where point will be placed.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
634
Dave Love <fx@gnu.org>
parents:
diff changeset
635 @item C-c C-t
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
636 @kindex C-c C-t
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
637 @findex message-insert-to
Dave Love <fx@gnu.org>
parents:
diff changeset
638 Insert a @code{To} header that contains the @code{Reply-To} or
Dave Love <fx@gnu.org>
parents:
diff changeset
639 @code{From} header of the message you're following up
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
640 (@code{message-insert-to}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
641
Dave Love <fx@gnu.org>
parents:
diff changeset
642 @item C-c C-n
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
643 @kindex C-c C-n
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
644 @findex message-insert-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
645 Insert a @code{Newsgroups} header that reflects the @code{Followup-To}
Dave Love <fx@gnu.org>
parents:
diff changeset
646 or @code{Newsgroups} header of the article you're replying to
Dave Love <fx@gnu.org>
parents:
diff changeset
647 (@code{message-insert-newsgroups}).
Dave Love <fx@gnu.org>
parents:
diff changeset
648
Dave Love <fx@gnu.org>
parents:
diff changeset
649 @item C-c M-r
Dave Love <fx@gnu.org>
parents:
diff changeset
650 @kindex C-c M-r
Dave Love <fx@gnu.org>
parents:
diff changeset
651 @findex message-rename-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
652 Rename the buffer (@code{message-rename-buffer}). If given a prefix,
Dave Love <fx@gnu.org>
parents:
diff changeset
653 prompt for a new buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
654
Dave Love <fx@gnu.org>
parents:
diff changeset
655 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
656
Dave Love <fx@gnu.org>
parents:
diff changeset
657
Dave Love <fx@gnu.org>
parents:
diff changeset
658 @node Sending
Dave Love <fx@gnu.org>
parents:
diff changeset
659 @section Sending
Dave Love <fx@gnu.org>
parents:
diff changeset
660
Dave Love <fx@gnu.org>
parents:
diff changeset
661 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
662 @item C-c C-c
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
663 @kindex C-c C-c
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
664 @findex message-send-and-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
665 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
666 (@code{message-send-and-exit}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
667
Dave Love <fx@gnu.org>
parents:
diff changeset
668 @item C-c C-s
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
669 @kindex C-c C-s
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
670 @findex message-send
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
671 Send the message (@code{message-send}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
672
Dave Love <fx@gnu.org>
parents:
diff changeset
673 @item C-c C-d
Dave Love <fx@gnu.org>
parents:
diff changeset
674 @kindex C-c C-d
Dave Love <fx@gnu.org>
parents:
diff changeset
675 @findex message-dont-send
Dave Love <fx@gnu.org>
parents:
diff changeset
676 Bury the message buffer and exit (@code{message-dont-send}).
Dave Love <fx@gnu.org>
parents:
diff changeset
677
Dave Love <fx@gnu.org>
parents:
diff changeset
678 @item C-c C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
679 @kindex C-c C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
680 @findex message-kill-buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
681 Kill the message buffer and exit (@code{message-kill-buffer}).
Dave Love <fx@gnu.org>
parents:
diff changeset
682
Dave Love <fx@gnu.org>
parents:
diff changeset
683 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
684
Dave Love <fx@gnu.org>
parents:
diff changeset
685
Dave Love <fx@gnu.org>
parents:
diff changeset
686
Dave Love <fx@gnu.org>
parents:
diff changeset
687 @node Mail Aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
688 @section Mail Aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
689 @cindex mail aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
690 @cindex aliases
Dave Love <fx@gnu.org>
parents:
diff changeset
691
Dave Love <fx@gnu.org>
parents:
diff changeset
692 @vindex message-mail-alias-type
Dave Love <fx@gnu.org>
parents:
diff changeset
693 The @code{message-mail-alias-type} variable controls what type of mail
Dave Love <fx@gnu.org>
parents:
diff changeset
694 alias expansion to use. Currently only one form is supported---Message
Dave Love <fx@gnu.org>
parents:
diff changeset
695 uses @code{mailabbrev} to handle mail aliases. If this variable is
Dave Love <fx@gnu.org>
parents:
diff changeset
696 @code{nil}, no mail alias expansion will be performed.
Dave Love <fx@gnu.org>
parents:
diff changeset
697
Dave Love <fx@gnu.org>
parents:
diff changeset
698 @code{mailabbrev} works by parsing the @file{/etc/mailrc} and
Dave Love <fx@gnu.org>
parents:
diff changeset
699 @file{~/.mailrc} files. These files look like:
Dave Love <fx@gnu.org>
parents:
diff changeset
700
Dave Love <fx@gnu.org>
parents:
diff changeset
701 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
702 alias lmi "Lars Magne Ingebrigtsen <larsi@@ifi.uio.no>"
Dave Love <fx@gnu.org>
parents:
diff changeset
703 alias ding "ding@@ifi.uio.no (ding mailing list)"
Dave Love <fx@gnu.org>
parents:
diff changeset
704 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
705
Dave Love <fx@gnu.org>
parents:
diff changeset
706 After adding lines like this to your @file{~/.mailrc} file, you should
Dave Love <fx@gnu.org>
parents:
diff changeset
707 be able to just write @samp{lmi} in the @code{To} or @code{Cc} (and so
Dave Love <fx@gnu.org>
parents:
diff changeset
708 on) headers and press @kbd{SPC} to expand the alias.
Dave Love <fx@gnu.org>
parents:
diff changeset
709
Dave Love <fx@gnu.org>
parents:
diff changeset
710 No expansion will be performed upon sending of the message---all
Dave Love <fx@gnu.org>
parents:
diff changeset
711 expansions have to be done explicitly.
Dave Love <fx@gnu.org>
parents:
diff changeset
712
Dave Love <fx@gnu.org>
parents:
diff changeset
713
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
714 @node Spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
715 @section Spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
716 @cindex spelling
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
717 @findex ispell-message
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
718
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
719 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
720 @code{ispell} and @code{flyspell}. @code{ispell} is the older and
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
721 probably more popular package. You typically first write the message,
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
722 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
723 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
724 something like the following in your @file{.emacs} file:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
725
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
726 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
727 (add-hook 'message-send-hook 'ispell-message)
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
728 @end lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
729
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
730 @vindex ispell-message-dictionary-alist
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
731 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
732 controlled by the @code{ispell-message-dictionary-alist} variable:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
733
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
734 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
735 (setq ispell-message-dictionary-alist
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
736 '(("^Newsgroups:.*\\bde\\." . "deutsch8")
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
737 (".*" . "default")))
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
738 @end lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
739
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
740 @code{ispell} depends on having the external @samp{ispell} command
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
741 installed.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
742
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
743 The other popular method is using @code{flyspell}. This package checks
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
744 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
745 various ways.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
746
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
747 To use @code{flyspell}, put something like the following in your
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
748 @file{.emacs} file:
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
749
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
750 @lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
751 (defun my-message-setup-routine ()
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
752 (flyspell-mode 1))
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
753 (add-hook 'message-setup-hook 'my-message-setup-routine)
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
754 @end lisp
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
755
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
756 @code{flyspell} depends on having the external @samp{ispell} command
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
757 installed.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
758
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
759
Dave Love <fx@gnu.org>
parents:
diff changeset
760 @node Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
761 @chapter Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
762
Dave Love <fx@gnu.org>
parents:
diff changeset
763 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
764 * Message Headers:: General message header stuff.
Dave Love <fx@gnu.org>
parents:
diff changeset
765 * Mail Headers:: Customizing mail headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
766 * Mail Variables:: Other mail variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
767 * News Headers:: Customizing news headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
768 * News Variables:: Other news variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
769 * Various Message Variables:: Other message variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
770 * Sending Variables:: Variables for sending.
Dave Love <fx@gnu.org>
parents:
diff changeset
771 * Message Buffers:: How Message names its buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
772 * Message Actions:: Actions to be performed when exiting.
Dave Love <fx@gnu.org>
parents:
diff changeset
773 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
774
Dave Love <fx@gnu.org>
parents:
diff changeset
775
Dave Love <fx@gnu.org>
parents:
diff changeset
776 @node Message Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
777 @section Message Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
778
Dave Love <fx@gnu.org>
parents:
diff changeset
779 Message is quite aggressive on the message generation front. It has to
Dave Love <fx@gnu.org>
parents:
diff changeset
780 be -- it's a combined news and mail agent. To be able to send combined
Dave Love <fx@gnu.org>
parents:
diff changeset
781 messages, it has to generate all headers itself (instead of letting the
Dave Love <fx@gnu.org>
parents:
diff changeset
782 mail/news system do it) to ensure that mail and news copies of messages
Dave Love <fx@gnu.org>
parents:
diff changeset
783 look sufficiently similar.
Dave Love <fx@gnu.org>
parents:
diff changeset
784
Dave Love <fx@gnu.org>
parents:
diff changeset
785 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
786
Dave Love <fx@gnu.org>
parents:
diff changeset
787 @item message-generate-headers-first
Dave Love <fx@gnu.org>
parents:
diff changeset
788 @vindex message-generate-headers-first
36073
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
789 If non-@code{nil}, generate all required headers before starting to
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
790 compose the message.
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
791
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
792 The variables @code{message-required-mail-headers} and
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
793 @code{message-required-news-headers} specify which headers are required.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
794
Dave Love <fx@gnu.org>
parents:
diff changeset
795 @item message-from-style
Dave Love <fx@gnu.org>
parents:
diff changeset
796 @vindex message-from-style
Dave Love <fx@gnu.org>
parents:
diff changeset
797 Specifies how @code{From} headers should look. There are four valid
Dave Love <fx@gnu.org>
parents:
diff changeset
798 values:
Dave Love <fx@gnu.org>
parents:
diff changeset
799
Dave Love <fx@gnu.org>
parents:
diff changeset
800 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
801 @item nil
Dave Love <fx@gnu.org>
parents:
diff changeset
802 Just the address -- @samp{king@@grassland.com}.
Dave Love <fx@gnu.org>
parents:
diff changeset
803
Dave Love <fx@gnu.org>
parents:
diff changeset
804 @item parens
Dave Love <fx@gnu.org>
parents:
diff changeset
805 @samp{king@@grassland.com (Elvis Parsley)}.
Dave Love <fx@gnu.org>
parents:
diff changeset
806
Dave Love <fx@gnu.org>
parents:
diff changeset
807 @item angles
Dave Love <fx@gnu.org>
parents:
diff changeset
808 @samp{Elvis Parsley <king@@grassland.com>}.
Dave Love <fx@gnu.org>
parents:
diff changeset
809
Dave Love <fx@gnu.org>
parents:
diff changeset
810 @item default
Dave Love <fx@gnu.org>
parents:
diff changeset
811 Look like @code{angles} if that doesn't require quoting, and
Dave Love <fx@gnu.org>
parents:
diff changeset
812 @code{parens} if it does. If even @code{parens} requires quoting, use
Dave Love <fx@gnu.org>
parents:
diff changeset
813 @code{angles} anyway.
Dave Love <fx@gnu.org>
parents:
diff changeset
814
Dave Love <fx@gnu.org>
parents:
diff changeset
815 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
816
Dave Love <fx@gnu.org>
parents:
diff changeset
817 @item message-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
818 @vindex message-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
819 Headers in this list that were previously generated by Message will be
Dave Love <fx@gnu.org>
parents:
diff changeset
820 deleted before posting. Let's say you post an article. Then you decide
Dave Love <fx@gnu.org>
parents:
diff changeset
821 to post it again to some other group, you naughty boy, so you jump back
Dave Love <fx@gnu.org>
parents:
diff changeset
822 to the @code{*post-buf*} buffer, edit the @code{Newsgroups} line, and
Dave Love <fx@gnu.org>
parents:
diff changeset
823 ship it off again. By default, this variable makes sure that the old
Dave Love <fx@gnu.org>
parents:
diff changeset
824 generated @code{Message-ID} is deleted, and a new one generated. If
Dave Love <fx@gnu.org>
parents:
diff changeset
825 this isn't done, the entire empire would probably crumble, anarchy would
Dave Love <fx@gnu.org>
parents:
diff changeset
826 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
827 Allegedly.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
828
Dave Love <fx@gnu.org>
parents:
diff changeset
829 @item message-default-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
830 @vindex message-default-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
831 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
832 buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
833
Dave Love <fx@gnu.org>
parents:
diff changeset
834 @item message-subject-re-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
835 @vindex message-subject-re-regexp
Dave Love <fx@gnu.org>
parents:
diff changeset
836 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
837 is @emph{not} an abbreviation of the English word ``response'', but is
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
838 Latin, and means ``in response to''. Some illiterate nincompoops have
Dave Love <fx@gnu.org>
parents:
diff changeset
839 failed to grasp this fact, and have ``internationalized'' their software
Dave Love <fx@gnu.org>
parents:
diff changeset
840 to use abonimations like @samp{Aw: } (``antwort'') or @samp{Sv: }
Dave Love <fx@gnu.org>
parents:
diff changeset
841 (``svar'') instead, which is meaningless and evil. However, you may
Dave Love <fx@gnu.org>
parents:
diff changeset
842 have to deal with users that use these evil tools, in which case you may
Dave Love <fx@gnu.org>
parents:
diff changeset
843 set this variable to a regexp that matches these prefixes. Myself, I
Dave Love <fx@gnu.org>
parents:
diff changeset
844 just throw away non-compliant mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
845
32314
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
846 @item message-alternative-emails
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
847 @vindex message-alternative-emails
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
848 A regexp to match the alternative email addresses. The first matched
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
849 address (not primary one) is used in the @code{From} field.
580e2337bd7e *** empty log message ***
Dave Love <fx@gnu.org>
parents: 32250
diff changeset
850
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
851 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
852
Dave Love <fx@gnu.org>
parents:
diff changeset
853
Dave Love <fx@gnu.org>
parents:
diff changeset
854 @node Mail Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
855 @section Mail Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
856
Dave Love <fx@gnu.org>
parents:
diff changeset
857 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
858 @item message-required-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
859 @vindex message-required-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
860 @xref{News Headers}, for the syntax of this variable. It is
Dave Love <fx@gnu.org>
parents:
diff changeset
861 @code{(From Date Subject (optional . In-Reply-To) Message-ID Lines
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
862 (optional . User-Agent))} by default.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
863
Dave Love <fx@gnu.org>
parents:
diff changeset
864 @item message-ignored-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
865 @vindex message-ignored-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
866 Regexp of headers to be removed before mailing. The default is
36073
1e82db65f969 message-generate-headers-first, message-ignored-mail-headers fixes
Dave Love <fx@gnu.org>
parents: 36056
diff changeset
867 @samp{^[GF]cc:\|^Resent-Fcc:\|^Xref:}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
868
Dave Love <fx@gnu.org>
parents:
diff changeset
869 @item message-default-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
870 @vindex message-default-mail-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
871 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
872 buffers that are initialized as mail.
Dave Love <fx@gnu.org>
parents:
diff changeset
873
Dave Love <fx@gnu.org>
parents:
diff changeset
874 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
875
Dave Love <fx@gnu.org>
parents:
diff changeset
876
Dave Love <fx@gnu.org>
parents:
diff changeset
877 @node Mail Variables
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
878 @section Mail Variables
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
879
Dave Love <fx@gnu.org>
parents:
diff changeset
880 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
881 @item message-send-mail-function
Dave Love <fx@gnu.org>
parents:
diff changeset
882 @vindex message-send-mail-function
Dave Love <fx@gnu.org>
parents:
diff changeset
883 Function used to send the current buffer as mail. The default is
Dave Love <fx@gnu.org>
parents:
diff changeset
884 @code{message-send-mail-with-sendmail}. If you prefer using MH
Dave Love <fx@gnu.org>
parents:
diff changeset
885 instead, set this variable to @code{message-send-mail-with-mh}.
Dave Love <fx@gnu.org>
parents:
diff changeset
886
Dave Love <fx@gnu.org>
parents:
diff changeset
887 @item message-mh-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
888 @vindex message-mh-deletable-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
889 Most versions of MH doesn't like being fed messages that contain the
Dave Love <fx@gnu.org>
parents:
diff changeset
890 headers in this variable. If this variable is non-@code{nil} (which is
Dave Love <fx@gnu.org>
parents:
diff changeset
891 the default), these headers will be removed before mailing when sending
Dave Love <fx@gnu.org>
parents:
diff changeset
892 messages via MH. Set it to @code{nil} if your MH can handle these
Dave Love <fx@gnu.org>
parents:
diff changeset
893 headers.
Dave Love <fx@gnu.org>
parents:
diff changeset
894
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
895 @item message-send-mail-partially-limit
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
896 @vindex message-send-mail-partially-limit
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
897 The limit on the size of messages sent as @samp{message/partial}.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
898 This is the minimum message size in characters beyond which the
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
899 message should be sent in several parts. If it is @code{nil}, the
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
900 size is unlimited.
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
901
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
902 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
903
Dave Love <fx@gnu.org>
parents:
diff changeset
904
Dave Love <fx@gnu.org>
parents:
diff changeset
905 @node News Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
906 @section News Headers
Dave Love <fx@gnu.org>
parents:
diff changeset
907
Dave Love <fx@gnu.org>
parents:
diff changeset
908 @vindex message-required-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
909 @code{message-required-news-headers} a list of header symbols. These
Dave Love <fx@gnu.org>
parents:
diff changeset
910 headers will either be automatically generated, or, if that's
Dave Love <fx@gnu.org>
parents:
diff changeset
911 impossible, they will be prompted for. The following symbols are valid:
Dave Love <fx@gnu.org>
parents:
diff changeset
912
Dave Love <fx@gnu.org>
parents:
diff changeset
913 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
914
Dave Love <fx@gnu.org>
parents:
diff changeset
915 @item From
Dave Love <fx@gnu.org>
parents:
diff changeset
916 @cindex From
Dave Love <fx@gnu.org>
parents:
diff changeset
917 @findex user-full-name
Dave Love <fx@gnu.org>
parents:
diff changeset
918 @findex user-mail-address
Dave Love <fx@gnu.org>
parents:
diff changeset
919 This required header will be filled out with the result of the
Dave Love <fx@gnu.org>
parents:
diff changeset
920 @code{message-make-from} function, which depends on the
Dave Love <fx@gnu.org>
parents:
diff changeset
921 @code{message-from-style}, @code{user-full-name},
Dave Love <fx@gnu.org>
parents:
diff changeset
922 @code{user-mail-address} variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
923
Dave Love <fx@gnu.org>
parents:
diff changeset
924 @item Subject
Dave Love <fx@gnu.org>
parents:
diff changeset
925 @cindex Subject
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
926 This required header will be prompted for if not present already.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
927
Dave Love <fx@gnu.org>
parents:
diff changeset
928 @item Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
929 @cindex Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
930 This required header says which newsgroups the article is to be posted
Dave Love <fx@gnu.org>
parents:
diff changeset
931 to. If it isn't present already, it will be prompted for.
Dave Love <fx@gnu.org>
parents:
diff changeset
932
Dave Love <fx@gnu.org>
parents:
diff changeset
933 @item Organization
Dave Love <fx@gnu.org>
parents:
diff changeset
934 @cindex organization
Dave Love <fx@gnu.org>
parents:
diff changeset
935 This optional header will be filled out depending on the
Dave Love <fx@gnu.org>
parents:
diff changeset
936 @code{message-user-organization} variable.
Dave Love <fx@gnu.org>
parents:
diff changeset
937 @code{message-user-organization-file} will be used if this variable is
Dave Love <fx@gnu.org>
parents:
diff changeset
938 @code{t}. This variable can also be a string (in which case this string
Dave Love <fx@gnu.org>
parents:
diff changeset
939 will be used), or it can be a function (which will be called with no
Dave Love <fx@gnu.org>
parents:
diff changeset
940 parameters and should return a string to be used).
Dave Love <fx@gnu.org>
parents:
diff changeset
941
Dave Love <fx@gnu.org>
parents:
diff changeset
942 @item Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
943 @cindex Lines
Dave Love <fx@gnu.org>
parents:
diff changeset
944 This optional header will be computed by Message.
Dave Love <fx@gnu.org>
parents:
diff changeset
945
Dave Love <fx@gnu.org>
parents:
diff changeset
946 @item Message-ID
Dave Love <fx@gnu.org>
parents:
diff changeset
947 @cindex Message-ID
Dave Love <fx@gnu.org>
parents:
diff changeset
948 @vindex mail-host-address
Dave Love <fx@gnu.org>
parents:
diff changeset
949 @findex system-name
Dave Love <fx@gnu.org>
parents:
diff changeset
950 @cindex Sun
Dave Love <fx@gnu.org>
parents:
diff changeset
951 This required header will be generated by Message. A unique ID will be
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
952 created based on the date, time, user name and system name. Message
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
953 will use @code{system-name} to determine the name of the system. If
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
954 this isn't a fully qualified domain name (FQDN), Message will use
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
955 @code{mail-host-address} as the FQDN of the machine.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
956
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
957 @item User-Agent
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
958 @cindex User-Agent
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
959 This optional header will be filled out according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
960 @code{message-newsreader} local variable.
Dave Love <fx@gnu.org>
parents:
diff changeset
961
Dave Love <fx@gnu.org>
parents:
diff changeset
962 @item In-Reply-To
Dave Love <fx@gnu.org>
parents:
diff changeset
963 This optional header is filled out using the @code{Date} and @code{From}
Dave Love <fx@gnu.org>
parents:
diff changeset
964 header of the article being replied to.
Dave Love <fx@gnu.org>
parents:
diff changeset
965
Dave Love <fx@gnu.org>
parents:
diff changeset
966 @item Expires
Dave Love <fx@gnu.org>
parents:
diff changeset
967 @cindex Expires
Dave Love <fx@gnu.org>
parents:
diff changeset
968 This extremely optional header will be inserted according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
969 @code{message-expires} variable. It is highly deprecated and shouldn't
Dave Love <fx@gnu.org>
parents:
diff changeset
970 be used unless you know what you're doing.
Dave Love <fx@gnu.org>
parents:
diff changeset
971
Dave Love <fx@gnu.org>
parents:
diff changeset
972 @item Distribution
Dave Love <fx@gnu.org>
parents:
diff changeset
973 @cindex Distribution
Dave Love <fx@gnu.org>
parents:
diff changeset
974 This optional header is filled out according to the
Dave Love <fx@gnu.org>
parents:
diff changeset
975 @code{message-distribution-function} variable. It is a deprecated and
Dave Love <fx@gnu.org>
parents:
diff changeset
976 much misunderstood header.
Dave Love <fx@gnu.org>
parents:
diff changeset
977
Dave Love <fx@gnu.org>
parents:
diff changeset
978 @item Path
Dave Love <fx@gnu.org>
parents:
diff changeset
979 @cindex path
Dave Love <fx@gnu.org>
parents:
diff changeset
980 This extremely optional header should probably never be used.
Dave Love <fx@gnu.org>
parents:
diff changeset
981 However, some @emph{very} old servers require that this header is
Dave Love <fx@gnu.org>
parents:
diff changeset
982 present. @code{message-user-path} further controls how this
Dave Love <fx@gnu.org>
parents:
diff changeset
983 @code{Path} header is to look. If it is @code{nil}, use the server name
Dave Love <fx@gnu.org>
parents:
diff changeset
984 as the leaf node. If it is a string, use the string. If it is neither
Dave Love <fx@gnu.org>
parents:
diff changeset
985 a string nor @code{nil}, use the user name only. However, it is highly
Dave Love <fx@gnu.org>
parents:
diff changeset
986 unlikely that you should need to fiddle with this variable at all.
Dave Love <fx@gnu.org>
parents:
diff changeset
987 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
988
Dave Love <fx@gnu.org>
parents:
diff changeset
989 @findex yow
Dave Love <fx@gnu.org>
parents:
diff changeset
990 @cindex Mime-Version
Dave Love <fx@gnu.org>
parents:
diff changeset
991 In addition, you can enter conses into this list. The car of this cons
Dave Love <fx@gnu.org>
parents:
diff changeset
992 should be a symbol. This symbol's name is the name of the header, and
Dave Love <fx@gnu.org>
parents:
diff changeset
993 the cdr can either be a string to be entered verbatim as the value of
Dave Love <fx@gnu.org>
parents:
diff changeset
994 this header, or it can be a function to be called. This function should
Dave Love <fx@gnu.org>
parents:
diff changeset
995 return a string to be inserted. For instance, if you want to insert
Dave Love <fx@gnu.org>
parents:
diff changeset
996 @code{Mime-Version: 1.0}, you should enter @code{(Mime-Version . "1.0")}
Dave Love <fx@gnu.org>
parents:
diff changeset
997 into the list. If you want to insert a funny quote, you could enter
Dave Love <fx@gnu.org>
parents:
diff changeset
998 something like @code{(X-Yow . yow)} into the list. The function
Dave Love <fx@gnu.org>
parents:
diff changeset
999 @code{yow} will then be called without any arguments.
Dave Love <fx@gnu.org>
parents:
diff changeset
1000
Dave Love <fx@gnu.org>
parents:
diff changeset
1001 If the list contains a cons where the car of the cons is
Dave Love <fx@gnu.org>
parents:
diff changeset
1002 @code{optional}, the cdr of this cons will only be inserted if it is
Dave Love <fx@gnu.org>
parents:
diff changeset
1003 non-@code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1004
Dave Love <fx@gnu.org>
parents:
diff changeset
1005 Other variables for customizing outgoing news articles:
Dave Love <fx@gnu.org>
parents:
diff changeset
1006
Dave Love <fx@gnu.org>
parents:
diff changeset
1007 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1008
Dave Love <fx@gnu.org>
parents:
diff changeset
1009 @item message-syntax-checks
Dave Love <fx@gnu.org>
parents:
diff changeset
1010 @vindex message-syntax-checks
Dave Love <fx@gnu.org>
parents:
diff changeset
1011 Controls what syntax checks should not be performed on outgoing posts.
Dave Love <fx@gnu.org>
parents:
diff changeset
1012 To disable checking of long signatures, for instance, add
Dave Love <fx@gnu.org>
parents:
diff changeset
1013
Dave Love <fx@gnu.org>
parents:
diff changeset
1014 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1015 (signature . disabled)
Dave Love <fx@gnu.org>
parents:
diff changeset
1016 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1017
Dave Love <fx@gnu.org>
parents:
diff changeset
1018 to this list.
Dave Love <fx@gnu.org>
parents:
diff changeset
1019
Dave Love <fx@gnu.org>
parents:
diff changeset
1020 Valid checks are:
Dave Love <fx@gnu.org>
parents:
diff changeset
1021
Dave Love <fx@gnu.org>
parents:
diff changeset
1022 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1023 @item subject-cmsg
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1024 Check the subject for commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
1025 @item sender
Dave Love <fx@gnu.org>
parents:
diff changeset
1026 @cindex Sender
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1027 Insert a new @code{Sender} header if the @code{From} header looks odd.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1028 @item multiple-headers
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1029 Check for the existence of multiple equal headers.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1030 @item sendsys
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1031 @cindex sendsys
Dave Love <fx@gnu.org>
parents:
diff changeset
1032 Check for the existence of version and sendsys commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
1033 @item message-id
Dave Love <fx@gnu.org>
parents:
diff changeset
1034 Check whether the @code{Message-ID} looks ok.
Dave Love <fx@gnu.org>
parents:
diff changeset
1035 @item from
Dave Love <fx@gnu.org>
parents:
diff changeset
1036 Check whether the @code{From} header seems nice.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1037 @item long-lines
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1038 @cindex long lines
Dave Love <fx@gnu.org>
parents:
diff changeset
1039 Check for too long lines.
Dave Love <fx@gnu.org>
parents:
diff changeset
1040 @item control-chars
Dave Love <fx@gnu.org>
parents:
diff changeset
1041 Check for invalid characters.
Dave Love <fx@gnu.org>
parents:
diff changeset
1042 @item size
Dave Love <fx@gnu.org>
parents:
diff changeset
1043 Check for excessive size.
Dave Love <fx@gnu.org>
parents:
diff changeset
1044 @item new-text
Dave Love <fx@gnu.org>
parents:
diff changeset
1045 Check whether there is any new text in the messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1046 @item signature
Dave Love <fx@gnu.org>
parents:
diff changeset
1047 Check the length of the signature.
Dave Love <fx@gnu.org>
parents:
diff changeset
1048 @item approved
Dave Love <fx@gnu.org>
parents:
diff changeset
1049 @cindex approved
Dave Love <fx@gnu.org>
parents:
diff changeset
1050 Check whether the article has an @code{Approved} header, which is
Dave Love <fx@gnu.org>
parents:
diff changeset
1051 something only moderators should include.
Dave Love <fx@gnu.org>
parents:
diff changeset
1052 @item empty
Dave Love <fx@gnu.org>
parents:
diff changeset
1053 Check whether the article is empty.
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1054 @item invisible-text
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1055 Check whether there is any invisible text in the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1056 @item empty-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1057 Check whether any of the headers are empty.
Dave Love <fx@gnu.org>
parents:
diff changeset
1058 @item existing-newsgroups
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1059 Check whether the newsgroups mentioned in the @code{Newsgroups} and
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1060 @code{Followup-To} headers exist.
Dave Love <fx@gnu.org>
parents:
diff changeset
1061 @item valid-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1062 Check whether the @code{Newsgroups} and @code{Followup-to} headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1063 are valid syntactically.
Dave Love <fx@gnu.org>
parents:
diff changeset
1064 @item repeated-newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1065 Check whether the @code{Newsgroups} and @code{Followup-to} headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1066 contains repeated group names.
Dave Love <fx@gnu.org>
parents:
diff changeset
1067 @item shorten-followup-to
Dave Love <fx@gnu.org>
parents:
diff changeset
1068 Check whether to add a @code{Followup-to} header to shorten the number
Dave Love <fx@gnu.org>
parents:
diff changeset
1069 of groups to post to.
Dave Love <fx@gnu.org>
parents:
diff changeset
1070 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1071
Dave Love <fx@gnu.org>
parents:
diff changeset
1072 All these conditions are checked by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1073
Dave Love <fx@gnu.org>
parents:
diff changeset
1074 @item message-ignored-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1075 @vindex message-ignored-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1076 Regexp of headers to be removed before posting. The default is@*
Dave Love <fx@gnu.org>
parents:
diff changeset
1077 @samp{^NNTP-Posting-Host:\\|^Xref:\\|^[BGF]cc:\\|^Resent-Fcc:}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1078
Dave Love <fx@gnu.org>
parents:
diff changeset
1079 @item message-default-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1080 @vindex message-default-news-headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1081 This string is inserted at the end of the headers in all message
Dave Love <fx@gnu.org>
parents:
diff changeset
1082 buffers that are initialized as news.
Dave Love <fx@gnu.org>
parents:
diff changeset
1083
Dave Love <fx@gnu.org>
parents:
diff changeset
1084 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1085
Dave Love <fx@gnu.org>
parents:
diff changeset
1086
Dave Love <fx@gnu.org>
parents:
diff changeset
1087 @node News Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1088 @section News Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1089
Dave Love <fx@gnu.org>
parents:
diff changeset
1090 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1091 @item message-send-news-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1092 @vindex message-send-news-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1093 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
1094 @code{message-send-news}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1095
Dave Love <fx@gnu.org>
parents:
diff changeset
1096 @item message-post-method
Dave Love <fx@gnu.org>
parents:
diff changeset
1097 @vindex message-post-method
Dave Love <fx@gnu.org>
parents:
diff changeset
1098 Gnusish @dfn{select method} (see the Gnus manual for details) used for
Dave Love <fx@gnu.org>
parents:
diff changeset
1099 posting a prepared news message.
Dave Love <fx@gnu.org>
parents:
diff changeset
1100
Dave Love <fx@gnu.org>
parents:
diff changeset
1101 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1102
Dave Love <fx@gnu.org>
parents:
diff changeset
1103
Dave Love <fx@gnu.org>
parents:
diff changeset
1104 @node Various Message Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1105 @section Various Message Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1106
Dave Love <fx@gnu.org>
parents:
diff changeset
1107 @table @code
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1108 @item message-default-charset
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1109 @vindex message-default-charset
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1110 @cindex charset
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1111 Symbol naming a @sc{mime} charset. Non-ASCII characters in messages are
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1112 assumed to be encoded using this charset. The default is @code{nil},
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1113 which means ask the user. (This variable is used only on non-@sc{mule}
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1114 Emacsen.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1115 @xref{Charset Translation, , Charset Translation, emacs-mime,
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1116 Emacs MIME Manual}, for details on the @sc{mule}-to-@sc{mime}
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1117 translation process.
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1118
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1119 @item message-signature-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1120 @vindex message-signature-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1121 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
1122 default.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1123
Dave Love <fx@gnu.org>
parents:
diff changeset
1124 @item mail-header-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1125 @vindex mail-header-separator
Dave Love <fx@gnu.org>
parents:
diff changeset
1126 String used to separate the headers from the body. It is @samp{--text
Dave Love <fx@gnu.org>
parents:
diff changeset
1127 follows this line--} by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1128
Dave Love <fx@gnu.org>
parents:
diff changeset
1129 @item message-directory
Dave Love <fx@gnu.org>
parents:
diff changeset
1130 @vindex message-directory
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1131 Directory used by many mailey things. The default is @file{~/Mail/}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1132
Dave Love <fx@gnu.org>
parents:
diff changeset
1133 @item message-signature-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1134 @vindex message-signature-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1135 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
1136 headers have been inserted but before the signature has been inserted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1137
Dave Love <fx@gnu.org>
parents:
diff changeset
1138 @item message-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1139 @vindex message-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1140 Hook run as the last thing when the message buffer has been initialized,
Dave Love <fx@gnu.org>
parents:
diff changeset
1141 but before yanked text is inserted.
Dave Love <fx@gnu.org>
parents:
diff changeset
1142
Dave Love <fx@gnu.org>
parents:
diff changeset
1143 @item message-header-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1144 @vindex message-header-setup-hook
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1145 Hook called narrowed to the headers after initializing the headers.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1146
Dave Love <fx@gnu.org>
parents:
diff changeset
1147 For instance, if you're running Gnus and wish to insert a
Dave Love <fx@gnu.org>
parents:
diff changeset
1148 @samp{Mail-Copies-To} header in all your news articles and all messages
Dave Love <fx@gnu.org>
parents:
diff changeset
1149 you send to mailing lists, you could do something like the following:
Dave Love <fx@gnu.org>
parents:
diff changeset
1150
Dave Love <fx@gnu.org>
parents:
diff changeset
1151 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1152 (defun my-message-header-setup-hook ()
Dave Love <fx@gnu.org>
parents:
diff changeset
1153 (let ((group (or gnus-newsgroup-name "")))
Dave Love <fx@gnu.org>
parents:
diff changeset
1154 (when (or (message-fetch-field "newsgroups")
Dave Love <fx@gnu.org>
parents:
diff changeset
1155 (gnus-group-find-parameter group 'to-address)
Dave Love <fx@gnu.org>
parents:
diff changeset
1156 (gnus-group-find-parameter group 'to-list))
Dave Love <fx@gnu.org>
parents:
diff changeset
1157 (insert "Mail-Copies-To: never\n"))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1158
Dave Love <fx@gnu.org>
parents:
diff changeset
1159 (add-hook 'message-header-setup-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1160 'my-message-header-setup-hook)
Dave Love <fx@gnu.org>
parents:
diff changeset
1161 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1162
Dave Love <fx@gnu.org>
parents:
diff changeset
1163 @item message-send-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1164 @vindex message-send-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1165 Hook run before sending messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1166
Dave Love <fx@gnu.org>
parents:
diff changeset
1167 If you want to add certain headers before sending, you can use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1168 @code{message-add-header} function in this hook. For instance:
Dave Love <fx@gnu.org>
parents:
diff changeset
1169 @findex message-add-header
Dave Love <fx@gnu.org>
parents:
diff changeset
1170
Dave Love <fx@gnu.org>
parents:
diff changeset
1171 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1172 (add-hook 'message-send-hook 'my-message-add-content)
Dave Love <fx@gnu.org>
parents:
diff changeset
1173 (defun my-message-add-content ()
35614
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1174 (message-add-header "X-In-No-Sense: Nonsense")
64758b6d401f *** empty log message ***
Dave Love <fx@gnu.org>
parents: 33985
diff changeset
1175 (message-add-header "X-Whatever: no"))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1176 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1177
Dave Love <fx@gnu.org>
parents:
diff changeset
1178 This function won't add the header if the header is already present.
Dave Love <fx@gnu.org>
parents:
diff changeset
1179
Dave Love <fx@gnu.org>
parents:
diff changeset
1180 @item message-send-mail-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1181 @vindex message-send-mail-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1182 Hook run before sending mail messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1183
Dave Love <fx@gnu.org>
parents:
diff changeset
1184 @item message-send-news-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1185 @vindex message-send-news-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1186 Hook run before sending news messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1187
Dave Love <fx@gnu.org>
parents:
diff changeset
1188 @item message-sent-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1189 @vindex message-sent-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
1190 Hook run after sending messages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1191
Dave Love <fx@gnu.org>
parents:
diff changeset
1192 @item message-mode-syntax-table
Dave Love <fx@gnu.org>
parents:
diff changeset
1193 @vindex message-mode-syntax-table
Dave Love <fx@gnu.org>
parents:
diff changeset
1194 Syntax table used in message mode buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
1195
Dave Love <fx@gnu.org>
parents:
diff changeset
1196 @item message-send-method-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1197 @vindex message-send-method-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1198
Dave Love <fx@gnu.org>
parents:
diff changeset
1199 Alist of ways to send outgoing messages. Each element has the form
Dave Love <fx@gnu.org>
parents:
diff changeset
1200
Dave Love <fx@gnu.org>
parents:
diff changeset
1201 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1202 (TYPE PREDICATE FUNCTION)
Dave Love <fx@gnu.org>
parents:
diff changeset
1203 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1204
Dave Love <fx@gnu.org>
parents:
diff changeset
1205 @table @var
Dave Love <fx@gnu.org>
parents:
diff changeset
1206 @item type
Dave Love <fx@gnu.org>
parents:
diff changeset
1207 A symbol that names the method.
Dave Love <fx@gnu.org>
parents:
diff changeset
1208
Dave Love <fx@gnu.org>
parents:
diff changeset
1209 @item predicate
Dave Love <fx@gnu.org>
parents:
diff changeset
1210 A function called without any parameters to determine whether the
Dave Love <fx@gnu.org>
parents:
diff changeset
1211 message is a message of type @var{type}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1212
Dave Love <fx@gnu.org>
parents:
diff changeset
1213 @item function
Dave Love <fx@gnu.org>
parents:
diff changeset
1214 A function to be called if @var{predicate} returns non-@code{nil}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1215 @var{function} is called with one parameter -- the prefix.
Dave Love <fx@gnu.org>
parents:
diff changeset
1216 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1217
Dave Love <fx@gnu.org>
parents:
diff changeset
1218 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1219 ((news message-news-p message-send-via-news)
Dave Love <fx@gnu.org>
parents:
diff changeset
1220 (mail message-mail-p message-send-via-mail))
Dave Love <fx@gnu.org>
parents:
diff changeset
1221 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1222
Dave Love <fx@gnu.org>
parents:
diff changeset
1223
Dave Love <fx@gnu.org>
parents:
diff changeset
1224
Dave Love <fx@gnu.org>
parents:
diff changeset
1225 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1226
Dave Love <fx@gnu.org>
parents:
diff changeset
1227
Dave Love <fx@gnu.org>
parents:
diff changeset
1228
Dave Love <fx@gnu.org>
parents:
diff changeset
1229 @node Sending Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1230 @section Sending Variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1231
Dave Love <fx@gnu.org>
parents:
diff changeset
1232 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1233
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1234 @item message-fcc-handler-function
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1235 @vindex message-fcc-handler-function
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1236 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
1237 called with the name of the file to store the article in. The default
38865
62e02f5ae533 Avoid saying "Unix" in a way that includes GNU.
Richard M. Stallman <rms@gnu.org>
parents: 36073
diff changeset
1238 function is @code{message-output} which saves in inbox format.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1239
Dave Love <fx@gnu.org>
parents:
diff changeset
1240 @item message-courtesy-message
Dave Love <fx@gnu.org>
parents:
diff changeset
1241 @vindex message-courtesy-message
Dave Love <fx@gnu.org>
parents:
diff changeset
1242 When sending combined messages, this string is inserted at the start of
Dave Love <fx@gnu.org>
parents:
diff changeset
1243 the mailed copy. If the string contains the format spec @samp{%s}, the
Dave Love <fx@gnu.org>
parents:
diff changeset
1244 newsgroups the article has been posted to will be inserted there. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1245 this variable is @code{nil}, no such courtesy message will be added.
Dave Love <fx@gnu.org>
parents:
diff changeset
1246 The default value is @samp{"The following message is a courtesy copy of
31852
7de3cd8ff1ae New version for Gnus 5.9.
Dave Love <fx@gnu.org>
parents: 25829
diff changeset
1247 an article\nthat has been posted to %s as well.\n\n"}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1248
Dave Love <fx@gnu.org>
parents:
diff changeset
1249 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1250
Dave Love <fx@gnu.org>
parents:
diff changeset
1251
Dave Love <fx@gnu.org>
parents:
diff changeset
1252 @node Message Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1253 @section Message Buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1254
Dave Love <fx@gnu.org>
parents:
diff changeset
1255 Message will generate new buffers with unique buffer names when you
Dave Love <fx@gnu.org>
parents:
diff changeset
1256 request a message buffer. When you send the message, the buffer isn't
Dave Love <fx@gnu.org>
parents:
diff changeset
1257 normally killed off. Its name is changed and a certain number of old
Dave Love <fx@gnu.org>
parents:
diff changeset
1258 message buffers are kept alive.
Dave Love <fx@gnu.org>
parents:
diff changeset
1259
Dave Love <fx@gnu.org>
parents:
diff changeset
1260 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1261 @item message-generate-new-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1262 @vindex message-generate-new-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1263 If non-@code{nil}, generate new buffers. The default is @code{t}. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1264 this is a function, call that function with three parameters: The type,
Dave Love <fx@gnu.org>
parents:
diff changeset
1265 the to address and the group name. (Any of these may be @code{nil}.)
Dave Love <fx@gnu.org>
parents:
diff changeset
1266 The function should return the new buffer name.
Dave Love <fx@gnu.org>
parents:
diff changeset
1267
Dave Love <fx@gnu.org>
parents:
diff changeset
1268 @item message-max-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1269 @vindex message-max-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1270 This variable says how many old message buffers to keep. If there are
Dave Love <fx@gnu.org>
parents:
diff changeset
1271 more message buffers than this, the oldest buffer will be killed. The
Dave Love <fx@gnu.org>
parents:
diff changeset
1272 default is 10. If this variable is @code{nil}, no old message buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
1273 will ever be killed.
Dave Love <fx@gnu.org>
parents:
diff changeset
1274
Dave Love <fx@gnu.org>
parents:
diff changeset
1275 @item message-send-rename-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1276 @vindex message-send-rename-function
Dave Love <fx@gnu.org>
parents:
diff changeset
1277 After sending a message, the buffer is renamed from, for instance,
Dave Love <fx@gnu.org>
parents:
diff changeset
1278 @samp{*reply to Lars*} to @samp{*sent reply to Lars*}. If you don't
Dave Love <fx@gnu.org>
parents:
diff changeset
1279 like this, set this variable to a function that renames the buffer in a
Dave Love <fx@gnu.org>
parents:
diff changeset
1280 manner you like. If you don't want to rename the buffer at all, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
1281 say:
Dave Love <fx@gnu.org>
parents:
diff changeset
1282
Dave Love <fx@gnu.org>
parents:
diff changeset
1283 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1284 (setq message-send-rename-function 'ignore)
Dave Love <fx@gnu.org>
parents:
diff changeset
1285 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1286
Dave Love <fx@gnu.org>
parents:
diff changeset
1287 @item message-kill-buffer-on-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
1288 @findex message-kill-buffer-on-exit
Dave Love <fx@gnu.org>
parents:
diff changeset
1289 If non-@code{nil}, kill the buffer immediately on exit.
Dave Love <fx@gnu.org>
parents:
diff changeset
1290
Dave Love <fx@gnu.org>
parents:
diff changeset
1291 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1292
Dave Love <fx@gnu.org>
parents:
diff changeset
1293
Dave Love <fx@gnu.org>
parents:
diff changeset
1294 @node Message Actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1295 @section Message Actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1296
Dave Love <fx@gnu.org>
parents:
diff changeset
1297 When Message is being used from a news/mail reader, the reader is likely
Dave Love <fx@gnu.org>
parents:
diff changeset
1298 to want to perform some task after the message has been sent. Perhaps
Dave Love <fx@gnu.org>
parents:
diff changeset
1299 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
1300 replied.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1301
Dave Love <fx@gnu.org>
parents:
diff changeset
1302 @vindex message-kill-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1303 @vindex message-postpone-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1304 @vindex message-exit-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1305 @vindex message-send-actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1306 The user may exit from the message buffer in various ways. The most
Dave Love <fx@gnu.org>
parents:
diff changeset
1307 common is @kbd{C-c C-c}, which sends the message and exits. Other
Dave Love <fx@gnu.org>
parents:
diff changeset
1308 possibilities are @kbd{C-c C-s} which just sends the message, @kbd{C-c
Dave Love <fx@gnu.org>
parents:
diff changeset
1309 C-d} which postpones the message editing and buries the message buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
1310 and @kbd{C-c C-k} which kills the message buffer. Each of these actions
Dave Love <fx@gnu.org>
parents:
diff changeset
1311 have lists associated with them that contains actions to be executed:
Dave Love <fx@gnu.org>
parents:
diff changeset
1312 @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
1313 @code{message-postpone-actions}, and @code{message-kill-actions}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1314
Dave Love <fx@gnu.org>
parents:
diff changeset
1315 Message provides a function to interface with these lists:
Dave Love <fx@gnu.org>
parents:
diff changeset
1316 @code{message-add-action}. The first parameter is the action to be
Dave Love <fx@gnu.org>
parents:
diff changeset
1317 added, and the rest of the arguments are which lists to add this action
Dave Love <fx@gnu.org>
parents:
diff changeset
1318 to. Here's an example from Gnus:
Dave Love <fx@gnu.org>
parents:
diff changeset
1319
Dave Love <fx@gnu.org>
parents:
diff changeset
1320 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1321 (message-add-action
Dave Love <fx@gnu.org>
parents:
diff changeset
1322 `(set-window-configuration ,(current-window-configuration))
Dave Love <fx@gnu.org>
parents:
diff changeset
1323 'exit 'postpone 'kill)
Dave Love <fx@gnu.org>
parents:
diff changeset
1324 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1325
Dave Love <fx@gnu.org>
parents:
diff changeset
1326 This restores the Gnus window configuration when the message buffer is
Dave Love <fx@gnu.org>
parents:
diff changeset
1327 killed, postponed or exited.
Dave Love <fx@gnu.org>
parents:
diff changeset
1328
Dave Love <fx@gnu.org>
parents:
diff changeset
1329 An @dfn{action} can be either: a normal function, or a list where the
Dave Love <fx@gnu.org>
parents:
diff changeset
1330 @code{car} is a function and the @code{cdr} is the list of arguments, or
Dave Love <fx@gnu.org>
parents:
diff changeset
1331 a form to be @code{eval}ed.
Dave Love <fx@gnu.org>
parents:
diff changeset
1332
Dave Love <fx@gnu.org>
parents:
diff changeset
1333
Dave Love <fx@gnu.org>
parents:
diff changeset
1334 @node Compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
1335 @chapter Compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
1336 @cindex compatibility
Dave Love <fx@gnu.org>
parents:
diff changeset
1337
Dave Love <fx@gnu.org>
parents:
diff changeset
1338 Message uses virtually only its own variables---older @code{mail-}
Dave Love <fx@gnu.org>
parents:
diff changeset
1339 variables aren't consulted. To force Message to take those variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1340 into account, you can put the following in your @code{.emacs} file:
Dave Love <fx@gnu.org>
parents:
diff changeset
1341
Dave Love <fx@gnu.org>
parents:
diff changeset
1342 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1343 (require 'messcompat)
Dave Love <fx@gnu.org>
parents:
diff changeset
1344 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1345
Dave Love <fx@gnu.org>
parents:
diff changeset
1346 This will initialize many Message variables from the values in the
Dave Love <fx@gnu.org>
parents:
diff changeset
1347 corresponding mail variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
1348
Dave Love <fx@gnu.org>
parents:
diff changeset
1349
Dave Love <fx@gnu.org>
parents:
diff changeset
1350 @node Appendices
Dave Love <fx@gnu.org>
parents:
diff changeset
1351 @chapter Appendices
Dave Love <fx@gnu.org>
parents:
diff changeset
1352
Dave Love <fx@gnu.org>
parents:
diff changeset
1353 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1354 * Responses:: Standard rules for determining where responses go.
Dave Love <fx@gnu.org>
parents:
diff changeset
1355 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1356
Dave Love <fx@gnu.org>
parents:
diff changeset
1357
Dave Love <fx@gnu.org>
parents:
diff changeset
1358 @node Responses
Dave Love <fx@gnu.org>
parents:
diff changeset
1359 @section Responses
Dave Love <fx@gnu.org>
parents:
diff changeset
1360
Dave Love <fx@gnu.org>
parents:
diff changeset
1361 To determine where a message is to go, the following algorithm is used
Dave Love <fx@gnu.org>
parents:
diff changeset
1362 by default.
Dave Love <fx@gnu.org>
parents:
diff changeset
1363
Dave Love <fx@gnu.org>
parents:
diff changeset
1364 @table @dfn
Dave Love <fx@gnu.org>
parents:
diff changeset
1365 @item reply
Dave Love <fx@gnu.org>
parents:
diff changeset
1366 A @dfn{reply} is when you want to respond @emph{just} to the person who
Dave Love <fx@gnu.org>
parents:
diff changeset
1367 sent the message via mail. There will only be one recipient. To
Dave Love <fx@gnu.org>
parents:
diff changeset
1368 determine who the recipient will be, the following headers are
Dave Love <fx@gnu.org>
parents:
diff changeset
1369 consulted, in turn:
Dave Love <fx@gnu.org>
parents:
diff changeset
1370
Dave Love <fx@gnu.org>
parents:
diff changeset
1371 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1372 @item Reply-To
Dave Love <fx@gnu.org>
parents:
diff changeset
1373
Dave Love <fx@gnu.org>
parents:
diff changeset
1374 @item From
Dave Love <fx@gnu.org>
parents:
diff changeset
1375 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1376
Dave Love <fx@gnu.org>
parents:
diff changeset
1377
Dave Love <fx@gnu.org>
parents:
diff changeset
1378 @item wide reply
Dave Love <fx@gnu.org>
parents:
diff changeset
1379 A @dfn{wide reply} is a mail response that includes @emph{all} entities
Dave Love <fx@gnu.org>
parents:
diff changeset
1380 mentioned in the message you are responded to. All mailboxes from the
Dave Love <fx@gnu.org>
parents:
diff changeset
1381 following headers will be concatenated to form the outgoing
Dave Love <fx@gnu.org>
parents:
diff changeset
1382 @code{To}/@code{Cc} headers:
Dave Love <fx@gnu.org>
parents:
diff changeset
1383
Dave Love <fx@gnu.org>
parents:
diff changeset
1384 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1385 @item From
Dave Love <fx@gnu.org>
parents:
diff changeset
1386 (unless there's a @code{Reply-To}, in which case that is used instead).
Dave Love <fx@gnu.org>
parents:
diff changeset
1387
Dave Love <fx@gnu.org>
parents:
diff changeset
1388 @item Cc
Dave Love <fx@gnu.org>
parents:
diff changeset
1389
Dave Love <fx@gnu.org>
parents:
diff changeset
1390 @item To
Dave Love <fx@gnu.org>
parents:
diff changeset
1391 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1392
Dave Love <fx@gnu.org>
parents:
diff changeset
1393 If a @code{Mail-Copies-To} header is present, it will also be included
Dave Love <fx@gnu.org>
parents:
diff changeset
1394 in the list of mailboxes. If this header is @samp{never}, that means
Dave Love <fx@gnu.org>
parents:
diff changeset
1395 that the @code{From} (or @code{Reply-To}) mailbox will be suppressed.
Dave Love <fx@gnu.org>
parents:
diff changeset
1396
Dave Love <fx@gnu.org>
parents:
diff changeset
1397
Dave Love <fx@gnu.org>
parents:
diff changeset
1398 @item followup
Dave Love <fx@gnu.org>
parents:
diff changeset
1399 A @dfn{followup} is a response sent via news. The following headers
Dave Love <fx@gnu.org>
parents:
diff changeset
1400 (listed in order of precedence) determine where the response is to be
Dave Love <fx@gnu.org>
parents:
diff changeset
1401 sent:
Dave Love <fx@gnu.org>
parents:
diff changeset
1402
Dave Love <fx@gnu.org>
parents:
diff changeset
1403 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
1404
Dave Love <fx@gnu.org>
parents:
diff changeset
1405 @item Followup-To
Dave Love <fx@gnu.org>
parents:
diff changeset
1406
Dave Love <fx@gnu.org>
parents:
diff changeset
1407 @item Newsgroups
Dave Love <fx@gnu.org>
parents:
diff changeset
1408
Dave Love <fx@gnu.org>
parents:
diff changeset
1409 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1410
Dave Love <fx@gnu.org>
parents:
diff changeset
1411 If a @code{Mail-Copies-To} header is present, it will be used as the
Dave Love <fx@gnu.org>
parents:
diff changeset
1412 basis of the new @code{Cc} header, except if this header is
Dave Love <fx@gnu.org>
parents:
diff changeset
1413 @samp{never}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1414
Dave Love <fx@gnu.org>
parents:
diff changeset
1415 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1416
Dave Love <fx@gnu.org>
parents:
diff changeset
1417
Dave Love <fx@gnu.org>
parents:
diff changeset
1418
Dave Love <fx@gnu.org>
parents:
diff changeset
1419 @node Index
Dave Love <fx@gnu.org>
parents:
diff changeset
1420 @chapter Index
Dave Love <fx@gnu.org>
parents:
diff changeset
1421 @printindex cp
Dave Love <fx@gnu.org>
parents:
diff changeset
1422
Dave Love <fx@gnu.org>
parents:
diff changeset
1423 @node Key Index
Dave Love <fx@gnu.org>
parents:
diff changeset
1424 @chapter Key Index
Dave Love <fx@gnu.org>
parents:
diff changeset
1425 @printindex ky
Dave Love <fx@gnu.org>
parents:
diff changeset
1426
Dave Love <fx@gnu.org>
parents:
diff changeset
1427 @summarycontents
Dave Love <fx@gnu.org>
parents:
diff changeset
1428 @contents
Dave Love <fx@gnu.org>
parents:
diff changeset
1429 @bye
Dave Love <fx@gnu.org>
parents:
diff changeset
1430
Dave Love <fx@gnu.org>
parents:
diff changeset
1431 @c End: