changeset 73955:bb3a9d42ece7

(Incorporating Mail): Use output of "mhparam Path" to set MAILDIR. (Reading Mail): Document the customization of read-mail-command for MH-E. (Viewing Attachments): Document mm-discouraged-alternatives. (Tool Bar): Fix Texinfo for mh-xemacs-use-tool-bar-flag. (Junk): Add more information about the settings of mh-junk-background in a program. Add /usr/bin/mh to PATH in examples.

--- a/man/mh-e.texi	Mon Nov 13 00:05:29 2006 +0000
+++ b/man/mh-e.texi	Mon Nov 13 01:59:54 2006 +0000
@@ -11,9 +11,9 @@
 @set VERSION 8.0.1
 @c Edition of the manual. It is either empty for the first edition or
 @c has the form ", nth Edition" (without the quotes).
-@set EDITION 
-@set UPDATED 2006-06-20
-@set UPDATE-MONTH June, 2006
+@set EDITION , 2nd Edition
+@set UPDATED 2006-11-11
+@set UPDATE-MONTH November, 2006
 
 @c Other variables.
 @set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
@@ -1481,7 +1481,8 @@
 with the following recipe in @file{.procmailrc}:
 
 @smallexample
-MAILDIR=$HOME/mail
+PATH=$PATH:/usr/bin/mh
+MAILDIR=$HOME/`mhparam Path`
 :0:
 * ^From mh-e-devel-admin@@stop.mail-abuse.org
 mh-e
@@ -1560,9 +1561,9 @@
 @cindex modes, MH-Show
 @cindex reading mail
 @findex mh-rmail
-@kindex M-x mh-rmail
 @kindex F r
 @kindex F v
+@kindex M-x mh-rmail
 
 The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
 command incorporates your mail and creates a buffer called
@@ -1573,6 +1574,14 @@
 prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u
 M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}.
 
+@findex display-time
+@vindex read-mail-command
+
+There are some commands that need to read mail, such as @kbd{Mouse-2}
+over the @samp{Mail} button that @code{display-time} adds to the mode
+line. You can configure Emacs to have these commands use MH-E by
+setting the option @code{read-mail-command} to @samp{mh-rmail}.
+
 @cindex @command{scan}
 @cindex @samp{Message} menu
 @cindex MH commands, @command{scan}
@@ -2476,6 +2485,13 @@
 the preferred part is shown inline and buttons are shown for each of
 the other alternatives.
 
+@vindex mm-discouraged-alternatives
+
+Many people prefer to see the @samp{text/plain} alternative rather
+than the @samp{text/html} alternative. To do this in MH-E, customize
+the option @code{mm-discouraged-alternatives}, and add
+@samp{text/html}. The next best alternative, if any, will be shown.
+
 @kindex K i
 @findex mh-folder-inline-mime-part
 
@@ -6381,7 +6397,7 @@
 Tool bar location (default: @samp{Same As Default Tool Bar}).
 @c -------------------------
 @item mh-xemacs-use-tool-bar-flag
-If on, use tool bar (default: on, if supported).
+If @samp{on}, use tool bar (default: @samp{on}, if supported).
 @end vtable
 
 In GNU Emacs, icons for some of MH-E's functions are added to the tool
@@ -7559,12 +7575,20 @@
 incorrectly classified as spam. It then refiles the message into the
 @file{+inbox} folder.
 
+@cindex @samp{*MH-E Log*}
+@cindex buffers, @samp{*MH-E Log*}
+@findex call-process
 @vindex mh-junk-background
 
 By default, the programs are run in the foreground, but this can be
 slow when junking large numbers of messages. If you have enough memory
 or don't junk that many messages at the same time, you might try
-turning on the option @code{mh-junk-background}.
+turning on the option @code{mh-junk-background}. @footnote{Note that
+the option @code{mh-junk-background} is used as the @code{display}
+argument in the call to @code{call-process}. Therefore, turning on
+this option means setting its value to @samp{0}. You can also set its
+value to @samp{t} to direct the programs' output to the @samp{*MH-E
+Log*} buffer; this may be useful for debugging.}
 
 The following sections discuss the various counter-spam measures that
 MH-E can work with.
@@ -7590,6 +7614,7 @@
 @cindex header field, @samp{X-Spam-Status:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 # Fight spam with SpamAssassin.
@@ -7712,6 +7737,7 @@
 @cindex header field, @samp{X-Bogosity:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 # Fight spam with Bogofilter.
@@ -7764,6 +7790,7 @@
 @cindex header field, @samp{X-SpamProbe:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 # Fight spam with SpamProbe.
@@ -7803,6 +7830,7 @@
 @cindex header field, @samp{Subject:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 #
@@ -8528,6 +8556,7 @@
 subscribed.
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 # Place mail sent to the GnuCash mailing list in gnucash.spool, where
 # Gnus will pick it up.