(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.

2 files changed, 47 insertions, 7 deletions

diff --git a/man/ChangeLog b/man/ChangeLog
index b63fd24ad01..f60713518c0 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,14 @@
+2006-11-13  Bill Wohler  <wohler@newt.com>
+
+	* mh-e.texi (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.
+
 2006-11-12  Richard Stallman  <rms@gnu.org>
 
 	* woman.texi: Update author address but say he no longer maintains it.
diff --git a/man/mh-e.texi b/man/mh-e.texi
index dcc84e16acd..a47739a317a 100644
--- a/man/mh-e.texi
+++ b/man/mh-e.texi
@@ -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 @@ use @command{procmail} to filter this mail into @file{~/mail/mh-e}
 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 @@ the message numbers from outside of MH-E.
 @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 @@ into MH-E. Or, give a prefix argument to @code{mh-rmail} so it will
 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 option @code{mh-display-buttons-for-alternatives-flag} is on, then
 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 @@ Function called by the tool bar search button (default:
 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 @@ reclassifies a range of messages (@pxref{Ranges}) as ham if it were
 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 @@ To use SpamAssassin, add the following recipes to @file{~/.procmailrc}:
 @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 @@ To use bogofilter, add the following recipes to @file{~/.procmailrc}:
 @cindex header field, @samp{X-Bogosity:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 # Fight spam with Bogofilter.
@@ -7764,6 +7790,7 @@ To use SpamProbe, add the following recipes to @file{~/.procmailrc}:
 @cindex header field, @samp{X-SpamProbe:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 # Fight spam with SpamProbe.
@@ -7803,6 +7830,7 @@ can't read.
 @cindex header field, @samp{Subject:}
 
 @smallexample
+PATH=$PATH:/usr/bin/mh
 MAILDIR=$HOME/`mhparam Path`
 
 #
@@ -8528,6 +8556,7 @@ to the GnuCash mailing list, substitute one to which you are
 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.