\input texinfo @c -*-texinfo-*-
-@setfilename message.info
+@setfilename message
@settitle Message Manual
@synindex fn cp
@synindex vr cp
@findex message-wide-reply
The @code{message-wide-reply} pops up a message buffer that's a wide
-reply to the message in the current buffer.
+reply to the message in the current buffer. A @dfn{wide reply} is a
+reply that goes out to all people listed in the @code{To}, @code{From}
+and @code{Cc} headers.
@vindex message-wide-reply-to-function
Message uses the normal methods to determine where wide replies are to go,
signature will be inserted before the forwarded message. If not, the
forwarded message will be inserted first in the new mail.
-@item message-forward-included-headers
-@vindex message-forward-included-headers
+@item message-included-forward-headers
+@vindex message-included-forward-headers
Regexp matching header lines to be included in forwarded messages.
@end table
@findex message-bounce
The @code{message-bounce} command will, if the current buffer contains a
bounced mail message, pop up a message buffer stripped of the bounce
-information.
+information. A @dfn{bounced message} is typically a mail you've sent
+out that has been returned by some @code{mailer-daemon} as
+undeliverable.
@vindex message-ignored-bounced-headers
Headers that match the @code{message-ignored-bounced-headers} regexp
@vindex message-cite-function
@findex message-cite-original
@findex sc-cite-original
-@cindex SuperCite
+@cindex Supercite
Function for citing an original message. The default is
@code{message-cite-original}. You can also set it to
-@code{sc-cite-original} to use SuperCite.
+@code{sc-cite-original} to use Supercite.
@item message-indent-citation-function
@vindex message-indent-citation-function
Check whether the newsgroups mentioned in the Newsgroups and
Followup-To headers exist.
@item valid-newsgroups
-Check whether the @code{Newsgroups} and @code{Followup-To} headers
-are valid syntactially.
+Check whether the @code{Newsgroups} and @code{Followup-to} headers
+are valid syntactically.
+@item shorten-followup-to
+Check whether to add a @code{Followup-to} header to shorten the number
+of groups to post to.
@end table
All these conditions are checked by default.
@vindex message-autosave-directory
Directory where message buffers will be autosaved to.
+@item message-signature-setup-hook
+@vindex message-signature-setup-hook
+Hook run when initializing the message buffer. It is run after the
+headers have been inserted but before the signature has been inserted.
+
@item message-setup-hook
@vindex message-setup-hook
-Hook run when the message buffer has been initialized.
+Hook run as the last thing when the message buffer has been initialized.
@item message-header-setup-hook
@vindex message-header-setup-hook
@item message-courtesy-message
@vindex message-courtesy-message
When sending combined messages, this string is inserted at the start of
-the mailed copy. If this variable is @code{nil}, no such courtesy
-message will be added.
+the mailed copy. If the string contains the format spec @samp{%s}, the
+newsgroups the article has been posted to will be inserted there. If
+this variable is @code{nil}, no such courtesy message will be added.
+The default value is @samp{"The following message is a courtesy copy of
+an article\nthat has been posted to %s as well.\n\n"}.
@end table
@table @code
@item message-generate-new-buffers
-@findex message-generate-new-buffers
-If non-@code{nil}, generate new buffers. The default is @code{t}.
+@vindex message-generate-new-buffers
+If non-@code{nil}, generate new buffers. The default is @code{t}. If
+this is a function, call that function with three parameters: The type,
+the to address and the group name. (Any of these may be @code{nil}.)
+The function should return the new buffer name.
@item message-max-buffers
-@findex message-max-buffers
+@vindex message-max-buffers
This variable says how many old message buffers to keep. If there are
more message buffers than this, the oldest buffer will be killed. The
default is 10. If this variable is @code{nil}, no old message buffers
will ever be killed.
+@item message-send-rename-function
+@vindex message-send-rename-function
+After sending a message, the buffer is renamed from, for instance,
+@samp{*reply to Lars*} to @samp{*sent reply to Lars*}. If you don't
+like this, set this variable to a function that renames the buffer in a
+manner you like. If you don't want to rename the buffer at all, you can
+say:
+
+@lisp
+(setq message-send-rename-function 'ignore)
+@end lisp
+
@item message-kill-buffer-on-exit
@findex message-kill-buffer-on-exit
If non-@code{nil}, kill the buffer immediately on exit.