*** empty log message ***

[gnus] / texi / message.texi

diff --git a/texi/message.texi b/texi/message.texi
index ae764d7..6d60fe2 100644 (file)
--- a/texi/message.texi
+++ b/texi/message.texi
@@ -1,7 +1,7 @@
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename message
 \input texinfo                  @c -*-texinfo-*-
 
 @setfilename message

-@settitle Message 5.6.26 Manual
+@settitle Pterodactyl Message 0.86 Manual

 @synindex fn cp
 @synindex vr cp
 @synindex pg cp
 @synindex fn cp
 @synindex vr cp
 @synindex pg cp


@@ -17,7 +17,7 @@
 
 This file documents Message, the Emacs message composition mode.
 
 
 This file documents Message, the Emacs message composition mode.
 

-Copyright (C) 1996 Free Software Foundation, Inc.
+Copyright (C) 1996,97,98,99 Free Software Foundation, Inc.

 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice


@@ -42,13 +42,13 @@ into another language, under the above conditions for modified versions.
 @tex
 
 @titlepage
 @tex
 
 @titlepage

-@title Message 5.6.26 Manual
+@title Pterodactyl Message 0.86 Manual

 
 @author by Lars Magne Ingebrigtsen
 @page
 
 @vskip 0pt plus 1filll
 
 @author by Lars Magne Ingebrigtsen
 @page
 
 @vskip 0pt plus 1filll

-Copyright @copyright{} 1996 Free Software Foundation, Inc. 
+Copyright @copyright{} 1996,97,98,99 Free Software Foundation, Inc.

 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice


@@ -83,9 +83,9 @@ Message mode buffers.
 * Key Index::         List of Message mode keys.
 @end menu
 
 * Key Index::         List of Message mode keys.
 @end menu
 

-This manual corresponds to Message 5.6.26.  Message is distributed with
-the Gnus distribution bearing the same version number as this manual
-has. 
+This manual corresponds to Pterodactyl Message 0.86.  Message is
+distributed with the Gnus distribution bearing the same version number
+as this manual.

 
 
 @node Interface
 
 
 @node Interface


@@ -116,7 +116,7 @@ sending it.
 @section New Mail Message
 
 @findex message-mail
 @section New Mail Message
 
 @findex message-mail

-The @code{message-mail} command pops up a new message buffer.  
+The @code{message-mail} command pops up a new message buffer.

 
 Two optional parameters are accepted: The first will be used as the
 @code{To} header and the second as the @code{Subject} header.  If these
 
 Two optional parameters are accepted: The first will be used as the
 @code{To} header and the second as the @code{Subject} header.  If these


@@ -127,7 +127,7 @@ are @code{nil}, those two headers will be empty.
 @section New News Message
 
 @findex message-news
 @section New News Message
 
 @findex message-news

-The @code{message-news} command pops up a new message buffer.  
+The @code{message-news} command pops up a new message buffer.

 
 This function accepts two optional parameters.  The first will be used
 as the @code{Newsgroups} header and the second as the @code{Subject}
 
 This function accepts two optional parameters.  The first will be used
 as the @code{Newsgroups} header and the second as the @code{Subject}


@@ -153,8 +153,8 @@ If you want the replies to go to the @code{Sender} instead of the
 (setq message-reply-to-function
       (lambda ()
        (cond ((equal (mail-fetch-field "from") "somebody")
 (setq message-reply-to-function
       (lambda ()
        (cond ((equal (mail-fetch-field "from") "somebody")

-               (mail-fetch-field "sender"))     
-             (t 
+               (mail-fetch-field "sender"))
+             (t

               nil))))
 @end lisp
 
               nil))))
 @end lisp
 


@@ -170,7 +170,7 @@ This function can also return a list.  In that case, each list element
 should be a cons, where the car should be the name of an header
 (eg. @code{Cc}) and the cdr should be the header value
 (eg. @samp{larsi@@ifi.uio.no}).  All these headers will be inserted into
 should be a cons, where the car should be the name of an header
 (eg. @code{Cc}) and the cdr should be the header value
 (eg. @samp{larsi@@ifi.uio.no}).  All these headers will be inserted into

-the head of the outgoing mail. 
+the head of the outgoing mail.

 
 
 @node Wide Reply
 
 
 @node Wide Reply


@@ -186,7 +186,7 @@ reply that goes out to all people listed in the @code{To}, @code{From}
 Message uses the normal methods to determine where wide replies are to go,
 but you can change the behavior to suit your needs by fiddling with the
 @code{message-wide-reply-to-function}.  It is used in the same way as
 Message uses the normal methods to determine where wide replies are to go,
 but you can change the behavior to suit your needs by fiddling with the
 @code{message-wide-reply-to-function}.  It is used in the same way as

-@code{message-reply-to-function} (@pxref{Reply}). 
+@code{message-reply-to-function} (@pxref{Reply}).

 
 @findex rmail-dont-reply-to-names
 Addresses that match the @code{rmail-dont-reply-to-names} regular
 
 @findex rmail-dont-reply-to-names
 Addresses that match the @code{rmail-dont-reply-to-names} regular


@@ -249,13 +249,13 @@ news.
 @item message-forward-start-separator
 @vindex message-forward-start-separator
 Delimiter inserted before forwarded messages.  The default is@*
 @item message-forward-start-separator
 @vindex message-forward-start-separator
 Delimiter inserted before forwarded messages.  The default is@*

-@samp{------- Start of forwarded message -------\n}. 
+@samp{------- Start of forwarded message -------\n}.

 
 @vindex message-forward-end-separator
 @item message-forward-end-separator
 @vindex message-forward-end-separator
 Delimiter inserted after forwarded messages.  The default is@*
 
 @vindex message-forward-end-separator
 @item message-forward-end-separator
 @vindex message-forward-end-separator
 Delimiter inserted after forwarded messages.  The default is@*

-@samp{------- End of forwarded message -------\n}. 
+@samp{------- End of forwarded message -------\n}.

 
 @item message-signature-before-forwarded-message
 @vindex message-signature-before-forwarded-message
 
 @item message-signature-before-forwarded-message
 @vindex message-signature-before-forwarded-message


@@ -265,7 +265,32 @@ forwarded message will be inserted first in the new mail.
 
 @item message-included-forward-headers
 @vindex message-included-forward-headers
 
 @item message-included-forward-headers
 @vindex message-included-forward-headers

-Regexp matching header lines to be included in forwarded messages.  
+Regexp matching header lines to be included in forwarded messages.
+
+@item message-make-forward-subject-function
+@vindex message-make-forward-subject-function
+A list of functions that are called to generate a subject header for
+forwarded messages.  The subject generated by the previous function is
+passed into each successive function.
+
+The provided functions are:
+
+@table @code
+@item message-forward-subject-author-subject
+@findex message-forward-subject-author-subject
+Source of article (author or newsgroup), in brackets followed by the
+subject.
+
+@item message-forward-subject-fwd
+Subject of article with @samp{Fwd:} prepended to it.
+@end table
+
+@item message-wash-forwarded-subjects
+@vindex message-wash-forwarded-subjects
+If this variable is @code{t}, the subjects of forwarded messages have
+the evidence of previous forwards (such as @samp{Fwd:}, @samp{Re:},
+@samp{(fwd)}) removed before the new subject is
+constructed.  The default value is @code{nil}.

 
 @end table
 
 
 @end table
 


@@ -280,7 +305,7 @@ and resend the message in the current buffer to that address.
 @vindex message-ignored-resent-headers
 Headers that match the @code{message-ignored-resent-headers} regexp will
 be removed before sending the message.  The default is
 @vindex message-ignored-resent-headers
 Headers that match the @code{message-ignored-resent-headers} regexp will
 be removed before sending the message.  The default is

-@samp{^Return-receipt}. 
+@samp{^Return-receipt}.

 
 
 @node Bouncing
 
 
 @node Bouncing


@@ -291,7 +316,7 @@ 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.  A @dfn{bounced message} is typically a mail you've sent
 out that has been returned by some @code{mailer-daemon} as
 bounced mail message, pop up a message buffer stripped of the bounce
 information.  A @dfn{bounced message} is typically a mail you've sent
 out that has been returned by some @code{mailer-daemon} as

-undeliverable. 
+undeliverable.

 
 @vindex message-ignored-bounced-headers
 Headers that match the @code{message-ignored-bounced-headers} regexp
 
 @vindex message-ignored-bounced-headers
 Headers that match the @code{message-ignored-bounced-headers} regexp


@@ -306,6 +331,7 @@ will be removed before popping up the buffer.  The default is
 * Header Commands::     Commands for moving to headers.
 * Movement::            Moving around in message buffers.
 * Insertion::           Inserting things into message buffers.
 * Header Commands::     Commands for moving to headers.
 * Movement::            Moving around in message buffers.
 * Insertion::           Inserting things into message buffers.

+* MIME::                @sc{mime} considerations.

 * Various Commands::    Various things.
 * Sending::             Actually sending the message.
 * Mail Aliases::        How to use mail aliases.
 * Various Commands::    Various things.
 * Sending::             Actually sending the message.
 * Mail Aliases::        How to use mail aliases.


@@ -326,57 +352,57 @@ it will be inserted.
 Describe the message mode.
 
 @item C-c C-f C-t
 Describe the message mode.
 
 @item C-c C-f C-t

-@kindex C-c C-f C-t 
+@kindex C-c C-f C-t

 @findex message-goto-to
 Go to the @code{To} header (@code{message-goto-to}).
 
 @item C-c C-f C-b
 @findex message-goto-to
 Go to the @code{To} header (@code{message-goto-to}).
 
 @item C-c C-f C-b

-@kindex C-c C-f C-b 
+@kindex C-c C-f C-b

 @findex message-goto-bcc
 Go to the @code{Bcc} header (@code{message-goto-bcc}).
 
 @item C-c C-f C-f
 @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 
+@kindex C-c C-f C-f

 @findex message-goto-fcc
 Go to the @code{Fcc} header (@code{message-goto-fcc}).
 
 @item C-c C-f C-c
 @findex message-goto-fcc
 Go to the @code{Fcc} header (@code{message-goto-fcc}).
 
 @item C-c C-f C-c

-@kindex C-c C-f C-c 
+@kindex C-c C-f C-c

 @findex message-goto-cc
 Go to the @code{Cc} header (@code{message-goto-cc}).
 
 @item C-c C-f C-s
 @findex message-goto-cc
 Go to the @code{Cc} header (@code{message-goto-cc}).
 
 @item C-c C-f C-s

-@kindex C-c C-f C-s 
+@kindex C-c C-f C-s

 @findex message-goto-subject
 Go to the @code{Subject} header (@code{message-goto-subject}).
 
 @item C-c C-f C-r
 @findex message-goto-subject
 Go to the @code{Subject} header (@code{message-goto-subject}).
 
 @item C-c C-f C-r

-@kindex C-c C-f C-r 
+@kindex C-c C-f C-r

 @findex message-goto-reply-to
 Go to the @code{Reply-To} header (@code{message-goto-reply-to}).
 
 @item C-c C-f C-n
 @findex message-goto-reply-to
 Go to the @code{Reply-To} header (@code{message-goto-reply-to}).
 
 @item C-c C-f C-n

-@kindex C-c C-f C-n 
+@kindex C-c C-f C-n

 @findex message-goto-newsgroups
 Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}).
 
 @item C-c C-f C-d
 @findex message-goto-newsgroups
 Go to the @code{Newsgroups} header (@code{message-goto-newsgroups}).
 
 @item C-c C-f C-d

-@kindex C-c C-f C-d 
+@kindex C-c C-f C-d

 @findex message-goto-distribution
 Go to the @code{Distribution} header (@code{message-goto-distribution}).
 
 @item C-c C-f C-o
 @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 
+@kindex C-c C-f C-o

 @findex message-goto-followup-to
 Go to the @code{Followup-To} header (@code{message-goto-followup-to}).
 
 @item C-c C-f C-k
 @findex message-goto-followup-to
 Go to the @code{Followup-To} header (@code{message-goto-followup-to}).
 
 @item C-c C-f C-k

-@kindex C-c C-f C-k 
+@kindex C-c C-f C-k

 @findex message-goto-keywords
 Go to the @code{Keywords} header (@code{message-goto-keywords}).
 
 @item C-c C-f C-u
 @findex message-goto-keywords
 Go to the @code{Keywords} header (@code{message-goto-keywords}).
 
 @item C-c C-f C-u

-@kindex C-c C-f C-u 
+@kindex C-c C-f C-u

 @findex message-goto-summary
 Go to the @code{Summary} header (@code{message-goto-summary}).
 
 @findex message-goto-summary
 Go to the @code{Summary} header (@code{message-goto-summary}).
 


@@ -388,13 +414,13 @@ Go to the @code{Summary} header (@code{message-goto-summary}).
 
 @table @kbd
 @item C-c C-b
 
 @table @kbd
 @item C-c C-b

-@kindex C-c C-b 
+@kindex C-c C-b

 @findex message-goto-body
 Move to the beginning of the body of the message
 @findex message-goto-body
 Move to the beginning of the body of the message

-(@code{message-goto-body}). 
+(@code{message-goto-body}).

 
 @item C-c C-i
 
 @item C-c C-i

-@kindex C-c C-i 
+@kindex C-c C-i

 @findex message-goto-signature
 Move to the signature of the message (@code{message-goto-signature}).
 
 @findex message-goto-signature
 Move to the signature of the message (@code{message-goto-signature}).
 


@@ -407,13 +433,13 @@ Move to the signature of the message (@code{message-goto-signature}).
 @table @kbd
 
 @item C-c C-y
 @table @kbd
 
 @item C-c C-y

-@kindex C-c C-y 
+@kindex C-c C-y

 @findex message-yank-original
 Yank the message that's being replied to into the message buffer
 @findex message-yank-original
 Yank the message that's being replied to into the message buffer

-(@code{message-yank-original}). 
+(@code{message-yank-original}).

 
 @item C-c C-q
 
 @item C-c C-q

-@kindex C-c C-q 
+@kindex C-c C-q

 @findex message-fill-yanked-message
 Fill the yanked message (@code{message-fill-yanked-message}).  Warning:
 Can severely mess up the yanked text if its quoting conventions are
 @findex message-fill-yanked-message
 Fill the yanked message (@code{message-fill-yanked-message}).  Warning:
 Can severely mess up the yanked text if its quoting conventions are


@@ -421,12 +447,16 @@ strange.  You'll quickly get a feel for when it's safe, though.  Anyway,
 just remember that @kbd{C-x u} (@code{undo}) is available and you'll be
 all right.
 
 just remember that @kbd{C-x u} (@code{undo}) is available and you'll be
 all right.
 

-

 @item C-c C-w
 @item C-c C-w

-@kindex C-c C-w 
+@kindex C-c C-w

 @findex message-insert-signature
 Insert a signature at the end of the buffer
 @findex message-insert-signature
 Insert a signature at the end of the buffer

-(@code{message-insert-signature}).  
+(@code{message-insert-signature}).
+
+@item C-c M-h
+@kindex C-c M-h
+@findex message-insert-headers
+Insert the message headers (@code{message-insert-headers}).

 
 @end table
 
 
 @end table
 


@@ -458,7 +488,6 @@ When you are replying to or following up an article, you normally want
 to quote the person you are answering.  Inserting quoted text is done by
 @dfn{yanking}, and each quoted line you yank will have
 @code{message-yank-prefix} prepended to it.  The default is @samp{> }.
 to quote the person you are answering.  Inserting quoted text is done by
 @dfn{yanking}, and each quoted line you yank will have
 @code{message-yank-prefix} prepended to it.  The default is @samp{> }.

-If it is @code{nil}, just indent the message.

 
 @item message-indentation-spaces
 @vindex message-indentation-spaces
 
 @item message-indentation-spaces
 @vindex message-indentation-spaces


@@ -510,6 +539,27 @@ Including ASCII graphics is an efficient way to get everybody to believe
 that you are silly and have nothing important to say.
 
 
 that you are silly and have nothing important to say.
 
 

+@node MIME
+@section MIME
+@cindex MML
+@cindex MIME
+@cindex multipart
+@cindex attachment
+
+Message is a @sc{mime}-compliant posting agent.  The user generally
+doesn't have to do anything to make the @sc{mime} happen---Message will
+automatically add the @code{Content-Type} and
+@code{Content-Transfer-Encoding} headers.
+
+The most typical thing users want to use the multipart things in
+@sc{mime} for is to add ``attachments'' to mail they send out.  This can
+be done with the @code{C-c C-a} command, which will prompt for a file
+name and a @sc{mime} type.
+
+You can also create arbitrarily complex multiparts using the MML
+language (@pxref{Composing, , Composing, emacs-mime, The Emacs MIME
+Manual}).
+

 
 @node Various Commands
 @section Various Commands
 
 @node Various Commands
 @section Various Commands


@@ -517,7 +567,7 @@ that you are silly and have nothing important to say.
 @table @kbd
 
 @item C-c C-r
 @table @kbd
 
 @item C-c C-r

-@kindex C-c C-r 
+@kindex C-c C-r

 @findex message-caesar-buffer-body
 Caesar rotate (aka. rot13) the current message
 (@code{message-caesar-buffer-body}).  If narrowing is in effect, just
 @findex message-caesar-buffer-body
 Caesar rotate (aka. rot13) the current message
 (@code{message-caesar-buffer-body}).  If narrowing is in effect, just


@@ -564,17 +614,17 @@ If&nbs