X-Git-Url: https://git.hcoop.net/bpt/emacs.git/blobdiff_plain/093571c374d671607c822dd2e5bedb2ac877ea91..2cdd366f840d28efb582bd5a12f2cc8f5d7d7bf1:/doc/misc/message.texi?ds=sidebyside diff --git a/doc/misc/message.texi b/doc/misc/message.texi index 37c3384c1e..fb39107d3a 100644 --- a/doc/misc/message.texi +++ b/doc/misc/message.texi @@ -9,36 +9,30 @@ This file documents Message, the Emacs message composition mode. Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. @quotation Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.2 or +under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no -Invariant Sections, with the Front-Cover texts being ``A GNU -Manual'', and with the Back-Cover Texts as in (a) below. A copy of the -license is included in the section entitled ``GNU Free Documentation -License'' in the Emacs manual. - -(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify -this GNU Manual, like GNU software. Copies published by the Free -Software Foundation raise funds for GNU development.'' - -This document is part of a collection distributed under the GNU Free -Documentation License. If you want to distribute this document -separately from the collection, you can do so by adding a copy of the -license to the document, as described in section 6 of the license. +Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', +and with the Back-Cover Texts as in (a) below. A copy of the license +is included in the section entitled ``GNU Free Documentation License''. + +(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and +modify this GNU manual. Buying copies from the FSF supports it in +developing GNU and promoting software freedom.'' @end quotation @end copying @dircategory Emacs @direntry -* Message: (message). Mail and news composition mode that goes with Gnus. +* Message: (message). Mail and news composition mode that + goes with Gnus. @end direntry @iftex @finalout @end iftex -@setchapternewpage odd @titlepage @title Message Manual @@ -49,11 +43,17 @@ license to the document, as described in section 6 of the license. @vskip 0pt plus 1filll @insertcopying @end titlepage -@page + +@summarycontents +@contents @node Top @top Message +@ifnottex +@insertcopying +@end ifnottex + All message composition from Gnus (both mail and news) takes place in Message mode buffers. @@ -182,6 +182,37 @@ Addresses that match the @code{message-dont-reply-to-names} regular expression (or list of regular expressions) will be removed from the @code{Cc} header. A value of @code{nil} means exclude your name only. +@vindex message-prune-recipient-rules +@code{message-prune-recipient-rules} is used to prune the addresses +used when doing a wide reply. It's meant to be used to remove +duplicate addresses and the like. It's a list of lists, where the +first element is a regexp to match the address to trigger the rule, +and the second is a regexp that will be expanded based on the first, +to match addresses to be pruned. + +It's complicated to explain, but it's easy to use. + +For instance, if you get an email from @samp{foo@example.org}, but +@samp{foo@zot.example.org} is also in the @code{Cc} list, then your +wide reply will go out to both these addresses, since they are unique. + +To avoid this, do something like the following: + +@code +(setq message-prune-recipient-rules + '(("^\\([^@]+\\)@\\(.*\\)" "\\1@.*[.]\\2"))) +@end code + +If, for instance, you want all wide replies that involve messages from +@samp{cvs@example.org} to go to that address, and nowhere else (i.e., +remove all other recipients if @samp{cvs@example.org} is in the +recipient list: + +@code +(setq message-prune-recipient-rules + '(("cvs@example.org" "."))) +@end code + @vindex message-wide-reply-confirm-recipients If @code{message-wide-reply-confirm-recipients} is non-@code{nil} you will be asked to confirm that you want to reply to multiple @@ -552,8 +583,8 @@ in the key binding is for Originator.) @findex message-goto-bcc Go to the @code{Bcc} header (@code{message-goto-bcc}). -@item C-c C-f C-f -@kindex C-c C-f C-f +@item C-c C-f C-w +@kindex C-c C-f C-w @findex message-goto-fcc Go to the @code{Fcc} header (@code{message-goto-fcc}). @@ -582,8 +613,8 @@ Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}). @findex message-goto-distribution Go to the @code{Distribution} header (@code{message-goto-distribution}). -@item C-c C-f C-o -@kindex C-c C-f C-o +@item C-c C-f C-f +@kindex C-c C-f C-f @findex message-goto-followup-to Go to the @code{Followup-To} header (@code{message-goto-followup-to}). @@ -660,7 +691,7 @@ address from @code{To:} and @code{Cc:} headers. @findex message-insert-disposition-notification-to Insert a request for a disposition notification. (@code{message-insert-disposition-notification-to}). -This means that if the recipient support RFC 2298 she might send you a +This means that if the recipient supports RFC 2298 she might send you a notification that she received the message. @item M-x message-insert-importance-high @@ -1645,7 +1676,8 @@ the problem will actually occur. @cindex split large message The limitation of messages sent as message/partial. The lower bound of message size in characters, beyond which the message should be sent -in several parts. If it is @code{nil}, the size is unlimited. +in several parts. If it is @code{nil} (which is the default), the +size is unlimited. @end table @@ -1958,15 +1990,12 @@ Number of spaces to indent yanked messages. @item message-cite-function @vindex message-cite-function @findex message-cite-original -@findex sc-cite-original @findex message-cite-original-without-signature -@cindex Supercite Function for citing an original message. The default is @code{message-cite-original}, which simply inserts the original message and prepends @samp{> } to each line. @code{message-cite-original-without-signature} does the same, but elides -the signature. You can also set it to @code{sc-cite-original} to use -Supercite. +the signature. @item message-indent-citation-function @vindex message-indent-citation-function @@ -2229,6 +2258,11 @@ non-@code{nil}, attach local files as external parts. If non-@code{nil} wait for and display errors when sending a message; if @code{nil} let the mailer mail back a message to report errors. +@item message-confirm-send +@vindex message-confirm-send +When non-@code{nil}, Gnus will ask for confirmation when sending a +message. + @end table @@ -2386,7 +2420,7 @@ consulted, in turn: @item wide reply A @dfn{wide reply} is a mail response that includes @emph{all} entities -mentioned in the message you are responded to. All mailboxes from the +mentioned in the message you are responding to. All mailboxes from the following headers will be concatenated to form the outgoing @code{To}/@code{Cc} headers: @@ -2436,8 +2470,6 @@ basis of the new @code{Cc} header, except if this header is @chapter Key Index @printindex ky -@summarycontents -@contents @bye @c End: