comparison man/mh-e.texi @ 90667:dbe3f29e61d6

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 505-522) - Update from CVS - Merge from gnus--rel--5.10 - Update from CVS: etc/TUTORIAL.cn: Updated. - Merge from erc--emacs--22 * gnus--rel--5.10 (patch 164-167) - Update from CVS Revision: [e-mail]/emacs--unicode--0--patch-137

90666:00d54c8fa693

@setfilename ../info/mh-e
@settitle The MH-E Manual
@c %**end of header

@c Version of the software and manual.
@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

@c Other variables.
@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
@set MH-E-HOME http://mh-e.sourceforge.net/

Suppose you are subscribed to the @i{mh-e-devel} mailing list and you
use @command{procmail} to filter this mail into @file{~/mail/mh-e}
with the following recipe in @file{.procmailrc}:

@smallexample
MAILDIR=$HOME/mail
:0:
* ^From mh-e-devel-admin@@stop.mail-abuse.org
mh-e
@end smallexample

@cindex MH-Show mode
@cindex modes, MH-Folder
@cindex modes, MH-Show
@cindex reading mail
@findex mh-rmail
@kindex M-x mh-rmail
@kindex F r
@kindex F v

The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
command incorporates your mail and creates a buffer called
@samp{+inbox} in MH-Folder mode. The command @kbd{M-x mh-rmail} shows
you only new mail, not mail you have already read@footnote{If you want
to see your old mail as well, use @kbd{F r} to pull all your messages
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}.}.

@cindex @command{scan}
@cindex @samp{Message} menu
@cindex MH commands, @command{scan}
@cindex menu, @samp{Message}

attachment in increasing degree of faithfulness to the original
content. By default, only the preferred alternative is displayed. If
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.

@kindex K i
@findex mh-folder-inline-mime-part

You can view the raw contents of an attachment with the command @kbd{K

@c -------------------------
@item mh-xemacs-tool-bar-position
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).
@end vtable

In GNU Emacs, icons for some of MH-E's functions are added to the tool
bar. In XEmacs, you have the opportunity to create a separate tool bar for
the MH-E icons.

In contrast, the command @kbd{J w} (@code{mh-junk-whitelist})
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.

@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}.

The following sections discuss the various counter-spam measures that
MH-E can work with.

@cindex @file{.procmailrc}

@cindex @samp{X-Spam-Status:} header field
@cindex header field, @samp{X-Spam-Level:}
@cindex header field, @samp{X-Spam-Status:}

@smallexample
MAILDIR=$HOME/`mhparam Path`

# Fight spam with SpamAssassin.
:0fw
| spamc

@cindex @samp{X-Bogosity:} header field
@cindex header field, @samp{X-Bogosity:}

@smallexample
MAILDIR=$HOME/`mhparam Path`

# Fight spam with Bogofilter.
:0fw
| bogofilter -3 -e -p

@cindex @command{formail}
@cindex @samp{X-SpamProbe:} header field
@cindex header field, @samp{X-SpamProbe:}

@smallexample
MAILDIR=$HOME/`mhparam Path`

# Fight spam with SpamProbe.
:0
SCORE=| spamprobe receive

@cindex header field, @samp{Content-Transfer-Encoding:}
@cindex header field, @samp{Content-Type:}
@cindex header field, @samp{Subject:}

@smallexample
MAILDIR=$HOME/`mhparam Path`

#
# Filter messages with win32 executables/virii.
#

Next add the following to @file{~/.procmailrc}. If you don't subscribe
to the GnuCash mailing list, substitute one to which you are
subscribed.

@smallexample
MAILDIR=$HOME/`mhparam Path`
# Place mail sent to the GnuCash mailing list in gnucash.spool, where
# Gnus will pick it up.
:0:
* ^TO.*gnucash.*@.*gnucash.org

90667:dbe3f29e61d6

@setfilename ../info/mh-e
@settitle The MH-E Manual
@c %**end of header

@c Version of the software and manual.
@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-11-12
@set UPDATE-MONTH November, 2006

@c Other variables.
@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
@set MH-E-HOME http://mh-e.sourceforge.net/

Suppose you are subscribed to the @i{mh-e-devel} mailing list and you
use @command{procmail} to filter this mail into @file{~/mail/mh-e}
with the following recipe in @file{.procmailrc}:

@smallexample
PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`
:0:
* ^From mh-e-devel-admin@@stop.mail-abuse.org
mh-e
@end smallexample

@cindex MH-Show mode
@cindex modes, MH-Folder
@cindex modes, MH-Show
@cindex reading mail
@findex 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
@samp{+inbox} in MH-Folder mode. The command @kbd{M-x mh-rmail} shows
you only new mail, not mail you have already read@footnote{If you want
to see your old mail as well, use @kbd{F r} to pull all your messages
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}
@cindex menu, @samp{Message}

attachment in increasing degree of faithfulness to the original
content. By default, only the preferred alternative is displayed. If
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

You can view the raw contents of an attachment with the command @kbd{K

@c -------------------------
@item mh-xemacs-tool-bar-position
Tool bar location (default: @samp{Same As Default Tool Bar}).
@c -------------------------
@item mh-xemacs-use-tool-bar-flag
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
bar. In XEmacs, you have the opportunity to create a separate tool bar for
the MH-E icons.

In contrast, the command @kbd{J w} (@code{mh-junk-whitelist})
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}. @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 @file{.procmailrc}

@cindex @samp{X-Spam-Status:} header field
@cindex header field, @samp{X-Spam-Level:}
@cindex header field, @samp{X-Spam-Status:}

@smallexample
PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`

# Fight spam with SpamAssassin.
:0fw
| spamc

@cindex @samp{X-Bogosity:} header field
@cindex header field, @samp{X-Bogosity:}

@smallexample
PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`

# Fight spam with Bogofilter.
:0fw
| bogofilter -3 -e -p

@cindex @command{formail}
@cindex @samp{X-SpamProbe:} header field
@cindex header field, @samp{X-SpamProbe:}

@smallexample
PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`

# Fight spam with SpamProbe.
:0
SCORE=| spamprobe receive

@cindex header field, @samp{Content-Transfer-Encoding:}
@cindex header field, @samp{Content-Type:}
@cindex header field, @samp{Subject:}

@smallexample
PATH=$PATH:/usr/bin/mh
MAILDIR=$HOME/`mhparam Path`

#
# Filter messages with win32 executables/virii.
#

Next add the following to @file{~/.procmailrc}. If you don't subscribe
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.
:0:
* ^TO.*gnucash.*@.*gnucash.org