/[emacs]/emacs/man/mh-e.texi
ViewVC logotype

Diff of /emacs/man/mh-e.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.12 by rms, Wed Sep 12 20:59:49 2001 UTC revision 1.12.8.1 by miles, Fri Apr 4 06:20:48 2003 UTC
# Line 5  Line 5 
5  @settitle mh-e  @settitle mh-e
6  @c %**end of header  @c %**end of header
7    
 @setchapternewpage odd  
   
 @dircategory Emacs  
 @direntry  
 * MH-E: (mh-e).         Emacs interface to the MH mail system.  
 @end direntry  
   
8  @c Version variables.  @c Version variables.
9  @set EDITION 1.3  @set EDITION 1.3
10  @set VERSION 5.0.2  @set VERSION 5.0.2
11  @set UPDATED 18 February 2001  @set UPDATED 18 February 2001
12  @set UPDATE-MONTH February 2001  @set UPDATE-MONTH February 2001
13    
14  @ifinfo  @copying
15  This is Edition @value{EDITION}, last updated @value{UPDATED}, of  This is Edition @value{EDITION}, last updated @value{UPDATED}, of
16  @cite{mh-e, The Emacs Interface to MH}, for mh-e, Version  @cite{mh-e, The Emacs Interface to MH}, for mh-e, Version
17  @value{VERSION}.  @value{VERSION}.
18    
19  Copyright 1995, 2001 Free Software Foundation, Inc.  Copyright 1995, 2001, 2002 Free Software Foundation, Inc.
20    
21    @quotation
22  Permission is granted to copy, distribute and/or modify this document  Permission is granted to copy, distribute and/or modify this document
23  under the terms of the GNU Free Documentation License, Version 1.1 or  under the terms of the GNU Free Documentation License, Version 1.1 or
24  any later version published by the Free Software Foundation; with no  any later version published by the Free Software Foundation; with no
# Line 41  This document is part of a collection di Line 35  This document is part of a collection di
35  Documentation License.  If you want to distribute this document  Documentation License.  If you want to distribute this document
36  separately from the collection, you can do so by adding a copy of the  separately from the collection, you can do so by adding a copy of the
37  license to the document, as described in section 6 of the license.  license to the document, as described in section 6 of the license.
38  @end ifinfo  @end quotation
39    @end copying
40    
41    @setchapternewpage odd
42    
43    @dircategory Emacs
44    @direntry
45    * MH-E: (mh-e).         Emacs interface to the MH mail system.
46    @end direntry
47    
48  @titlepage  @titlepage
49  @sp 10  @sp 10
# Line 57  license to the document, as described in Line 59  license to the document, as described in
59    
60  @page  @page
61  @vskip 0pt plus 1filll  @vskip 0pt plus 1filll
62  Copyright @copyright{} 1995, 2001 Free Software Foundation, Inc.  Copyright @copyright{} 1995, 2001, 2002 Free Software Foundation, Inc.
63    @insertcopying
 Permission is granted to copy, distribute and/or modify this document  
 under the terms of the GNU Free Documentation License, Version 1.1 or  
 any later version published by the Free Software Foundation; with no  
 Invariant Sections, with the Front-Cover texts being ``A GNU  
 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the  
 license is included in the section entitled ``GNU Free Documentation  
 License'' in the Emacs manual.  
   
 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify  
 this GNU Manual, like GNU software.  Copies published by the Free  
 Software Foundation raise funds for GNU development.''  
   
 This document is part of a collection distributed under the GNU Free  
 Documentation License.  If you want to distribute this document  
 separately from the collection, you can do so by adding a copy of the  
 license to the document, as described in section 6 of the license.  
64  @end titlepage  @end titlepage
65    
66  @ifinfo  @ifnottex
67  @node Top, Preface, (dir), (dir)  @node Top, Preface, (dir), (dir)
68  @top MH and Emacs  @top MH and Emacs
69  This is Edition @value{EDITION} of @cite{mh-e, The Emacs Interface to  This is Edition @value{EDITION} of @cite{mh-e, The Emacs Interface to
# Line 92  MH}, last updated @value{UPDATED} for mh Line 78  MH}, last updated @value{UPDATED} for mh
78                                  list and FAQ.                                  list and FAQ.
79  * History::                     The authors speak up!  * History::                     The authors speak up!
80  * Copying::                     The GNU General Public License  * Copying::                     The GNU General Public License
81  * Command Index::                * Command Index::
82  * Variable Index::                * Variable Index::
83  * Concept Index::                * Concept Index::
84  @end menu  @end menu
85  @end ifinfo  @end ifnottex
86    
87  @node Preface, Tour Through mh-e, Top, Top  @node Preface, Tour Through mh-e, Top, Top
88  @unnumbered Preface  @unnumbered Preface
# Line 168  the other two as you wish. Line 154  the other two as you wish.
154    
155  @menu  @menu
156  * Conventions::                 GNU Emacs Terms and Conventions  * Conventions::                 GNU Emacs Terms and Conventions
157  * Getting Started::              * Getting Started::
158  * Sending Mail Tour::            * Sending Mail Tour::
159  * Reading Mail Tour::            * Reading Mail Tour::
160  * Processing Mail Tour::          * Processing Mail Tour::
161  * Leaving mh-e::                  * Leaving mh-e::
162  * More About mh-e::              * More About mh-e::
163  @end menu  @end menu
164    
165  @node Conventions, Getting Started, Tour Through mh-e, Tour Through mh-e  @node Conventions, Getting Started, Tour Through mh-e, Tour Through mh-e
# Line 640  conventions are strange to you. Line 626  conventions are strange to you.
626  Let's get started!  Let's get started!
627    
628  @menu  @menu
629  * Reading Mail::                  * Reading Mail::
630  * Sending Mail::                  * Sending Mail::
631  * Draft Editing::                * Draft Editing::
632  * Moving Mail::                  * Moving Mail::
633  * Searching::                    * Searching::
634  * Sequences::                    * Sequences::
635  * Miscellaneous::                * Miscellaneous::
636  @end menu  @end menu
637    
638  @node Reading Mail, Sending Mail, Using mh-e, Using mh-e  @node Reading Mail, Sending Mail, Using mh-e, Using mh-e
# Line 714  Toggle between MH-Folder and MH-Folder S Line 700  Toggle between MH-Folder and MH-Folder S
700  @end table  @end table
701    
702  @menu  @menu
703  * Viewing::                      * Viewing::
704  * Moving Around::                * Moving Around::
705  @end menu  @end menu
706    
707  @node Viewing, Moving Around, Reading Mail, Reading Mail  @node Viewing, Moving Around, Reading Mail, Reading Mail
# Line 738  to see all of them, use the @kbd{,} (com Line 724  to see all of them, use the @kbd{,} (com
724  command.  command.
725    
726  @menu  @menu
727  * Reading Digests::              * Reading Digests::
728  * Reading MIME::                  * Reading MIME::
729  @end menu  @end menu
730    
731  @node Reading Digests, Reading MIME, Viewing, Viewing  @node Reading Digests, Reading MIME, Viewing, Viewing
# Line 910  buffer on top and the draft on the botto Line 896  buffer on top and the draft on the botto
896  the window layout, use @kbd{M-x mh-smail-other-window}.  the window layout, use @kbd{M-x mh-smail-other-window}.
897    
898  @menu  @menu
899  * Replying::                      * Replying::
900  * Forwarding::                    * Forwarding::
901  * Redistributing::                * Redistributing::
902  * Old Drafts::                    * Old Drafts::
903  @end menu  @end menu
904    
905  @node Replying, Forwarding, Sending Mail, Sending Mail  @node Replying, Forwarding, Sending Mail, Sending Mail
# Line 1110  Quit editing and delete draft message (@ Line 1096  Quit editing and delete draft message (@
1096  @end table  @end table
1097    
1098  @menu  @menu
1099  * Editing Textual::              * Editing Textual::
1100  * Editing MIME::                  * Editing MIME::
1101  * Sending Message::              * Sending Message::
1102  * Killing Draft::                * Killing Draft::
1103  @end menu  @end menu
1104    
1105  @node Editing Textual, Editing MIME, Draft Editing, Draft Editing  @node Editing Textual, Editing MIME, Draft Editing, Draft Editing
# Line 1124  The commands described here are also app Line 1110  The commands described here are also app
1110  multimedia components.  multimedia components.
1111    
1112  @menu  @menu
1113  * Inserting Letter::              * Inserting Letter::
1114  * Inserting Messages::            * Inserting Messages::
1115  * Header::                        * Header::
1116  * Recipients::                    * Recipients::
1117  * Signature::                    * Signature::
1118  @end menu  @end menu
1119    
1120  @node Inserting Letter, Inserting Messages, Editing Textual, Editing Textual  @node Inserting Letter, Inserting Messages, Editing Textual, Editing Textual
# Line 1256  the content types that mh-e currently kn Line 1242  the content types that mh-e currently kn
1242  commands fill in the content type for you, whereas others require you to  commands fill in the content type for you, whereas others require you to
1243  enter one.  Most of the time, it should be obvious which one to use  enter one.  Most of the time, it should be obvious which one to use
1244  (e.g., use @kbd{image/jpeg} to include a @sc{jpeg} image).  If not, you  (e.g., use @kbd{image/jpeg} to include a @sc{jpeg} image).  If not, you
1245  can refer to @sc{rfc} 1521,  can refer to @sc{rfc} 1521,
1246  @c Footnotes are very fragile.  Hence the duplication.  @c Footnotes are very fragile.  Hence the duplication.
1247  @c The line break in the footnote was necessary since TeX wasn't creating one.  @c The line break in the footnote was necessary since TeX wasn't creating one.
1248  @ifclear html  @ifclear html
# Line 1283  multimedia fields unless the content des Line 1269  multimedia fields unless the content des
1269  Remember: you can always add @code{mhn} directives by hand.  Remember: you can always add @code{mhn} directives by hand.
1270    
1271  @menu  @menu
1272  * Forwarding MIME::              * Forwarding MIME::
1273  * FTP::                          * FTP::
1274  * Tar::                          * Tar::
1275  * Other MIME Objects::            * Other MIME Objects::
1276  * Sending MIME::                  * Sending MIME::
1277  @end menu  @end menu
1278    
1279  @node Forwarding MIME, FTP, Editing MIME, Editing MIME  @node Forwarding MIME, FTP, Editing MIME, Editing MIME
# Line 1532  Quit (@code{mh-quit}). Line 1518  Quit (@code{mh-quit}).
1518  @end table  @end table
1519    
1520  @menu  @menu
1521  * Incorporating::                * Incorporating::
1522  * Deleting::                      * Deleting::
1523  * Organizing::                    * Organizing::
1524  * Printing::                      * Printing::
1525  * Files and Pipes::              * Files and Pipes::
1526  * Finishing Up::                  * Finishing Up::
1527  @end menu  @end menu
1528    
1529  @node Incorporating, Deleting, Moving Mail, Moving Mail  @node Incorporating, Deleting, Moving Mail, Moving Mail
# Line 1972  always be included with any bug report y Line 1958  always be included with any bug report y
1958  @chapter Customizing mh-e  @chapter Customizing mh-e
1959    
1960  Until now, we've talked about the mh-e commands as they work ``out of the  Until now, we've talked about the mh-e commands as they work ``out of the
1961  box.''  Of course, it is also possible to reconfigure mh-e  box.''  Of course, it is also possible to reconfigure mh-e
1962  to fit the needs of even the most demanding user.  to fit the needs of even the most demanding user.
1963  The following sections describe all of the  The following sections describe all of the
1964  customization variables, show the defaults, and make recommendations for  customization variables, show the defaults, and make recommendations for
# Line 2081  avoid conflicts with existing mh-e symbo Line 2067  avoid conflicts with existing mh-e symbo
2067  or your initials.  or your initials.
2068    
2069  @menu  @menu
2070  * Customizing Reading::          * Customizing Reading::
2071  * Customizing Sending::          * Customizing Sending::
2072  * Customizing Draft Editing::    * Customizing Draft Editing::
2073  * Customizing Moving Mail::      * Customizing Moving Mail::
2074  * Customizing Searching::        * Customizing Searching::
2075  @end menu  @end menu
2076    
2077  @node Customizing Reading, Customizing Sending, Customizing mh-e, Customizing mh-e  @node Customizing Reading, Customizing Sending, Customizing mh-e, Customizing mh-e
# Line 2293  key bindings, for example: Line 2279  key bindings, for example:
2279  @end lisp  @end lisp
2280    
2281  @menu  @menu
2282  * Customizing Viewing::          * Customizing Viewing::
2283  * Customizing Moving Around::    * Customizing Moving Around::
2284  @end menu  @end menu
2285    
2286  @node Customizing Viewing, Customizing Moving Around, Customizing Reading, Customizing Reading  @node Customizing Viewing, Customizing Moving Around, Customizing Reading, Customizing Reading
# Line 2540  This function is passed three arguments: Line 2526  This function is passed three arguments:
2526  @samp{Subject:}, and @samp{cc:} header fields.  @samp{Subject:}, and @samp{cc:} header fields.
2527    
2528  @menu  @menu
2529  * Customizing Replying::          * Customizing Replying::
2530  * Customizing Forwarding::        * Customizing Forwarding::
2531  * Customizing Redistributing::    * Customizing Redistributing::
2532  * Customizing Old Drafts::        * Customizing Old Drafts::
2533  @end menu  @end menu
2534    
2535  @node Customizing Replying, Customizing Forwarding, Customizing Sending, Customizing Sending  @node Customizing Replying, Customizing Forwarding, Customizing Sending, Customizing Sending
# Line 2679  MH program used to send messages (defaul Line 2665  MH program used to send messages (defaul
2665  @end table  @end table
2666    
2667  @menu  @menu
2668  * Customizing Editing Textual::    * Customizing Editing Textual::
2669  * Customizing Editing MIME::      * Customizing Editing MIME::
2670  * Customizing Sending Message::    * Customizing Sending Message::
2671  @end menu  @end menu
2672    
2673  @node Customizing Editing Textual, Customizing Editing MIME, Customizing Draft Editing, Customizing Draft Editing  @node Customizing Editing Textual, Customizing Editing MIME, Customizing Draft Editing, Customizing Draft Editing
# Line 2692  edit a draft.  The discussion here appli Line 2678  edit a draft.  The discussion here appli
2678  messages as well.  messages as well.
2679    
2680  @menu  @menu
2681  * Customizing Inserting Letter::    * Customizing Inserting Letter::
2682  * Customizing Signature::        * Customizing Signature::
2683  @end menu  @end menu
2684    
2685  @node Customizing Inserting Letter, Customizing Signature, Customizing Editing Textual, Customizing Editing Textual  @node Customizing Inserting Letter, Customizing Signature, Customizing Editing Textual, Customizing Editing Textual
# Line 2725  default, which means that when a message Line 2711  default, which means that when a message
2711  each line is prefixed by @code{mh-ins-buf-prefix}.  Otherwise, it can be  each line is prefixed by @code{mh-ins-buf-prefix}.  Otherwise, it can be
2712  set to a function that modifies an included  set to a function that modifies an included
2713  @cindex Emacs, packages, supercite  @cindex Emacs, packages, supercite
2714  citation.  citation.
2715  @c Footnotes are fragile; hence the redundancy.  @c Footnotes are fragile; hence the redundancy.
2716  @c TeX not inserting a line break; hence the @*  @c TeX not inserting a line break; hence the @*
2717  @ifclear html  @ifclear html
# Line 2819  like: @samp{You should be <bold>very</bo Line 2805  like: @samp{You should be <bold>very</bo
2805  interested in investigating @code{sgml-mode}.  interested in investigating @code{sgml-mode}.
2806    
2807  @menu  @menu
2808  * Customizing Sending MIME::      * Customizing Sending MIME::
2809  @end menu  @end menu
2810    
2811  @node Customizing Sending MIME,  , Customizing Editing MIME, Customizing Editing MIME  @node Customizing Sending MIME,  , Customizing Editing MIME, Customizing Editing MIME
# Line 2910  Program to scan messages (default: @samp Line 2896  Program to scan messages (default: @samp
2896    
2897  @item mh-before-quit-hook  @item mh-before-quit-hook
2898  Functions to run before quitting (default: @code{nil}).  See also  Functions to run before quitting (default: @code{nil}).  See also
2899  @code{mh-quit-hook}.  @code{mh-quit-hook}.
2900    
2901  @item mh-quit-hook  @item mh-quit-hook
2902  Functions to run after quitting (default: @code{nil}). See also  Functions to run after quitting (default: @code{nil}). See also
# Line 2918  Functions to run after quitting (default Line 2904  Functions to run after quitting (default
2904  @end table  @end table
2905    
2906  @menu  @menu
2907  * Customizing Incorporating::    * Customizing Incorporating::
2908  * Customizing Deleting::          * Customizing Deleting::
2909  * Customizing Organizing::        * Customizing Organizing::
2910  * Customizing Printing::          * Customizing Printing::
2911  * Customizing Files and Pipes::    * Customizing Files and Pipes::
2912  * Customizing Finishing Up::      * Customizing Finishing Up::
2913  @end menu  @end menu
2914    
2915  @node Customizing Incorporating, Customizing Deleting, Customizing Moving Mail, Customizing Moving Mail  @node Customizing Incorporating, Customizing Deleting, Customizing Moving Mail, Customizing Moving Mail
# Line 3090  override any arguments given in a @code{ Line 3076  override any arguments given in a @code{
3076  (@file{~/.mh_profile}).  (@file{~/.mh_profile}).
3077    
3078  @menu  @menu
3079  * Customizing Scan Line Formats::    * Customizing Scan Line Formats::
3080  @end menu  @end menu
3081    
3082  @node Customizing Scan Line Formats,  , Customizing Organizing, Customizing Organizing  @node Customizing Scan Line Formats,  , Customizing Organizing, Customizing Organizing
# Line 3294  mh-e context, so you might use it to mod Line 3280  mh-e context, so you might use it to mod
3280  If you find that you do the same thing over and over when editing the  If you find that you do the same thing over and over when editing the
3281  search template, you may wish to bind some shortcuts to keys.  This can  search template, you may wish to bind some shortcuts to keys.  This can
3282  be done with the variable @code{mh-pick-mode-hook}, which is called when  be done with the variable @code{mh-pick-mode-hook}, which is called when
3283  @kbd{M-s} (@code{mh-search-folder}) is run on a new pattern.    @kbd{M-s} (@code{mh-search-folder}) is run on a new pattern.
3284    
3285  The string  The string
3286  @code{mh-partial-folder-mode-line-annotation} is used to annotate the  @code{mh-partial-folder-mode-line-annotation} is used to annotate the
# Line 3316  you how to report bugs and how to get on Line 3302  you how to report bugs and how to get on
3302  point out some additional sources of information.  point out some additional sources of information.
3303    
3304  @menu  @menu
3305  * Bug Reports::                  * Bug Reports::
3306  * Mailing List::                  * Mailing List::
3307  * MH FAQ::                        * MH FAQ::
3308  * Getting mh-e::                  * Getting mh-e::
3309  @end menu  @end menu
3310    
3311  @node Bug Reports, Mailing List, Odds and Ends, Odds and Ends  @node Bug Reports, Mailing List, Odds and Ends, Odds and Ends
# Line 3427  Bill Wohler then took over in 2000 and m Line 3413  Bill Wohler then took over in 2000 and m
3413  @uref{http://sourceforge.net/, SourceForge}.  @uref{http://sourceforge.net/, SourceForge}.
3414    
3415  @menu  @menu
3416  * From Brian Reid::              * From Brian Reid::
3417  * From Jim Larus::                * From Jim Larus::
3418  * From Stephen Gildea::          * From Stephen Gildea::
3419  @end menu  @end menu
3420    
3421  @node From Brian Reid, From Jim Larus, History, History  @node From Brian Reid, From Jim Larus, History, History
# Line 3913  when it starts in an interactive mode: Line 3899  when it starts in an interactive mode:
3899  Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author}  Gnomovision version 69, Copyright (C) 20@var{yy} @var{name of author}
3900  Gnomovision comes with ABSOLUTELY NO WARRANTY; for details  Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
3901  type `show w'.  This is free software, and you are welcome  type `show w'.  This is free software, and you are welcome
3902  to redistribute it under certain conditions; type `show c'  to redistribute it under certain conditions; type `show c'
3903  for details.  for details.
3904  @end smallexample  @end smallexample
3905    
# Line 3931  necessary.  Here is a sample; alter the Line 3917  necessary.  Here is a sample; alter the
3917  @group  @group
3918  Yoyodyne, Inc., hereby disclaims all copyright  Yoyodyne, Inc., hereby disclaims all copyright
3919  interest in the program `Gnomovision'  interest in the program `Gnomovision'
3920  (which makes passes at compilers) written  (which makes passes at compilers) written
3921  by James Hacker.  by James Hacker.
3922    
3923  @var{signature of Ty Coon}, 1 April 1989  @var{signature of Ty Coon}, 1 April 1989

Legend:
Removed from v.1.12  
changed lines
  Added in v.1.12.8.1

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26