annotate doc/misc/message.texi @ 107818:c7670de45d8a

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