@c %**end of header
@c Version of the software and manual.
-@set VERSION 8.0.1
+@set VERSION 8.0.3
@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
+@set UPDATED 2006-11-12
+@set UPDATE-MONTH November, 2006
@c Other variables.
@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
This is version @value{VERSION}@value{EDITION} of @cite{The MH-E
Manual}, last updated @value{UPDATED}.
-Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006 Free
+Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007, 2008 Free
Software Foundation, Inc.
@quotation
@item
the GNU General Public License as published by the Free Software
-Foundation; either version 2, or (at your option) any later version.
+Foundation; either version 3, or (at your option) any later version.
@end enumerate
The MH-E manual is distributed in the hope that it will be useful, but
Tour Through MH-E
-* Sending Mail Tour::
-* Reading Mail Tour::
-* Processing Mail Tour::
-* Leaving MH-E::
-* More About MH-E::
+* Sending Mail Tour::
+* Reading Mail Tour::
+* Processing Mail Tour::
+* Leaving MH-E::
+* More About MH-E::
Using This Manual
-* Options::
-* Ranges::
-* Folder Selection::
+* Options::
+* Ranges::
+* Folder Selection::
Reading Your Mail
-* Viewing::
-* Viewing Attachments::
-* HTML::
-* Digests::
-* Reading PGP::
-* Printing::
-* Files and Pipes::
-* Navigating::
-* Miscellaneous Commands and Options::
+* Viewing::
+* Viewing Attachments::
+* HTML::
+* Digests::
+* Reading PGP::
+* Printing::
+* Files and Pipes::
+* Navigating::
+* Miscellaneous Commands and Options::
Sending Mail
-* Composing::
-* Replying::
-* Forwarding::
-* Redistributing::
-* Editing Again::
+* Composing::
+* Replying::
+* Forwarding::
+* Redistributing::
+* Editing Again::
Editing a Draft
-* Editing Message::
-* Inserting Letter::
-* Inserting Messages::
-* Signature::
-* Picture::
-* Adding Attachments::
-* Sending PGP::
-* Checking Recipients::
-* Sending Message::
-* Killing Draft::
+* Editing Message::
+* Inserting Letter::
+* Inserting Messages::
+* Signature::
+* Picture::
+* Adding Attachments::
+* Sending PGP::
+* Checking Recipients::
+* Sending Message::
+* Killing Draft::
Odds and Ends
-* Bug Reports::
-* Mailing Lists::
-* MH FAQ and Support::
-* Getting MH-E::
+* Bug Reports::
+* Mailing Lists::
+* MH FAQ and Support::
+* Getting MH-E::
History of MH-E
-* From Brian Reid::
-* From Jim Larus::
-* From Stephen Gildea::
-* From Bill Wohler::
+* From Brian Reid::
+* From Jim Larus::
+* From Stephen Gildea::
+* From Bill Wohler::
@end detailmenu
@end menu
numerical argument before entering the command.
@end quotation
@sp 1
-
+
@cindex @file{.emacs}
@cindex Emacs, variables
@cindex files, @file{.emacs}
@findex customize-option
Commands often offer @dfn{hooks} which enable you to extend or modify
-the way a command works.
+the way a command works.
@ifnothtml
@ref{Hooks, , Hooks, emacs, The GNU Emacs Manual}, in @cite{The GNU
Emacs Manual}
get the big picture, and then you can read the manual as you wish.
@menu
-* Sending Mail Tour::
-* Reading Mail Tour::
-* Processing Mail Tour::
-* Leaving MH-E::
-* More About MH-E::
+* Sending Mail Tour::
+* Reading Mail Tour::
+* Processing Mail Tour::
+* Leaving MH-E::
+* More About MH-E::
@end menu
@node Sending Mail Tour, Reading Mail Tour, Tour Through MH-E, Tour Through MH-E
@cartouche
@smallexample
-To:
-cc:
-Subject: Re: Test
-In-reply-to: <31054.1142621351@@stop.mail-abuse.org>
+To:
+cc:
+Subject: Re: Test
+In-reply-to: <31054.1142621351@@stop.mail-abuse.org>
References: <31054.1142621351@@stop.mail-abuse.org>
Comments: In-reply-to Bill Wohler <wohler@@stop.mail-abuse.org>
message dated "Fri, 17 Mar 2006 10:49:11 -0800."
your initials. (Unless, of course, your initials happen to be @emph{mh}!)
@menu
-* Options::
-* Ranges::
-* Folder Selection::
+* Options::
+* Ranges::
+* Folder Selection::
@end menu
@node Options, Ranges, Using This Manual, Using This Manual
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
@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
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}
detail in the following sections.
@menu
-* Viewing::
-* Viewing Attachments::
-* HTML::
-* Digests::
-* Reading PGP::
-* Printing::
-* Files and Pipes::
-* Navigating::
-* Miscellaneous Commands and Options::
+* Viewing::
+* Viewing Attachments::
+* HTML::
+* Digests::
+* Reading PGP::
+* Printing::
+* Files and Pipes::
+* Navigating::
+* Miscellaneous Commands and Options::
@end menu
@node Viewing, Viewing Attachments, Reading Mail, Reading Mail
over large messages which may be slow to load. The default value of 0
means that all message are shown regardless of size.
-A litany of options control what displayed messages look like.
+A litany of options control what displayed messages look like.
@vindex mh-show-cc
@vindex mh-show-date
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
@end ifinfo
@ifnotinfo
see section @uref{http://www.gnus.org/manual/emacs-mime_6.html,
-Display Customization} in the @cite{The Emacs MIME Manual} and the the
+Display Customization} in the @cite{The Emacs MIME Manual} and the
documentation for the Gnus command @kbd{W h} (see section
@uref{http://www.gnus.org/manual/gnus_99.html, Article Washing} in the
@cite{The Gnus Manual}).
@cindex customization group, @samp{pgg}
The @samp{pgg} customization group may have some settings which may
-interest you.
+interest you.
@iftex
See @cite{The PGG Manual}.
@end iftex
in the following sections.
@menu
-* Composing::
-* Replying::
-* Forwarding::
-* Redistributing::
-* Editing Again::
+* Composing::
+* Replying::
+* Forwarding::
+* Redistributing::
+* Editing Again::
@end menu
@node Composing, Replying, Sending Mail, Sending Mail
detail in the following sections.
@menu
-* Editing Message::
-* Inserting Letter::
-* Inserting Messages::
-* Signature::
-* Picture::
-* Adding Attachments::
-* Sending PGP::
-* Checking Recipients::
-* Sending Message::
-* Killing Draft::
+* Editing Message::
+* Inserting Letter::
+* Inserting Messages::
+* Signature::
+* Picture::
+* Adding Attachments::
+* Sending PGP::
+* Checking Recipients::
+* Sending Message::
+* Killing Draft::
@end menu
@node Editing Message, Inserting Letter, Editing Drafts, Editing Drafts
@code{mh-alias-flash-on-comma} is turned on.
@c XXX Document the replacement for the inaccessible 'long argument.
-
+
@findex mh-letter-toggle-header-field-display
@kindex C-c C-t
@cindex customization group, @samp{pgg}
The @samp{pgg} customization group may have some settings which may
-interest you.
+interest you.
@iftex
See @cite{The PGG Manual}.
@end iftex
regular expression
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
-GNU Emacs Manual}).
+GNU Emacs Manual}).
@end ifnothtml
@ifhtml
(see the section
and enter a regular expression for the recipient's address
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
-GNU Emacs Manual}).
+GNU Emacs Manual}).
@end ifnothtml
@ifhtml
(see the section
reply.
@c -------------------------
@item Other Field
-Other header fields may be added using this menu item.
+Other header fields may be added using this menu item.
@end table
@findex mh-insert-auto-fields
an existing handler function associated with the field you want to
change with the name of a function you have written. You can also
click on an @samp{INS} button and insert a field of your choice and
-the name of the function you have written to handle it.
+the name of the function you have written to handle it.
@vindex mh-identity-list
@kindex M-x speedbar
@kindex Mouse-2
-You can also use the speedbar
+You can also use the speedbar
@ifnothtml
(@pxref{Speedbar, , Speedbar Frames, emacs, The GNU Emacs Manual},)
@end ifnothtml
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
in searching.
@vtable @code
-@item mh-search-program
+@item mh-search-program
Search program that MH-E shall use (default: @samp{Auto-detect}).
@end vtable
@c -------------------------
@kindex / m
@findex mh-narrow-to-from
-@item / m
+@item / m
Limit to messages with the same @samp{From:} field
(@code{mh-narrow-to-from}).
@c -------------------------
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.
@cindex header field, @samp{X-Spam-Status:}
@smallexample
+PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`
# Fight spam with SpamAssassin.
Note that one of the recipes above throws away messages with a score
greater than or equal to 10. Here's how you can determine a value that
-works best for you.
+works best for you.
First, run @samp{spamassassin -t} on every mail message in your
archive and use @command{gnumeric} to verify that the average plus the
@cindex header field, @samp{X-Bogosity:}
@smallexample
+PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`
# Fight spam with Bogofilter.
@cindex header field, @samp{X-SpamProbe:}
@smallexample
+PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`
# Fight spam with SpamProbe.
@cindex header field, @samp{Subject:}
@smallexample
+PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`
#
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.
I also point out some additional sources of information.
@menu
-* Bug Reports::
-* Mailing Lists::
-* MH FAQ and Support::
-* Getting MH-E::
+* Bug Reports::
+* Mailing Lists::
+* MH FAQ and Support::
+* Getting MH-E::
@end menu
@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
lives today.
@menu
-* From Brian Reid::
-* From Jim Larus::
-* From Stephen Gildea::
-* From Bill Wohler::
+* From Brian Reid::
+* From Jim Larus::
+* From Stephen Gildea::
+* From Bill Wohler::
@end menu
@node From Brian Reid, From Jim Larus, History, History
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
-as published by the Free Software Foundation; either version 2
+as published by the Free Software Foundation; either version 3
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
when it starts in an interactive mode:
@smallexample
-Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author}
+Gnomovision version 69, Copyright (C) @var{yyyy} @var{name of author}
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
type `show w'. This is free software, and you are welcome
to redistribute it under certain conditions; type `show c'
@c The following are words that ispell should ignore that would not
@c normally be in a dictionary (global or personal). Be careful not to
@c include words here that could potentially be typos of other words
-@c (such as url, elisp, or MHE).
+@c (such as url, elisp, or MHE).
@c
@c LocalWords: CTRL ESC SPC f's
@c LocalWords: addr Aliasfile alist