comparison man/message.texi @ 16:0293115a14e9 r19-15b91

Import from CVS: tag r19-15b91
author cvs
date Mon, 13 Aug 2007 08:49:20 +0200
parents 376386a54a3c
children 4103f0995bd7
comparison
equal deleted inserted replaced
15:ad457d5f7d04 16:0293115a14e9
1 \input texinfo @c -*-texinfo-*- 1 \input texinfo @c -*-texinfo-*-
2 2
3 @setfilename ../info/message.info 3 @setfilename message
4 @settitle Message Manual 4 @settitle Message Manual
5 @synindex fn cp 5 @synindex fn cp
6 @synindex vr cp 6 @synindex vr cp
7 @synindex pg cp 7 @synindex pg cp
8 @iftex 8 @iftex
167 @node Wide Reply 167 @node Wide Reply
168 @section Wide Reply 168 @section Wide Reply
169 169
170 @findex message-wide-reply 170 @findex message-wide-reply
171 The @code{message-wide-reply} pops up a message buffer that's a wide 171 The @code{message-wide-reply} pops up a message buffer that's a wide
172 reply to the message in the current buffer. 172 reply to the message in the current buffer. A @dfn{wide reply} is a
173 reply that goes out to all people listed in the @code{To}, @code{From}
174 and @code{Cc} headers.
173 175
174 @vindex message-wide-reply-to-function 176 @vindex message-wide-reply-to-function
175 Message uses the normal methods to determine where wide replies are to go, 177 Message uses the normal methods to determine where wide replies are to go,
176 but you can change the behavior to suit your needs by fiddling with the 178 but you can change the behavior to suit your needs by fiddling with the
177 @code{message-wide-reply-to-function}. It is used in the same way as 179 @code{message-wide-reply-to-function}. It is used in the same way as
178 @code{message-reply-to-function} (@pxref{Reply}). 180 @code{message-reply-to-function} (@pxref{Reply}).
179 181
180 @findex rmail-dont-reply-to-names 182 @findex rmail-dont-reply-to-names
181 Addresses that matches the @code{rmail-dont-reply-to-names} regular 183 Addresses that match the @code{rmail-dont-reply-to-names} regular
182 expression will be removed from the @code{Cc} header. 184 expression will be removed from the @code{Cc} header.
183 185
184 186
185 @node Followup 187 @node Followup
186 @section Followup 188 @section Followup
218 The @code{message-supersede} command pops up a message buffer that will 220 The @code{message-supersede} command pops up a message buffer that will
219 supersede the message in the current buffer. 221 supersede the message in the current buffer.
220 222
221 @vindex message-ignored-supersedes-headers 223 @vindex message-ignored-supersedes-headers
222 Headers matching the @code{message-ignored-supersedes-headers} are 224 Headers matching the @code{message-ignored-supersedes-headers} are
223 removed before popping up the new message buffer. The default is 225 removed before popping up the new message buffer. The default is@*
224 @samp{^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|^Received:\\|^X-From-Line:\\|Return-Path:}. 226 @samp{^Path:\\|^Date\\|^NNTP-Posting-Host:\\|^Xref:\\|^Lines:\\|@*
227 ^Received:\\|^X-From-Line:\\|Return-Path:}.
225 228
226 229
227 230
228 @node Forwarding 231 @node Forwarding
229 @section Forwarding 232 @section Forwarding
234 news. 237 news.
235 238
236 @table @code 239 @table @code
237 @item message-forward-start-separator 240 @item message-forward-start-separator
238 @vindex message-forward-start-separator 241 @vindex message-forward-start-separator
239 Delimiter inserted before forwarded messages. The default is 242 Delimiter inserted before forwarded messages. The default is@*
240 @samp{------- Start of forwarded message -------\n}. 243 @samp{------- Start of forwarded message -------\n}.
241 244
242 @vindex message-forward-end-separator 245 @vindex message-forward-end-separator
243 @item message-forward-end-separator 246 @item message-forward-end-separator
244 @vindex message-forward-end-separator 247 @vindex message-forward-end-separator
245 Delimiter inserted after forwarded messages. The default is 248 Delimiter inserted after forwarded messages. The default is@*
246 @samp{------- End of forwarded message -------\n}. 249 @samp{------- End of forwarded message -------\n}.
247 250
248 @item message-signature-before-forwarded-message 251 @item message-signature-before-forwarded-message
249 @vindex message-signature-before-forwarded-message 252 @vindex message-signature-before-forwarded-message
250 If this variable is @code{t}, which it is by default, your personal 253 If this variable is @code{t}, which it is by default, your personal
264 @findex message-resend 267 @findex message-resend
265 The @code{message-resend} command will prompt the user for an address 268 The @code{message-resend} command will prompt the user for an address
266 and resend the message in the current buffer to that address. 269 and resend the message in the current buffer to that address.
267 270
268 @vindex message-ignored-resent-headers 271 @vindex message-ignored-resent-headers
269 Headers the match the @code{message-ignored-resent-headers} regexp will 272 Headers that match the @code{message-ignored-resent-headers} regexp will
270 be removed before sending the message. The default is 273 be removed before sending the message. The default is
271 @samp{^Return-receipt}. 274 @samp{^Return-receipt}.
272 275
273 276
274 @node Bouncing 277 @node Bouncing
275 @section Bouncing 278 @section Bouncing
276 279
277 @findex message-bounce 280 @findex message-bounce
278 The @code{message-bounce} command will, if the current buffer contains a 281 The @code{message-bounce} command will, if the current buffer contains a
279 bounced mail message, pop up a message buffer stripped of the bounce 282 bounced mail message, pop up a message buffer stripped of the bounce
280 information. 283 information. A @dfn{bounced message} is typically a mail you've sent
284 out that has been returned by some @code{mailer-daemon} as
285 undeliverable.
281 286
282 @vindex message-ignored-bounced-headers 287 @vindex message-ignored-bounced-headers
283 Headers that match the @code{message-ignored-bounced-headers} regexp 288 Headers that match the @code{message-ignored-bounced-headers} regexp
284 will be removed before popping up the buffer. The default is 289 will be removed before popping up the buffer. The default is
285 @samp{^Received:}. 290 @samp{^Received:}.
469 474
470 Note that RFC1036 says that a signature should be preceded by the three 475 Note that RFC1036 says that a signature should be preceded by the three
471 characters @samp{-- } on a line by themselves. This is to make it 476 characters @samp{-- } on a line by themselves. This is to make it
472 easier for the recipient to automatically recognize and process the 477 easier for the recipient to automatically recognize and process the
473 signature. So don't remove those characters, even though you might feel 478 signature. So don't remove those characters, even though you might feel
474 that they ruin you beautiful design, like, totally. 479 that they ruin your beautiful design, like, totally.
475 480
476 Also note that no signature should be more than four lines long. 481 Also note that no signature should be more than four lines long.
477 Including ASCII graphics is an efficient way to get everybody to believe 482 Including ASCII graphics is an efficient way to get everybody to believe
478 that you are silly and have nothing important to say. 483 that you are silly and have nothing important to say.
479 484
489 @findex message-caesar-buffer-body 494 @findex message-caesar-buffer-body
490 Caesar rotate (aka. rot13) the current message 495 Caesar rotate (aka. rot13) the current message
491 (@code{message-caesar-buffer-body}). If narrowing is in effect, just 496 (@code{message-caesar-buffer-body}). If narrowing is in effect, just
492 rotate the visible portion of the buffer. A numerical prefix says how 497 rotate the visible portion of the buffer. A numerical prefix says how
493 many places to rotate the text. The default is 13. 498 many places to rotate the text. The default is 13.
499
500 @item C-c C-e
501 @kindex C-c C-e
502 @findex message-elide-region
503 Elide the text between point and mark (@code{message-elide-region}).
504 The text is killed and an ellipsis (@samp{[...]}) will be inserted in
505 its place.
494 506
495 @item C-c C-t 507 @item C-c C-t
496 @kindex C-c C-t 508 @kindex C-c C-t
497 @findex message-insert-to 509 @findex message-insert-to
498 Insert a @code{To} header that contains the @code{Reply-To} or 510 Insert a @code{To} header that contains the @code{Reply-To} or
620 @section Mail Headers 632 @section Mail Headers
621 633
622 @table @code 634 @table @code
623 @item message-required-mail-headers 635 @item message-required-mail-headers
624 @vindex message-required-mail-headers 636 @vindex message-required-mail-headers
625 See @pxref{News Headers} for the syntax of this variable. It is 637 @xref{News Headers}, for the syntax of this variable. It is
626 @code{(From Date Subject (optional . In-Reply-To) Message-ID Lines 638 @code{(From Date Subject (optional . In-Reply-To) Message-ID Lines
627 (optional . X-Mailer))} by default. 639 (optional . X-Mailer))} by default.
628 640
629 @item message-ignored-mail-headers 641 @item message-ignored-mail-headers
630 @vindex message-ignored-mail-headers 642 @vindex message-ignored-mail-headers
695 @cindex Message-ID 707 @cindex Message-ID
696 @vindex mail-host-address 708 @vindex mail-host-address
697 @findex system-name 709 @findex system-name
698 @cindex Sun 710 @cindex Sun
699 This required header will be generated by Message. A unique ID will be 711 This required header will be generated by Message. A unique ID will be
700 created based on date, time, user name and system name. Message will 712 created based on the date, time, user name and system name. Message will
701 use @code{mail-host-address} as the fully qualified domain name (FQDN) 713 use @code{mail-host-address} as the fully qualified domain name (FQDN)
702 of the machine if that variable is define. If not, it will use 714 of the machine if that variable is defined. If not, it will use
703 @code{system-name}, which doesn't report a FQDN on some machines -- 715 @code{system-name}, which doesn't report a FQDN on some machines --
704 notably Suns. 716 notably Suns.
705 717
706 @item X-Newsreader 718 @item X-Newsreader
707 @cindex X-Newsreader 719 @cindex X-Newsreader
713 @code{message-mailer} local variable, unless there already is an 725 @code{message-mailer} local variable, unless there already is an
714 @code{X-Newsreader} header present. 726 @code{X-Newsreader} header present.
715 727
716 @item In-Reply-To 728 @item In-Reply-To
717 This optional header is filled out using the @code{Date} and @code{From} 729 This optional header is filled out using the @code{Date} and @code{From}
718 header of the article being replied. 730 header of the article being replied to.
719 731
720 @item Expires 732 @item Expires
721 @cindex Expires 733 @cindex Expires
722 This extremely optional header will be inserted according to the 734 This extremely optional header will be inserted according to the
723 @code{message-expires} variable. It is highly deprecated and shouldn't 735 @code{message-expires} variable. It is highly deprecated and shouldn't
729 @code{message-distribution-function} variable. It is a deprecated and 741 @code{message-distribution-function} variable. It is a deprecated and
730 much misunderstood header. 742 much misunderstood header.
731 743
732 @item Path 744 @item Path
733 @cindex path 745 @cindex path
734 This extremely optional header should probably not ever be used. 746 This extremely optional header should probably never be used.
735 However, some @emph{very} old servers require that this header is 747 However, some @emph{very} old servers require that this header is
736 present. @code{message-user-path} further controls how this 748 present. @code{message-user-path} further controls how this
737 @code{Path} header is to look. If is is @code{nil}, the the server name 749 @code{Path} header is to look. If it is @code{nil}, use the server name
738 as the leaf node. If is is a string, use the string. If it is neither 750 as the leaf node. If it is a string, use the string. If it is neither
739 a string nor @code{nil}, use the user name only. However, it is highly 751 a string nor @code{nil}, use the user name only. However, it is highly
740 unlikely that you should need to fiddle with this variable at all. 752 unlikely that you should need to fiddle with this variable at all.
741 @end table 753 @end table
742 754
743 @findex yow 755 @findex yow
760 772
761 @table @code 773 @table @code
762 774
763 @item message-syntax-checks 775 @item message-syntax-checks
764 @vindex message-syntax-checks 776 @vindex message-syntax-checks
765 If non-@code{nil}, message will attempt to check the legality of the 777 If non-@code{nil}, Message will attempt to check the legality of the
766 headers, as well as some other stuff, before posting. You can control 778 headers, as well as some other stuff, before posting. You can control
767 the granularity of the check by adding or removing elements from this 779 the granularity of the check by adding or removing elements from this
768 list. Legal elements are: 780 list. Legal elements are:
769 781
770 @table @code 782 @table @code
800 @item empty 812 @item empty
801 Check whether the article is empty. 813 Check whether the article is empty.
802 @item empty-headers 814 @item empty-headers
803 Check whether any of the headers are empty. 815 Check whether any of the headers are empty.
804 @item existing-newsgroups 816 @item existing-newsgroups
805 Check whether the newsgroups mentioned in the Newsgroups and 817 Check whether the newsgroups mentioned in the @code{Newsgroups} and
806 Followup-To headers exist. 818 @code{Followup-To} headers exist.
807 @item valid-newsgroups 819 @item valid-newsgroups
808 Check whether the @code{Newsgroups} and @code{Followup-To} headers 820 Check whether the @code{Newsgroups} and @code{Followup-to} headers
809 are valid syntactially. 821 are valid syntactically.
822 @item shorten-followup-to
823 Check whether to add a @code{Followup-to} header to shorten the number
824 of groups to post to.
810 @end table 825 @end table
811 826
812 All these conditions are checked by default. 827 All these conditions are checked by default.
813 828
814 @item message-ignored-news-headers 829 @item message-ignored-news-headers
815 @vindex message-ignored-news-headers 830 @vindex message-ignored-news-headers
816 Regexp of headers to be removed before posting. The default is 831 Regexp of headers to be removed before posting. The default is@*
817 @samp{^NNTP-Posting-Host:\\|^Xref:\\|^Bcc:\\|^Gcc:\\|^Fcc:}. 832 @samp{^NNTP-Posting-Host:\\|^Xref:\\|^Bcc:\\|^Gcc:\\|^Fcc:}.
818 833
819 @item message-default-news-headers 834 @item message-default-news-headers
820 @vindex message-default-news-headers 835 @vindex message-default-news-headers
821 This string is inserted at the end of the headers in all message 836 This string is inserted at the end of the headers in all message
822 buffers that are initialized as news. 837 buffers that are initialized as news.
876 Hook called narrowed to the headers after initializing the headers. 891 Hook called narrowed to the headers after initializing the headers.
877 892
878 @item message-send-hook 893 @item message-send-hook
879 @vindex message-send-hook 894 @vindex message-send-hook
880 Hook run before sending messages. 895 Hook run before sending messages.
896
897 @item message-send-mail-hook
898 @vindex message-send-mail-hook
899 Hook run before sending mail messages.
900
901 @item message-send-news-hook
902 @vindex message-send-news-hook
903 Hook run before sending news messages.
881 904
882 @item message-sent-hook 905 @item message-sent-hook
883 @vindex message-sent-hook 906 @vindex message-sent-hook
884 Hook run after sending messages. 907 Hook run after sending messages.
885 908
903 function is @code{rmail-output} which saves in Unix mailbox format. 926 function is @code{rmail-output} which saves in Unix mailbox format.
904 927
905 @item message-courtesy-message 928 @item message-courtesy-message
906 @vindex message-courtesy-message 929 @vindex message-courtesy-message
907 When sending combined messages, this string is inserted at the start of 930 When sending combined messages, this string is inserted at the start of
908 the mailed copy. If this variable is @code{nil}, no such courtesy 931 the mailed copy. If the string contains the format spec @samp{%s}, the
909 message will be added. 932 newsgroups the article has been posted to will be inserted there. If
933 this variable is @code{nil}, no such courtesy message will be added.
934 The default value is @samp{"The following message is a courtesy copy of
935 an article\nthat has been posted to %s as well.\n\n"}.
910 936
911 @end table 937 @end table
912 938
913 939
914 @node Message Buffers 940 @node Message Buffers
915 @section Message Buffers 941 @section Message Buffers
916 942
917 Message will generate new buffers with unique buffer names when you 943 Message will generate new buffers with unique buffer names when you
918 request a message buffer. When you send the message, the buffer isn't 944 request a message buffer. When you send the message, the buffer isn't
919 normally killed off. It's name is changed and a certain number of old 945 normally killed off. Its name is changed and a certain number of old
920 message buffers are kept alive. 946 message buffers are kept alive.
921 947
922 @table @code 948 @table @code
923 @item message-generate-new-buffers 949 @item message-generate-new-buffers
924 @vindex message-generate-new-buffers 950 @vindex message-generate-new-buffers
986 @end lisp 1012 @end lisp
987 1013
988 This restores the Gnus window configuration when the message buffer is 1014 This restores the Gnus window configuration when the message buffer is
989 killed, postponed or exited. 1015 killed, postponed or exited.
990 1016
991 An @dfn{action} can be either a normal function; or a list where the 1017 An @dfn{action} can be either: a normal function, or a list where the
992 @code{car} is a function and the @code{cdr} is the list of arguments; or 1018 @code{car} is a function and the @code{cdr} is the list of arguments, or
993 a form to be @code{eval}ed. 1019 a form to be @code{eval}ed.
994 1020
995 @node Index 1021 @node Index
996 @chapter Index 1022 @chapter Index
997 @printindex cp 1023 @printindex cp