# HG changeset patch # User Bill Wohler # Date 1217566061 0 # Node ID 31496191ccd40253997c993231d3e4f69190124f # Parent 31f6e0b2a80ddc72003770e5455126ec76283b14 (Reading Mail) (Viewing Attachments): Describe new function mh-show-preferred-alternative. (Sending Mail, Redistributing, Sending Message): Describe new hook mh-annotate-msg-hook. diff -r 31f6e0b2a80d -r 31496191ccd4 doc/misc/mh-e.texi --- a/doc/misc/mh-e.texi Fri Aug 01 04:42:19 2008 +0000 +++ b/doc/misc/mh-e.texi Fri Aug 01 04:47:41 2008 +0000 @@ -1601,6 +1601,14 @@ @item , (comma) Display message with all header fields (@code{mh-header-display}). @c ------------------------- +@cindex @samp{Message > Show Message with Preferred Alternative} menu item +@cindex menu item, @samp{Message > Show Message with Preferred Alternative} +@kindex : (colon) +@findex mh-show-preferred-alternative +@item : (colon) +Display message with the default preferred alternative +(@code{mh-show-preferred-alternative}). +@c ------------------------- @kindex ; (semicolon) @findex mh-toggle-mh-decode-mime-flag @item ; (semicolon) @@ -2479,6 +2487,15 @@ the option @code{mm-discouraged-alternatives}, and add @samp{text/html}. The next best alternative, if any, will be shown. +@findex mh-show-preferred-alternative +@kindex : (colon) + +Occasionally, though, you might want to see the preferred alternative. +The command @kbd{:} (@code{mh-show-preferred-alternative}) displays +the message with the default preferred alternative. This is as if +@code{mm-discouraged-alternatives} is set to @samp{nil}. Use the +command @key{RET} (@code{mh-show}) to show the message normally again. + @kindex K i @findex mh-folder-inline-mime-part @@ -3536,6 +3553,7 @@ @kindex x @vindex mh-after-commands-processed-hook @vindex mh-before-commands-processed-hook +@vindex mh-current-folder The command @kbd{x} runs @code{mh-before-commands-processed-hook} before the commands are processed and @@ -3928,6 +3946,10 @@ The following hooks are available. @vtable @code +@item mh-annotate-msg-hook +Hook run by @code{mh-annotate-msg} after annotation (default: +@code{nil}). +@c ------------------------- @item mh-forward-hook Hook run by @code{mh-forward} on a forwarded letter (default: @code{nil}). @@ -3937,8 +3959,19 @@ @code{nil}). @end vtable -The functions and options introduced here are explained in more detail -in the following sections. +@findex mh-annotate-msg +@vindex mh-annotate-list +@vindex mh-annotate-msg-hook +@vindex mh-current-folder + +A hook that is called whenever a message is sent and after the scan +lines and message are annotated is @code{mh-annotate-msg-hook}. Hook +functions can access the current folder name with +@code{mh-current-folder} and obtain the message numbers of the +annotated messages with @code{mh-annotate-list}. + +The rest of the functions and options introduced here are explained in +more detail in the following sections. @menu * Composing:: @@ -4268,6 +4301,9 @@ people abhor). If you find that MH will not allow you to redistribute a message that has been redistributed before, turn off this option. +The hook @code{mh-annotate-msg-hook} is run after annotating the +message and scan line (@pxref{Sending Mail}). + @node Editing Again, , Redistributing, Sending Mail @section Editing Old Drafts and Bounced Messages @@ -5620,6 +5656,9 @@ in the MH book.} is installed under a different name, use @code{mh-send-prog} to tell MH-E the name. +The hook @code{mh-annotate-msg-hook} is run after annotating the +message and scan line (@pxref{Sending Mail}). + @node Killing Draft, , Sending Message, Editing Drafts @section Killing the Draft