comparison man/mh-e.texi @ 90918:e9f94688a064

Merge from emacs--devo--0 Patches applied: * emacs--devo--0 (patch 781-792) - Update from CVS - Merge from gnus--rel--5.10 - Merge from emacs--rel--22 * emacs--rel--22 (patch 33-41) * gnus--rel--5.10 (patch 226-228) - Update from CVS Revision: [e-mail]/emacs--unicode--0--patch-219

90917:9f1c3e957d3e

@detailmenu
 --- The Detailed Node Listing ---

Tour Through 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::            

Reading Your Mail

* Viewing::                     
* Viewing Attachments::         
* HTML::                        
* Digests::                     
* Reading PGP::                 
* Printing::                    
* Files and Pipes::             
* Navigating::                  
* Miscellaneous Commands and Options::  

Sending Mail

* 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::               

Odds and Ends

* 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::            

@end detailmenu
@end menu

@html

The prefix @kbd{C-u} or @kbd{M-} is not necessary in MH-E's MH-Folder
mode (@pxref{Reading Mail Tour}). In this mode, simply enter the
numerical argument before entering the command.
@end quotation
@sp 1
 
@cindex @file{.emacs}
@cindex Emacs, variables
@cindex files, @file{.emacs}
@cindex variables
@findex setq

@cindex normal hooks
@findex add-hook
@findex customize-option

Commands often offer @dfn{hooks} which enable you to extend or modify
the way a command works. 
@ifnothtml
@ref{Hooks, , Hooks, emacs, The GNU Emacs Manual}, in @cite{The GNU
Emacs Manual}
@end ifnothtml
@ifhtml

curious or adventurous type, read the rest of the manual to be able to
use all the features of MH-E. I suggest you read this chapter first to
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::             
@end menu

@node Sending Mail Tour, Reading Mail Tour, Tour Through MH-E, Tour Through MH-E
@section Sending Mail

You'll find yourself in an Emacs buffer similar to that when you were
sending the original message, like this:

@cartouche
@smallexample
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."
X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
--------

@samp{mh-}. This prefix is reserved for the MH-E package. To avoid
conflicts with existing MH-E symbols, use a prefix like @samp{my-} or
your initials. (Unless, of course, your initials happen to be @emph{mh}!)

@menu
* Options::                     
* Ranges::                      
* Folder Selection::            
@end menu

@node Options, Ranges, Using This Manual, Using This Manual
@section Options

The functions and variables introduced here are explained in more
detail in the following sections.

@menu
* 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
@section Viewing Your Mail

The option @code{mh-show-maximum-size} provides an opportunity to skip
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. 

@vindex mh-show-cc
@vindex mh-show-date
@vindex mh-show-from
@vindex mh-show-header

@xref{Display Customization,,,emacs-mime}, and the documentation for
the Gnus command @kbd{W h} (@pxref{Article Washing,,,gnus},).
@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
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}).
@end ifnotinfo

@cindex @samp{pgg} customization group
@cindex PGG
@cindex customization group, @samp{pgg}

The @samp{pgg} customization group may have some settings which may
interest you. 
@iftex
See @cite{The PGG Manual}.
@end iftex
@ifinfo
@xref{Top, , The PGG Manual, pgg, The PGG Manual}.

The functions and options introduced here are explained in more detail
in the following sections.

@menu
* Composing::                   
* Replying::                    
* Forwarding::                  
* Redistributing::              
* Editing Again::               
@end menu

@node Composing, Replying, Sending Mail, Sending Mail
@section Composing

The commands and options introduced here are explained in more
detail in the following sections.

@menu
* 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
@section Editing the Message

press the comma, the command @code{mh-letter-confirm-address} flashes
the alias expansion in the minibuffer if
@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

Use the command @kbd{C-c C-t}
@code{mh-letter-toggle-header-field-display} to display truncated

@cindex @samp{pgg} customization group
@cindex PGG
@cindex customization group, @samp{pgg}

The @samp{pgg} customization group may have some settings which may
interest you. 
@iftex
See @cite{The PGG Manual}.
@end iftex
@ifinfo
@xref{Top, , The PGG Manual, pgg, The PGG Manual}.

If you can't quite remember an alias, you can use @kbd{M-x
mh-alias-apropos} to show all aliases or addresses that match a
regular expression
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
GNU Emacs Manual}). 
@end ifnothtml
@ifhtml
(see the section
@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
Syntax of Regular Expressions} in

identity depending on the recipient to provide even more control. To
customize @code{mh-auto-fields-list}, click on the @samp{INS} button
and enter a regular expression for the recipient's address
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
GNU Emacs Manual}). 
@end ifnothtml
@ifhtml
(see the section
@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
Syntax of Regular Expressions} in

must either remove the @samp{Mail-Followup-To:} field, or ensure the
recipient is also listed there so that he receives replies to your
reply.
@c -------------------------
@item Other Field
Other header fields may be added using this menu item. 
@end table

@findex mh-insert-auto-fields
@kindex C-c M-d
@vindex mh-auto-fields-prompt-flag

fields, signatures, and attributions in @code{mh-identity-list} are
added. To customize @code{mh-identity-handlers}, replace the name of
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. 

@vindex mh-identity-list

The @samp{Field} field can be any field that you've used in your
@code{mh-identity-list}. The special fields @samp{:attribution-verb},

@findex mh-visit-folder
@kindex F v
@kindex M-x speedbar
@kindex Mouse-2

You can also use the speedbar 
@ifnothtml
(@pxref{Speedbar, , Speedbar Frames, emacs, The GNU Emacs Manual},)
@end ifnothtml
@ifhtml
(see the section

There is one option from the @samp{mh-search} customization group used
in searching.

@vtable @code
@item mh-search-program 
Search program that MH-E shall use (default: @samp{Auto-detect}).
@end vtable

The following hook is available.

Limit to messages with the same @samp{Cc:} field
(@code{mh-narrow-to-cc}).
@c -------------------------
@kindex / m
@findex mh-narrow-to-from
@item / m	
Limit to messages with the same @samp{From:} field
(@code{mh-narrow-to-from}).
@c -------------------------
@kindex / g
@findex mh-narrow-to-range

If you don't use @command{spamc}, use @samp{spamassassin -P -a}.

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. 

First, run @samp{spamassassin -t} on every mail message in your
archive and use @command{gnumeric} to verify that the average plus the
standard deviation of good mail is under 5, the SpamAssassin default
for ``spam''.

This appendix covers a few topics that don't fit elsewhere. Here I
tell you how to report bugs and how to get on the MH-E mailing lists.
I also point out some additional sources of information.

@menu
* Bug Reports::                 
* Mailing Lists::               
* MH FAQ and Support::          
* Getting MH-E::                
@end menu

@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
@appendixsec Bug Reports

improvements. Bill Wohler then took over in 2000 and moved its
development to @uref{http://sourceforge.net/, SourceForge} where it
lives today.

@menu
* From Brian Reid::             
* From Jim Larus::              
* From Stephen Gildea::         
* From Bill Wohler::            
@end menu

@node From Brian Reid, From Jim Larus, History, History
@appendixsec From Brian Reid

@c Ispell Helpers
@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
@c LocalWords: CTRL ESC SPC f's
@c LocalWords: addr Aliasfile alist
@c LocalWords: Baushke Bcc BBN Beranek bogofilter bogofilter's
@c LocalWords: cmd CMU contrib cron

90918:e9f94688a064

@detailmenu
 --- The Detailed Node Listing ---

Tour Through 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::

Reading Your Mail

* Viewing::
* Viewing Attachments::
* HTML::
* Digests::
* Reading PGP::
* Printing::
* Files and Pipes::
* Navigating::
* Miscellaneous Commands and Options::

Sending Mail

* 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::

Odds and Ends

* 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::

@end detailmenu
@end menu

@html

The prefix @kbd{C-u} or @kbd{M-} is not necessary in MH-E's MH-Folder
mode (@pxref{Reading Mail Tour}). In this mode, simply enter the
numerical argument before entering the command.
@end quotation
@sp 1

@cindex @file{.emacs}
@cindex Emacs, variables
@cindex files, @file{.emacs}
@cindex variables
@findex setq

@cindex normal hooks
@findex add-hook
@findex customize-option

Commands often offer @dfn{hooks} which enable you to extend or modify
the way a command works.
@ifnothtml
@ref{Hooks, , Hooks, emacs, The GNU Emacs Manual}, in @cite{The GNU
Emacs Manual}
@end ifnothtml
@ifhtml

curious or adventurous type, read the rest of the manual to be able to
use all the features of MH-E. I suggest you read this chapter first to
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::
@end menu

@node Sending Mail Tour, Reading Mail Tour, Tour Through MH-E, Tour Through MH-E
@section Sending Mail

You'll find yourself in an Emacs buffer similar to that when you were
sending the original message, like this:

@cartouche
@smallexample
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."
X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
--------

@samp{mh-}. This prefix is reserved for the MH-E package. To avoid
conflicts with existing MH-E symbols, use a prefix like @samp{my-} or
your initials. (Unless, of course, your initials happen to be @emph{mh}!)

@menu
* Options::
* Ranges::
* Folder Selection::
@end menu

@node Options, Ranges, Using This Manual, Using This Manual
@section Options

The functions and variables introduced here are explained in more
detail in the following sections.

@menu
* 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
@section Viewing Your Mail

The option @code{mh-show-maximum-size} provides an opportunity to skip
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.

@vindex mh-show-cc
@vindex mh-show-date
@vindex mh-show-from
@vindex mh-show-header

@xref{Display Customization,,,emacs-mime}, and the documentation for
the Gnus command @kbd{W h} (@pxref{Article Washing,,,gnus},).
@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
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}).
@end ifnotinfo

@cindex @samp{pgg} customization group
@cindex PGG
@cindex customization group, @samp{pgg}

The @samp{pgg} customization group may have some settings which may
interest you.
@iftex
See @cite{The PGG Manual}.
@end iftex
@ifinfo
@xref{Top, , The PGG Manual, pgg, The PGG Manual}.

The functions and options introduced here are explained in more detail
in the following sections.

@menu
* Composing::
* Replying::
* Forwarding::
* Redistributing::
* Editing Again::
@end menu

@node Composing, Replying, Sending Mail, Sending Mail
@section Composing

The commands and options introduced here are explained in more
detail in the following sections.

@menu
* 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
@section Editing the Message

press the comma, the command @code{mh-letter-confirm-address} flashes
the alias expansion in the minibuffer if
@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

Use the command @kbd{C-c C-t}
@code{mh-letter-toggle-header-field-display} to display truncated

@cindex @samp{pgg} customization group
@cindex PGG
@cindex customization group, @samp{pgg}

The @samp{pgg} customization group may have some settings which may
interest you.
@iftex
See @cite{The PGG Manual}.
@end iftex
@ifinfo
@xref{Top, , The PGG Manual, pgg, The PGG Manual}.

If you can't quite remember an alias, you can use @kbd{M-x
mh-alias-apropos} to show all aliases or addresses that match a
regular expression
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
GNU Emacs Manual}).
@end ifnothtml
@ifhtml
(see the section
@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
Syntax of Regular Expressions} in

identity depending on the recipient to provide even more control. To
customize @code{mh-auto-fields-list}, click on the @samp{INS} button
and enter a regular expression for the recipient's address
@ifnothtml
(@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
GNU Emacs Manual}).
@end ifnothtml
@ifhtml
(see the section
@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
Syntax of Regular Expressions} in

must either remove the @samp{Mail-Followup-To:} field, or ensure the
recipient is also listed there so that he receives replies to your
reply.
@c -------------------------
@item Other Field
Other header fields may be added using this menu item.
@end table

@findex mh-insert-auto-fields
@kindex C-c M-d
@vindex mh-auto-fields-prompt-flag

fields, signatures, and attributions in @code{mh-identity-list} are
added. To customize @code{mh-identity-handlers}, replace the name of
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.

@vindex mh-identity-list

The @samp{Field} field can be any field that you've used in your
@code{mh-identity-list}. The special fields @samp{:attribution-verb},

@findex mh-visit-folder
@kindex F v
@kindex M-x speedbar
@kindex Mouse-2

You can also use the speedbar
@ifnothtml
(@pxref{Speedbar, , Speedbar Frames, emacs, The GNU Emacs Manual},)
@end ifnothtml
@ifhtml
(see the section

There is one option from the @samp{mh-search} customization group used
in searching.

@vtable @code
@item mh-search-program
Search program that MH-E shall use (default: @samp{Auto-detect}).
@end vtable

The following hook is available.

Limit to messages with the same @samp{Cc:} field
(@code{mh-narrow-to-cc}).
@c -------------------------
@kindex / m
@findex mh-narrow-to-from
@item / m
Limit to messages with the same @samp{From:} field
(@code{mh-narrow-to-from}).
@c -------------------------
@kindex / g
@findex mh-narrow-to-range

If you don't use @command{spamc}, use @samp{spamassassin -P -a}.

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.

First, run @samp{spamassassin -t} on every mail message in your
archive and use @command{gnumeric} to verify that the average plus the
standard deviation of good mail is under 5, the SpamAssassin default
for ``spam''.

This appendix covers a few topics that don't fit elsewhere. Here I
tell you how to report bugs and how to get on the MH-E mailing lists.
I also point out some additional sources of information.

@menu
* Bug Reports::
* Mailing Lists::
* MH FAQ and Support::
* Getting MH-E::
@end menu

@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
@appendixsec Bug Reports

improvements. Bill Wohler then took over in 2000 and moved its
development to @uref{http://sourceforge.net/, SourceForge} where it
lives today.

@menu
* From Brian Reid::
* From Jim Larus::
* From Stephen Gildea::
* From Bill Wohler::
@end menu

@node From Brian Reid, From Jim Larus, History, History
@appendixsec From Brian Reid

@c Ispell Helpers
@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
@c LocalWords: CTRL ESC SPC f's
@c LocalWords: addr Aliasfile alist
@c LocalWords: Baushke Bcc BBN Beranek bogofilter bogofilter's
@c LocalWords: cmd CMU contrib cron