Mercurial > hg > xemacs-beta
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 |