annotate doc/misc/message.texi @ 109969:d539b74d6530

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