Mercurial > emacs

annotate doc/misc/mh-e.texi @ 108537:f9f040b85798

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Unify some conditionals in src/Makefile.in. * src/Makefile.in (FONT_DRIVERS): Place with other HAVE_X_WINDOWS stuff. (TOOLTIP_SUPPORT): Place with other HAVE_WINDOW_SYSTEM stuff.
author Glenn Morris <rgm@gnu.org>
date Thu, 13 May 2010 00:57:28 -0700 (2010-05-13)
parents 1d1d5d9bd884
children f1266b2f017e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 @c Note: This document requires makeinfo version 4.6 or greater to build.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5 @c %**start of header
84329
3d431f1997d8 (setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents: 84306
diff changeset
6 @setfilename ../../info/mh-e
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 @settitle The MH-E Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 @c %**end of header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 @c Version of the software and manual.
103407
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
11 @set VERSION 8.2
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12 @c Edition of the manual. It is either empty for the first edition or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13 @c has the form ", nth Edition" (without the quotes).
103407
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
14 @set EDITION
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
15 @set UPDATED 2009-06-13
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
16 @set UPDATE-MONTH June, 2009
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18 @c Other variables.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
19 @set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 @set MH-E-HOME http://mh-e.sourceforge.net/
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22 @c Copyright
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 @copying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 This is version @value{VERSION}@value{EDITION} of @cite{The MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 Manual}, last updated @value{UPDATED}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 106345
diff changeset
27 Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009, 2010
95925
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
28 Free Software Foundation, Inc.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
30 @c This dual license has been agreed upon by the FSF.
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
31
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 @quotation
95925
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
33 Permission is granted to copy, distribute and/or modify this document
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
34 under the terms of either:
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
35
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
36 @enumerate a
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
37 @item
99709
6de181810d0f Relicense all texi files under FDL 1.3 or later.
Glenn Morris <rgm@gnu.org>
parents: 98287
diff changeset
38 the GNU Free Documentation License, Version 1.3 or any later version
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
39 published by the Free Software Foundation; with no Invariant Sections,
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
40 with the Front-Cover texts being ``A GNU Manual,'' and with the
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
41 Back-Cover Texts as in (a) below. A copy of the license is included in
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
42 the section entitled ``GNU Free Documentation License.''
95925
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
43
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
44 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
45 modify this GNU manual. Buying copies from the FSF supports it in
95925
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
46 developing GNU and promoting software freedom.''
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
47
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
48 @item
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
49 the GNU General Public License as published by the Free Software
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
50 Foundation; either version 3, or (at your option) any later version. A
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
51 copy of the license is included in the section entitled ``GNU General
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
52 Public License.''
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
53 @end enumerate
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
54
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 @end copying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 @c Info Directory Entry
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59 @dircategory Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 @direntry
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61 * MH-E: (mh-e). Emacs interface to the MH mail system.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 @end direntry
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64 @c Title Page
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 @titlepage
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 @title The MH-E Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 @subtitle Version @value{VERSION}@value{EDITION}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68 @subtitle @value{UPDATE-MONTH}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 @author Bill Wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 @c Copyright Page
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 @page
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73 @vskip 0pt plus 1filll
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 @insertcopying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75 @end titlepage
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 @ifnottex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 @html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 <!--
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80 @end html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 @node Top, Preface, (dir), (dir)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 @top The MH-E Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 @html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 -->
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 @end html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 @insertcopying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 @end ifnottex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89 @c Table of Contents
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 @contents
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 @html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93 <!--
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94 @end html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
97 * Preface:: Preface
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
98 * Conventions:: GNU Emacs Terms and Conventions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
99 * Getting Started:: Getting Started
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
100 * Tour Through MH-E:: Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101 * Using This Manual:: Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
102 * Incorporating Mail:: Incorporating Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
103 * Reading Mail:: Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104 * Folders:: Organizing Your Mail with Folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 * Sending Mail:: Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 * Editing Drafts:: Editing a Draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107 * Aliases:: Aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108 * Identities:: Identities
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109 * Speedbar:: The Speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 * Menu Bar:: The Menu Bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 * Tool Bar:: The Tool Bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112 * Searching:: Searching Through Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113 * Threading:: Viewing Message Threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 * Limits:: Limiting Display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115 * Sequences:: Using Sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116 * Junk:: Dealing With Junk Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 * Miscellaneous:: Miscellaneous Commands, Variables, and Buffers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118 * Scan Line Formats:: Scan Line Formats
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119 * Procmail:: Reading Mailing Lists Effectively
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120 * Odds and Ends:: Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121 * History:: History of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 * GFDL:: GNU Free Documentation License
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
123 * GPL:: GNU General Public License
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124 * Key Index:: Key (Character) Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125 * Command Index:: Command Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
126 * Option Index:: Option (Variable) Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127 * Concept Index:: Concept Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
129 @detailmenu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130 --- The Detailed Node Listing ---
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132 Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 * Sending Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135 * Reading Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 * Processing Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 * Leaving MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138 * More About MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
140 Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
141
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
142 * Options::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143 * Ranges::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144 * Folder Selection::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 Reading Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 * Viewing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 * Viewing Attachments::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150 * HTML::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 * Digests::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152 * Reading PGP::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 * Printing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 * Files and Pipes::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 * Navigating::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156 * Miscellaneous Commands and Options::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158 Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160 * Composing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161 * Replying::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 * Forwarding::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 * Redistributing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164 * Editing Again::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 Editing a Draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 * Editing Message::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 * Inserting Letter::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170 * Inserting Messages::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171 * Signature::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 * Picture::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173 * Adding Attachments::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 * Sending PGP::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175 * Checking Recipients::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
176 * Sending Message::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
177 * Killing Draft::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179 Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 * Bug Reports::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 * Mailing Lists::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183 * MH FAQ and Support::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184 * Getting MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186 History of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188 * From Brian Reid::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189 * From Jim Larus::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190 * From Stephen Gildea::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191 * From Bill Wohler::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 @end detailmenu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196 @html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197 -->
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 @end html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200 @node Preface, Conventions, Top, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201 @unnumbered Preface
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203 @cindex Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204 @cindex Unix commands, Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 @cindex preface
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207 This manual introduces another interface to the MH mail system that is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208 accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209 easy to use. I don't assume that you know GNU Emacs or even MH at this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210 point, since I didn't know either of them when I discovered MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211 However, MH-E was the tip of the iceberg, and I discovered more and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 more niceties about GNU Emacs and MH@. Now I'm fully hooked on both of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213 them.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 The MH-E package is distributed with GNU Emacs@footnote{Version
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
216 @value{VERSION} of MH-E will appear in GNU Emacs 23.1. It is supported
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
217 in GNU Emacs 21 and 22, as well as XEmacs 21 (except for versions
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219 all versions of nmh, and GNU mailutils 1.0 and higher.}, so you
92984
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
220 shouldn't have to do anything special to use it. Gnus is also
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
221 required; version 5.10 or higher is recommended. This manual covers
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 MH-E version @value{VERSION}. To help you decide which version you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223 have, see @ref{Getting Started}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 @findex help-with-tutorial
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226 @kindex C-h t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228 If you don't already use GNU Emacs but want to learn more, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229 read an online tutorial by starting GNU Emacs and typing @kbd{C-h t}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 (@code{help-with-tutorial}). (To learn about this notation, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231 @ref{Conventions}.) If you want to take the plunge, consult the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232 @iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233 @cite{GNU Emacs Manual},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 @end iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236 @ref{top, , GNU Emacs Manual, emacs, GNU Emacs Manual},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239 @uref{http://www.gnu.org/software/emacs/manual/html_node/,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240 @cite{GNU Emacs Manual}},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 from the Free Software Foundation.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244 If more information is needed, you can go to the Unix manual pages of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 the individual MH commands. When the name is not obvious, I'll guide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 you to a relevant MH manual page that describes the action more fully.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248 @cindex @cite{MH & nmh: Email for Users & Programmers}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249 @cindex MH book
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 @cindex info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251 @kindex C-h i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 This manual is available in both Info and online formats. The Info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 version is distributed with Emacs and can be accessed with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
255 @command{info} command (@samp{info mh-e}) or within Emacs (@kbd{C-h i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256 m mh-e @key{RET}}). The online version is available at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257 @uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258 online resource is the book @uref{http://www.ics.uci.edu/~mh/book/,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 @cite{MH & nmh: Email for Users & Programmers}} (also known as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 @dfn{the MH book}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 I hope you enjoy this manual! If you have any comments, or suggestions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 for this document, please let me know.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265 @cindex Bill Wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266 @cindex Wohler, Bill
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268 @noindent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
269 Bill Wohler <@i{wohler at newt.com}>@*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
270 8 February 1995@*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
271 24 February 2006
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 @node Conventions, Getting Started, Preface, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 @chapter GNU Emacs Terms and Conventions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276 @cindex Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277 @cindex Emacs, conventions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278 @cindex Emacs, terms
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279 @cindex Unix commands, Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 @cindex conventions, Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 @cindex terms, Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283 If you're an experienced Emacs user, you can skip the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 conventions and definition of terms and go directly to the next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285 section (@pxref{Getting Started}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
287 @cindex Emacs commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
288 @cindex MH commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
289 @cindex Unix commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
290 @cindex commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
291 @cindex commands, MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
292 @cindex commands, Unix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
293 @cindex commands, shell
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
294 @cindex functions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
295 @cindex shell commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
296
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
297 In general, @dfn{functions} in this text refer to Emacs Lisp functions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
298 that one would call from within Emacs Lisp programs (for example,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
299 @code{(mh-inc-folder)}). On the other hand, @dfn{commands} are those
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
300 things that are run by the user, such as @kbd{i} or @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
301 mh-inc-folder}. Programs outside of Emacs are specifically called MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
302 commands, shell commands, or Unix commands.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
303
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
304 @cindex conventions, key names
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
305 @cindex key names
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
307 The conventions for key names are as follows:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
308
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
309 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
310 @item C-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
311 Hold down the @key{CTRL} (Control) key and press the @kbd{x} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
312 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
313 @item M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
314 Hold down the @key{META} or @key{ALT} key and press the @kbd{x} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
315
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
316 Since some keyboards don't have a @key{META} key, you can generate
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
317 @kbd{M-x}, for example, by pressing @key{ESC} (Escape),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
318 @emph{releasing it}, and then pressing the @kbd{x} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
319 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
320 @item @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
321 Press the @key{RETURN} or @key{ENTER} key. This is normally used to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
322 complete a command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
323 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
324 @item @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
325 Press the space bar.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
326 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
327 @item @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
328 Press the @key{TAB} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
329 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
330 @item @key{DEL}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
331 Press the @key{DELETE} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
332 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
333 @item @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
334 Press the @key{BACKSPACE} key@footnote{If you are using Version 20 or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
335 earlier of Emacs, you will need to use the @key{DEL} key.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
336 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
337
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
338 @cindex Emacs, prefix argument
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
339 @cindex prefix argument
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
340 @kindex C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
341
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
342 A @dfn{prefix argument} allows you to pass an argument to any Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
343 function. To pass an argument, type @kbd{C-u} before the Emacs command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
344 or keystroke. Numeric arguments can be passed as well. For example, to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
345 insert five f's, use @kbd{C-u 5 f}. There is a default of four when
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
346 using @kbd{C-u}, and you can use multiple prefix arguments to provide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
347 arguments of powers of four. To continue our example, you could insert
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
348 four f's with @kbd{C-u f}, 16 f's with @kbd{C-u C-u f}, 64 f's with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
349 @kbd{C-u C-u C-u f}, and so on. Numeric and valueless negative
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
350 arguments can also be inserted with the @key{META} key. Examples
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
351 include @kbd{M-5} to specify an argument of 5, or @kbd{M--} which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
352 specifies a negative argument with no particular value.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
353
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
354 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
355 @center @strong{NOTE}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
356
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
357 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
358 The prefix @kbd{C-u} or @kbd{M-} is not necessary in MH-E's MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
359 mode (@pxref{Reading Mail Tour}). In this mode, simply enter the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
360 numerical argument before entering the command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
361 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
362 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
363
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
364 @cindex @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
365 @cindex Emacs, variables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
366 @cindex files, @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
367 @cindex variables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
368 @findex setq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
369
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
370 Emacs uses @dfn{variables} to hold values. These can be changed via
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
371 calls to the function @code{setq} in @file{~/.emacs}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
372
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
373 @cindex Emacs, options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
374 @cindex options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
375 @findex customize-group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
376 @findex customize-option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
377
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
378 Variables in MH-E that are normally modified by the user are called
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
379 @dfn{options} and are modified through the customize functions (such
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
380 as @kbd{M-x customize-option} or @kbd{M-x customize-group}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
381 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
382 @xref{Easy Customization,,,emacs,The GNU Emacs Manual}, in @cite{The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
383 GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
384 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
385 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
386 See section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
387 @uref{http://www.gnu.org/software/emacs/manual/html_node/Easy-Customization.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
388 Easy Customization} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
389 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
390 @xref{Options}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
391
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
392 @cindex Emacs, faces
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
393 @cindex faces
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
394 @cindex highlighting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
395 @findex customize-face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
396
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
397 You can specify various styles for displaying text using @dfn{faces}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
398 MH-E provides a set of faces that you can use to personalize the look
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
399 of your MH-E buffers. Use the command @kbd{M-x customize-face} to do
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
400 this.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
401 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
402 @xref{Face Customization,,,emacs,The GNU Emacs Manual}, in @cite{The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
403 GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
404 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
405 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
406 See section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
407 @uref{http://www.gnu.org/software/emacs/manual/html_node/Face-Customization.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
408 Face Customization} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
409 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
410
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
411 @cindex abnormal hooks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
412 @cindex hooks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
413 @cindex normal hooks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
414 @findex add-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
415 @findex customize-option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
416
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
417 Commands often offer @dfn{hooks} which enable you to extend or modify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
418 the way a command works.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
419 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
420 @ref{Hooks, , Hooks, emacs, The GNU Emacs Manual}, in @cite{The GNU
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
421 Emacs Manual}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
422 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
423 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
424 See section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
425 @uref{http://www.gnu.org/software/emacs/manual/html_node/Hooks.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
426 Hooks} in @cite{The GNU Emacs Manual}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
427 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
428 for a description about @dfn{normal hooks} and @dfn{abnormal hooks}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
429 MH-E uses normal hooks in nearly all cases, so you can assume that we
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
430 are talking about normal hooks unless we explicitly mention that a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
431 hook is abnormal. We also follow the conventions described in that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
432 section: the name of the abnormal hooks end in @code{-hooks} and all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
433 the rest of the MH-E hooks end in @code{-hook}. You can add hooks with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
434 either @code{customize-option} or @code{add-hook}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
435
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
436 @cindex Emacs, mark
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
437 @cindex Emacs, point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
438 @cindex Emacs, region
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
439 @cindex mark
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
440 @cindex point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
441 @cindex region
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
442 @kindex C-@@
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
443 @kindex C-@key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
444
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
445 There are several other terms that are used in Emacs that you should
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
446 know. The @dfn{point} is where the cursor currently is. You can save
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
447 your current place in the file by setting a @dfn{mark}. This operation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
448 is useful in several ways. The mark can be later used when defining a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
449 @dfn{region}, which is the text between the point and mark. Many
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
450 commands operate on regions, such as those for deleting text or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
451 filling paragraphs. A mark can be set with @kbd{C-@@} (or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
452 @kbd{C-@key{SPC}}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
453
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
454 @cindex completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
455 @cindex Emacs, completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
456 @cindex Emacs, file completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
457 @cindex Emacs, folder completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
458 @cindex Emacs, minibuffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
459 @cindex file completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
460 @cindex folder completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
461 @cindex minibuffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
462 @kindex SPC
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
463 @kindex TAB
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
464
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
465 The @dfn{minibuffer} is the bottom line of the Emacs window, where all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
466 prompting and multiple-character input is directed. You can use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
467 @dfn{completion} to enter values such as folders. Completion means
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
468 that Emacs fills in text for you when you type @key{SPC} or @key{TAB}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
469 A second @key{SPC} or @key{TAB} will list all possibilities at that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
470 point.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
471 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
472 @xref{Completion, , Completion, emacs, The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
473 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
474 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
475 See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
476 @uref{http://www.gnu.org/software/emacs/manual/html_node/Completion.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
477 Completion} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
478 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
479 Note that @key{SPC} cannot be used for completing filenames and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
480 folders.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
481
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
482 @findex help-with-tutorial
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
483 @kindex C-h t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
484 @kindex M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
485
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
486 The minibuffer is also where you enter Emacs function names after
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
487 typing @kbd{M-x}. For example, in the preface, I mentioned that you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
488 could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
489 this means is that you can get a tutorial by typing either @kbd{C-h t}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
490 or @kbd{M-x help-with-tutorial}. In the latter case, you are prompted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
491 for @samp{help-with-tutorial} in the minibuffer after typing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
492 @kbd{M-x}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
493
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
494 @cindex ~
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
495
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
496 The @samp{~} notation in filenames represents your home directory.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
497 This notation is used by many shells including @command{bash},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
498 @code{tcsh}, and @command{csh}. It is analogous to the environment
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
499 variable @samp{$HOME}. For example, @file{~/.emacs} can be written
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
500 @file{$HOME/.emacs} or using the absolute path as in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
501 @file{/home/wohler/.emacs} instead.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
502
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
503 @cindex Emacs, interrupting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
504 @cindex Emacs, quitting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
505 @cindex interrupting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
506 @cindex quitting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
507
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
508 @i{In case of trouble:} Emacs can be interrupted at any time with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
509 @kbd{C-g}. For example, if you've started a command that requests that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
510 you enter something in the minibuffer, but then you change your mind,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
511 type @kbd{C-g} and you'll be back where you started. If you want to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
512 exit Emacs entirely, use @kbd{C-x C-c}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
513
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
514 @node Getting Started, Tour Through MH-E, Conventions, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
515 @chapter Getting Started
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
516
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
517 @cindex MH-E, versions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
518 @cindex history
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
519 @cindex versions of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
520
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
521 Because there are many old versions of MH-E out there, it is important
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
522 to know which version you have. I'll be talking about @w{Version 8}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
523 which is pretty close to @w{Version 6} and @w{Version 7}. It differs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
524 from @w{Version 4} and @w{Version 5} and is vastly different from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
525 @w{Version 3}. @xref{History}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
526
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
527 @findex mh-version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
528
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
529 To determine which version of MH-E that you have, enter @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
530 mh-version @key{RET}}. Hopefully it says that you're running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
531 @w{Version @value{VERSION}} which is the latest version as of this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
532 printing.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
533
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
534 If your version is much older than this, please consider upgrading.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
535 You can have your system administrator upgrade the system-wide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
536 version, or you can install your own personal version. It's really
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
537 quite easy. @xref{Getting MH-E}, for instructions for getting and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
538 installing MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
539
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
540 If the @code{mh-version} command displays @samp{No MH variant
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
541 detected}@footnote{In very old versions of MH-E, you may get the error
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
542 message, @samp{Cannot find the commands `inc' and `mhl' and the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
543 `components'} if MH-E can't find MH. In this case, you need to update
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
544 MH-E, and you may need to install MH too. However, newer versions of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
545 MH-E are better at finding MH if it is on your system.}, then you need
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
546 to install MH or tell MH-E where to find MH.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
547
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
548 @cindex Debian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
549 @cindex nmh
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
550 @cindex GNU mailutils MH
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
551
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
552 If you don't have MH on your system already, you must install a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
553 variant of MH. The Debian mh-e package does this for you automatically
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
554 (@pxref{Getting MH-E}). Most people use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
555 @uref{http://www.nongnu.org/nmh/, nmh}, but you may be interested in
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
556 trying out @uref{http://www.gnu.org/software/mailutils/, GNU mailutils
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
557 MH}, which supports IMAP. Your GNU/Linux distribution probably has
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
558 packages for both of these.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
559
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
560 @cindex @command{install-mh}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
561 @cindex MH commands, @command{install-mh}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
562 @cindex MH book
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
563
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
564 If you've never run MH before, you need to run @command{install-mh}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
565 from the shell before you continue. This sets up your personal MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
566 environment@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
567 @uref{@value{MH-BOOK-HOME}/../overall/setup.html, Setting Up MH} in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
568 MH book.}. If you don't, you'll be greeted with the error message:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
569 @samp{Install MH and run install-mh before running MH-E}. This is all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
570 you need to know about MH to use MH-E, but the more you know about MH,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
571 the more you can leverage its power. See the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
572 @uref{@value{MH-BOOK-HOME}/../, MH book} to learn more about MH.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
573
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
574 @cindex @samp{Path:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
575 @cindex MH profile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
576 @cindex MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
577 @cindex MH profile component, @samp{Path:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
578
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
579 Your MH environment includes your @dfn{MH profile} which is found in
101402
c542410b5bda (Getting Started): Describe $MH.
Stephen Eglen <stephen@gnu.org>
parents: 100842
diff changeset
580 the file @file{~/.mh_profile}, or the file named in the environment
c542410b5bda (Getting Started): Describe $MH.
Stephen Eglen <stephen@gnu.org>
parents: 100842
diff changeset
581 variable @samp{$MH}. This file contains a number of @dfn{MH
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
582 profile components}. For example, the @samp{Path:} MH profile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
583 component contains the path to your mail directory, which is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
584 @file{~/Mail} by default.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
585
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
586 @cindex @command{mhparam}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
587 @cindex MH commands, @command{mhparam}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
588 @vindex exec-path
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
589 @vindex mh-path
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
590 @vindex mh-sys-path
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
591 @vindex mh-variant
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
592 @vindex mh-variant-in-use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
593
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
594 There are several options MH-E uses to interact with your MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
595 installation. The option @code{mh-variant} specifies the variant used
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
596 by MH-E (@pxref{Options}). The default setting of this option is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
597 @samp{Auto-detect} which means that MH-E will automatically choose the
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
598 first of nmh, MH, or GNU mailutils MH that it finds in the directories
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
599 listed in @code{mh-path} (which you can customize),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
600 @code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
601 all, you may have to customize @code{mh-path} and add the directory in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
602 which the command @command{mhparam} is located. If, on the other hand,
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
603 you have both nmh and GNU mailutils MH installed (for example) and
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
604 @code{mh-variant-in-use} was initialized to nmh but you want to use
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
605 GNU mailutils MH, then you can set @code{mh-variant} to
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
606 @samp{gnu-mh}.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
607
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
608 @vindex mh-flists-present-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
609 @vindex mh-lib
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
610 @vindex mh-lib-progs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
611 @vindex mh-progs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
612
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
613 When @code{mh-variant} is changed, MH-E resets @code{mh-progs},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
614 @code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
615 @code{mh-variant-in-use} accordingly.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
616
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
617 @cindex @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
618 @cindex files, @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
619
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
620 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
621 @center @strong{NOTE}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
622
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
623 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
624 Prior to version 8, it was often necessary to set some of these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
625 variables in @file{~/.emacs}; now it is no longer necessary and can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
626 actually cause problems.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
627 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
628 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
629
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
630 @cindex MH profile component, @samp{Draft-Folder:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
631 @cindex MH profile component, @samp{Path:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
632 @cindex MH profile component, @samp{Previous-Sequence:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
633 @cindex MH profile component, @samp{Unseen-Sequence:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
634 @cindex @samp{Draft-Folder:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
635 @cindex @samp{Path:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
636 @cindex @samp{Previous-Sequence:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
637 @cindex @samp{Unseen-Sequence:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
638 @findex mh-find-path
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
639 @vindex mh-draft-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
640 @vindex mh-find-path-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
641 @vindex mh-inbox
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
642 @vindex mh-previous-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
643 @vindex mh-unseen-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
644 @vindex mh-user-path
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
645
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
646 In addition to setting variables that point to MH itself, MH-E also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
647 sets a handful of variables that point to where you keep your mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
648 During initialization, the function @code{mh-find-path} sets
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
649 @code{mh-user-path} from your @samp{Path:} MH profile component (but
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
650 defaults to @samp{Mail} if one isn't present), @code{mh-draft-folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
651 from @samp{Draft-Folder:}, @code{mh-unseen-seq} from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
652 @samp{Unseen-Sequence:}, @code{mh-previous-seq} from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
653 @samp{Previous-Sequence:}, and @code{mh-inbox} from @samp{Inbox:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
654 (defaults to @samp{+inbox}). The hook @code{mh-find-path-hook} is run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
655 after these variables have been set. This hook can be used the change
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
656 the value of these variables if you need to run with different values
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
657 between MH and MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
658
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
659 @node Tour Through MH-E, Using This Manual, Getting Started, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
660 @chapter Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
661
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
662 @cindex introduction
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
663 @cindex tour
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
664 @cindex tutorial
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
666 This chapter introduces some of the terms you'll need to know and then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
667 takes you on a tour of MH-E@footnote{The keys mentioned in these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
668 chapters refer to the default key bindings. If you've changed the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
669 bindings, refer to the command summaries at the beginning of each
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
670 chapter for a mapping between default key bindings and function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
671 names.}. When you're done, you'll be able to send, read, and file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
672 mail, which is all that a lot of people ever do. But if you're the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
673 curious or adventurous type, read the rest of the manual to be able to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
674 use all the features of MH-E. I suggest you read this chapter first to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
675 get the big picture, and then you can read the manual as you wish.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
676
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
677 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
678 * Sending Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
679 * Reading Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
680 * Processing Mail Tour::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
681 * Leaving MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
682 * More About MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
683 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
684
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
685 @node Sending Mail Tour, Reading Mail Tour, Tour Through MH-E, Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
686 @section Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
687
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
688 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
689 @cindex mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
690 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
691 @cindex sending mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
692 @findex mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
693 @kindex M-x mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
694
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
695 Let's start our tour by sending ourselves a message which we can later
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
696 read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
697 to send messages. Your message appears in an Emacs buffer whose
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
698 mode@footnote{A @dfn{mode} changes Emacs to make it easier to edit a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
699 particular type of text.} is MH-Letter.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
700
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
701 Enter your login name in the @samp{To:} header field. Press the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
702 @key{TAB} twice to move the cursor past the @samp{Cc:} field, since no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
703 carbon copies are to be sent, and on to the @samp{Subject:} field.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
704 Enter @kbd{Test} or anything else that comes to mind.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
705
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
706 Press @key{TAB} again to move the cursor to the body of the message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
707 Enter some text, using normal Emacs commands. You should now have
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
708 something like this@footnote{If you're running Emacs under the X
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
709 Window System, then you would also see a menu bar and a tool bar. I've
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
710 left out the menu bar and tool bar in all of the example screens.}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
711
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
712 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
713 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
714
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
715
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
716
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
717
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
718
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
719
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
720 --:-- *scratch* All L1 (Lisp Interaction)-------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
721 To: wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
722 cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
723 Subject: Test
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
724 X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
725 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
726 This is a test message to get the wheels churning...#
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
727
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
728
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
729 --:** @{draft@} All L5 (MH-Letter)----------------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
730 Type C-c C-c to send message, C-C ? for help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
731 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
732 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
733 @i{MH-E message composition window}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
734
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
735 Note the line of dashes that separates the header and the body of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
736 message. It is essential that these dashes (or a blank line) are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
737 present or the body of your message will be considered to be part of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
738 the header.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
739
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
740 @cindex help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
741 @findex describe-mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
742 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
743 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
744 @kindex C-h m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
745
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
746 There are several commands specific to MH-Letter mode@footnote{You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
747 get quick help for the commands used most often with @kbd{C-c ?} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
748 more complete help with the @kbd{C-h m} (@code{describe-mode})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
749 command.}, but at this time we'll only use @kbd{C-c C-c} to send your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
750 message. Type @kbd{C-c C-c} now. That's all there is to it!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
751
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
752 @node Reading Mail Tour, Processing Mail Tour, Sending Mail Tour, Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
753 @section Receiving Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
754
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
755 @cindex @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
756 @cindex @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
757 @cindex MH commands, @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
758 @cindex MH commands, @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
759 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
760 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
761 @cindex reading mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
762 @findex mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
763 @kindex M-x mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
764
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
765 To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
766 This incorporates the new mail and puts the output from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
767 @command{inc}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
768 @uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
769 prev} in the MH book.} (called @dfn{scan lines} after the MH program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
770 @command{scan}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
771 @uref{@value{MH-BOOK-HOME}/faswsprs.html, Find and Specify with scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
772 pick Ranges Sequences} in the MH book.} which prints a one-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
773 summary of each message) into a buffer called @samp{+inbox} whose
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
774 major mode is MH-Folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
775
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
776 @findex mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
777 @kindex F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
778 @kindex M-x mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
779
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
780 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
781 @center @strong{NOTE}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
782
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
783 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
784
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
785 The @kbd{M-x mh-rmail} command will show you only new mail, not mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
786 you have already read. If you were to run this tour again, you would
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
787 use @kbd{F r} to pull all your messages into MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
788 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
789 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
790
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
791 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
792 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
793 @kindex p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
794
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
795 You should see the scan line for your message, and perhaps others. Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
796 @kbd{n} or @kbd{p} to move the cursor to your test message and type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
797 @key{RET} to read your message. You should see something like:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
798
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
799 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
800 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
801 3 t08/24 root received fax files on Wed Aug 24 11:00:13 PDT 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
802 # 4+t08/24 To:wohler Test<<This is a test message to get the wheels
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
803
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
804 -:%% @{+inbox/select@} 4 msgs (1-4) Bot L4 (MH-Folder Show)---------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
805 To: wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
806 Subject: Test
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
807 X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
808 Date: Fri, 17 Mar 2006 10:49:11 -0800
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
809 From: Bill Wohler <wohler@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
810
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
811 This is a test message to get the wheels churning...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
812
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
813
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
814
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
815 --:-- @{show-+inbox@} 4 All L1 (MH-Show)----------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
816
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
817 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
818 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
819 @i{After incorporating new messages}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
820
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
821 @kindex @key{DEL}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
822 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
823
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
824 If you typed a long message, you can view subsequent pages with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
825 @key{SPC} and previous pages with @key{DEL}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
826
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
827 @node Processing Mail Tour, Leaving MH-E, Reading Mail Tour, Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
828 @section Processing Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
829
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
830 @cindex processing mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
831 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
832 @kindex r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
833
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
834 The first thing we want to do is reply to the message that we sent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
835 ourselves. Ensure that the cursor is still on the same line as your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
836 test message and type @kbd{r}. You are prompted in the minibuffer with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
837 @samp{Reply to whom:}. Here MH-E is asking whether you'd like to reply
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
838 to the original sender only, to the sender and primary recipients, or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
839 to the sender and all recipients. You can press @key{TAB} to see these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
840 choices. If you simply press @key{RET}, you'll reply only to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
841 sender. Press @key{RET} now.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
842
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
843 You'll find yourself in an Emacs buffer similar to that when you were
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
844 sending the original message, like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
845
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
846 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
847 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
848 To:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
849 cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
850 Subject: Re: Test
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
851 In-reply-to: <31054.1142621351@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
852 References: <31054.1142621351@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
853 Comments: In-reply-to Bill Wohler <wohler@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
854 message dated "Fri, 17 Mar 2006 10:49:11 -0800."
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
855 X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
856 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
857 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
858
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
859 --:-- @{draft@} All L10 (MH-Letter)----------------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
860 To: wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
861 Subject: Test
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
862 X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
863 Date: Fri, 17 Mar 2006 10:49:11 -0800
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
864 From: Bill Wohler <wohler@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
865
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
866 This is a test message to get the wheels churning...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
867
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
868 --:-- @{show-+inbox@} 4 All L1 (MH-Show)----------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
869 Type C-c C-c to send message, C-c ? for help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
870 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
871 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
872 @i{Composition window during reply}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
873
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
874 @findex backward-char
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
875 @findex forward-char
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
876 @findex next-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
877 @findex previous-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
878 @kindex C-b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
879 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
880 @kindex C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
881 @kindex C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
882 @kindex C-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
883 @kindex C-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
884 @kindex @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
885
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
886 By default, MH will not add you to the address list of your replies,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
887 so if you find that the @samp{To:} header field is missing, don't
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
888 worry. In this case, type @kbd{C-c C-f C-t} to create and go to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
889 @samp{To:} field, where you can type your login name again. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
890 move around with the arrow keys or with @kbd{C-p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
891 (@code{previous-line}), @kbd{C-n} (@code{next-line}), @kbd{C-b}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
892 (@code{backward-char}), and @kbd{C-f} (@code{forward-char}) and can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
893 delete the previous character with @key{BS}. When you're finished
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
894 editing your message, send it with @kbd{C-c C-c} as before.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
895
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
896 @cindex @command{refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
897 @cindex MH commands, @command{refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
898 @cindex folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
899 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
900 @kindex o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
901
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
902 You'll often want to save messages that were sent to you in an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
903 organized fashion. This is done with @dfn{folders}. You can use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
904 folders to keep messages from your friends, or messages related to a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
905 particular topic. With your cursor in the MH-Folder buffer and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
906 positioned on the message you sent to yourself, type @kbd{o} to output
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
907 (@command{refile} in MH parlance) that message to a folder. Enter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
908 @kbd{test} at the @samp{Destination folder:} prompt and type @kbd{y}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
909 (or @key{SPC}) when MH-E asks to create the folder @samp{+test}. Note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
910 that a @samp{^} (caret) appears next to the message number, which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
911 means that the message has been marked for refiling but has not yet
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
912 been refiled. We'll talk about how the refile is actually carried out
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
913 in a moment.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
914
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
915 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
916 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
917 @kindex d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
918 @kindex i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
919 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
920 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
921 @kindex p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
922 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
923
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
924 Your previous reply is now waiting in the system mailbox. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
925 incorporate this mail into your MH-Folder buffer named @samp{+inbox}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
926 with the @kbd{i} command. Do this now. After the mail is incorporated,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
927 use @kbd{n} or @kbd{p} to move the cursor to the new message, and read
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
928 it with @key{RET}. Let's delete this message by typing @kbd{d}. Note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
929 that a @samp{D} appears next to the message number. This means that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
930 the message is marked for deletion but is not yet deleted. To perform
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
931 the deletion (and the refile we did previously), use the @kbd{x}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
932 command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
933
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
934 @findex mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
935 @kindex m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
936 @kindex M-x mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
937
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
938 If you want to send another message you can use @kbd{m} instead of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
939 @kbd{M-x mh-smail}. So go ahead, send some mail to your friends!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
940
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
941 @cindex help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
942 @cindex prefix characters
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
943 @findex describe-mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
944 @kindex ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
945 @kindex C-h m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
946 @kindex F ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
947
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
948 You can get a quick reminder about these commands by typing @kbd{?}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
949 This lists several @dfn{prefix characters}. To list the commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
950 available via the prefix characters, type the prefix character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
951 followed by a @kbd{?}, for example, @kbd{F ?}. More complete help is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
952 available with the @kbd{C-h m} (@code{describe-mode}) command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
953
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
954 @node Leaving MH-E, More About MH-E, Processing Mail Tour, Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
955 @section Leaving MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
956
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
957 @cindex Emacs, quitting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
958 @cindex quitting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
959 @kindex C-x C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
960 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
961
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
962 You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
963 to exit @command{emacs}. If you exited without running @kbd{x} in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
964 @samp{+inbox} buffer, Emacs will offer to save it for you. Type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
965 @kbd{y} or @key{SPC} to save @samp{+inbox} changes, which means to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
966 perform any refiles and deletes that you did there.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
967
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
968 @findex mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
969 @kindex C-x b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
970 @kindex C-x k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
971 @kindex M-x mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
972 @kindex q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
973
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
974 If you don't want to leave Emacs, you can type @kbd{q} to bury (hide)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
975 the MH-E folder or delete it entirely with @kbd{C-x k}. You can then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
976 later recall it with @kbd{C-x b} or @kbd{M-x mh-rmail}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
977
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
978 @cindex @command{packf}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
979 @cindex MH commands, @command{packf}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
980 @cindex exporting folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
981 @cindex folders, exporting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
982 @cindex mbox-style folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
983
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
984 On the other hand, if you no longer want to use MH and MH-E, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
985 take your mail with you. You can copy all of your mail into a single
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
986 file, mbox-style, by using the MH command @command{packf}. For
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
987 example, to create a file called @file{msgbox} with the messages in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
988 your @samp{+inbox} folder, use @samp{packf +inbox}. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
989 @command{packf} command will append the messages to the file if it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
990 already exists, so you can use @samp{folders -recurse -fast} in a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
991 script to copy all of your messages into a single file, or using the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
992 @samp{-file} argument, a file for each folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
993
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
994 @node More About MH-E, , Leaving MH-E, Tour Through MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
995 @section More About MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
996
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
997 These are the basic commands to get you going, but there are plenty
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
998 more. If you think that MH-E is for you, read the rest of the manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
999 to find out how you can:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1000
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1001 @itemize @bullet
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1002 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1003 Print your messages (@pxref{Printing}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1004 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1005 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1006 Edit messages and include your signature (@pxref{Editing Drafts}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1007 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1008 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1009 Forward messages (@pxref{Forwarding}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1010 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1011 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1012 Read digests (@pxref{Digests}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1013 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1014 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1015 Edit bounced messages (@pxref{Editing Again}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1016 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1017 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1018 Send multimedia messages (@pxref{Adding Attachments}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1019 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1020 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1021 Read HTML messages (@pxref{HTML}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1022 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1023 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1024 Use aliases and identities (see @ref{Aliases}, @pxref{Identities}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1025 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1026 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1027 Create different views of your mail (see @ref{Threading}, @pxref{Limits}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1028 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1029 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1030 Deal with junk mail (@pxref{Junk}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1031 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1032 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1033 Handle signed and encrypted messages (see @ref{Reading PGP},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1034 @pxref{Sending PGP}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1035 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1036 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1037 Process mail that was sent with @command{shar} or @command{uuencode}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1038 (@pxref{Files and Pipes}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1039 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1040 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1041 Use sequences conveniently (@pxref{Sequences}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1042 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1043 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1044 Use the speedbar, tool bar, and menu bar (see @ref{Speedbar}, see @ref{Tool
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1045 Bar}, @pxref{Menu Bar}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1046 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1047 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1048 Show header fields in different fonts (@pxref{Reading Mail}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1049 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1050 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1051 Find previously refiled messages (@pxref{Searching}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1052 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1053 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1054 Place messages in a file (@pxref{Files and Pipes}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1055 @end itemize
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1056
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1057 Remember that you can also use MH commands when you're not running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1058 MH-E (and when you are!).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1059
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1060 @node Using This Manual, Incorporating Mail, Tour Through MH-E, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1061 @chapter Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1062
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1063 This chapter begins the meat of the manual which goes into more detail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1064 about every MH-E command and option.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1065
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1066 @cindex Emacs, info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1067 @cindex Emacs, online help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1068 @cindex info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1069 @cindex online help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1070 @findex describe-mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1071 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1072 @kindex ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1073 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1074 @kindex C-h C-h
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1075 @kindex C-h C-k i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1076 @kindex C-h i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1077 @kindex C-h m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1078
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1079 There are many commands, but don't get intimidated. There are command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1080 summaries at the beginning of each chapter. In case you have or would
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1081 like to rebind the keys, the command summaries also list the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1082 associated Emacs Lisp function. Furthermore, even if you're stranded
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1083 on a desert island with a laptop and are without your manuals, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1084 get a summary of all these commands with GNU Emacs online help: use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1085 @kbd{C-h m} (@code{describe-mode}) for a brief summary of commands,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1086 @kbd{?} (@code{mh-help}) for an even briefer summary@footnote{This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1087 help appears in a buffer called @samp{*MH-E Help*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1088 (@pxref{Miscellaneous}).} (@kbd{C-c ?} in MH-Letter mode), or @kbd{C-h
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1089 i} to read this manual via Info. The online help is quite good; try
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1090 running @kbd{C-h C-h}. This brings up a list of available help topics,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1091 one of which displays the documentation for a given key (like @kbd{C-h
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1092 k C-n}). Another useful help feature is to view the manual section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1093 that describes a given key (such as @kbd{C-h K i}). In addition,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1094 review @ref{Conventions}, if any of the GNU Emacs conventions are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1095 strange to you.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1096
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1097 In addition to all of the commands, it is also possible to reconfigure
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1098 MH-E to fit the needs of even the most demanding user. The following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1099 chapters also describe all of the options, show the defaults, and make
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1100 recommendations for customization.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1101
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1102 However, when customizing your mail environment, first try to change
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1103 what you want in MH, and only change MH-E if changing MH is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1104 possible. That way you will get the same behavior inside and outside
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1105 GNU Emacs. Note that MH-E does not provide hooks for customizations
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1106 that can be done in MH; this omission is intentional.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1107
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1108 @cindex Emacs Lisp Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1109 @cindex Emacs, Emacs Lisp Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1110 @cindex Emacs, info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1111 @cindex Emacs, online help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1112 @cindex info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1113 @cindex online help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1114
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1115 I hope I've included enough examples here to get you well on your way.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1116 If you want to explore Emacs Lisp further, a programming manual does
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1117 exist,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1118 @c Yes, some of the stuff in the following sections is redundant, but
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1119 @c TeX barfs if the @ifs are inside the @footnote.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1120 @iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1121 @footnote{The @cite{GNU Emacs Lisp Reference Manual} may be available
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1122 online in the Info system by typing @kbd{C-h i m Emacs Lisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1123 @key{RET}}. It is also available online at @*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1124 @uref{http://www.gnu.org/software/emacs/elisp-manual/html_node/}. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1125 can also order a printed manual, which has the desirable side-effect
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1126 of helping to support the Free Software Foundation which made all this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1127 great software available. You can find an order form by running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1128 @kbd{C-h C-d}, or you can request an order form from @i{gnu at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1129 gnu.org}.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1130 @end iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1131 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1132 @footnote{@xref{Top, The GNU Emacs Lisp Reference Manual, , elisp, GNU
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1133 Emacs Lisp Reference Manual}, which may be available online in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1134 Info system. It is also available online at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1135 @uref{http://www.gnu.org/software/emacs/elisp-manual/html_node/}. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1136 can also order a printed manual, which has the desirable side-effect
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1137 of helping to support the Free Software Foundation which made all this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1138 great software available. You can find an order form by running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1139 @kbd{C-h C-d}, or you can request an order form from @i{gnu at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1140 gnu.org}.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1141 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1142 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1143 @footnote{The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1144 @uref{http://www.gnu.org/software/emacs/elisp-manual/html_node/,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1145 The GNU Emacs Lisp Reference Manual} may also be available online in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1146 the Info system by typing @kbd{C-h i m Emacs Lisp @key{RET}}. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1147 also order a printed manual, which has the desirable side-effect of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1148 helping to support the Free Software Foundation which made all this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1149 great software available. You can find an order form by running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1150 @kbd{C-h C-d}, or you can request an order form from @i{gnu at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1151 gnu.org}.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1152 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1153 and you can look at the code itself for examples. Look in the Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1154 Lisp directory on your system (such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1155 @file{/usr/local/lib/emacs/lisp/mh-e}) and find all the @file{mh-*.el}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1156 files there. When calling MH-E and other Emacs Lisp functions directly
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1157 from Emacs Lisp code, you'll need to know the correct arguments. Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1158 the online help for this. For example, try @kbd{C-h f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1159 mh-execute-commands @key{RET}}. If you write your own functions,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1160 please do not prefix your symbols (variables and functions) with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1161 @samp{mh-}. This prefix is reserved for the MH-E package. To avoid
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1162 conflicts with existing MH-E symbols, use a prefix like @samp{my-} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1163 your initials. (Unless, of course, your initials happen to be @emph{mh}!)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1164
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1165 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1166 * Options::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1167 * Ranges::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1168 * Folder Selection::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1169 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1170
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1171 @node Options, Ranges, Using This Manual, Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1172 @section Options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1173
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1174 @cindex Emacs, customizing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1175 @cindex Emacs, setting options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1176 @cindex customizing MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1177 @cindex setting options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1178 @findex customize-option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1179 @vindex mh-lpr-command-format, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1180
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1181 Many string or integer options are easy to modify using @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1182 customize-option}. For example, to modify the option that controls
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1183 printing, you would run @kbd{M-x customize-option @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1184 mh-lpr-command-format @key{RET}}. In the buffer that appears, modify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1185 the string to the right of the variable. For example, you may change
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1186 the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1187 use the @samp{State} combo box and select @samp{Save for Future
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1188 Sessions}. To read more about @code{mh-lpr-command-format}, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1189 @ref{Printing}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1190
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1191 @cindex nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1192 @cindex off, option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1193 @cindex on, option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1194 @cindex option, turning on and off
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1195 @cindex t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1196 @findex customize-option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1197 @vindex mh-bury-show-buffer-flag, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1198
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1199 Options can also hold boolean values. In Emacs Lisp, the boolean
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1200 values are @code{nil}, which means false, and @code{t}, which means
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1201 true. The @code{customize-option} function makes it easy to change
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1202 boolean values; simply click on the toggle button in the customize
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1203 buffer to switch between @samp{on} (@code{t}) and @samp{off}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1204 (@code{nil}). For example, try setting @code{mh-bury-show-buffer-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1205 to @samp{off} to keep the MH-Show buffer at the top of the buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1206 stack. Use the @samp{State} combo box and choose @samp{Set for Current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1207 Session} to see how the option affects the show buffer. Then choose
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1208 the @samp{Erase Customization} menu item to reset the option to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1209 default, which places the MH-Show buffer at the bottom of the buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1210 stack.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1211
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1212 @vindex mh-mhl-format-file, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1213
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1214 The text usually says to turn on an option by setting it to a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1215 @emph{non-@code{nil}} value, because sometimes values other than
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1216 @samp{on} are meaningful. An example of this is the variable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1217 @code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1218 hooks, involve a little more Emacs Lisp programming expertise.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1219
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1220 @cindex customization group, @samp{mh}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1221 @cindex @samp{mh} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1222 @findex customize-group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1223 @findex mh-customize
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1224
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1225 You can browse all of the MH-E options with the @code{customize-group}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1226 function. Try entering @kbd{M-x customize-group @key{RET} mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1227 @key{RET}} to view the top-level options as well as buttons for all of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1228 the MH-E customization groups. Another way to view the MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1229 customization group is to use @kbd{M-x mh-customize @key{RET}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1230
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1231 @node Ranges, Folder Selection, Options, Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1232 @section Ranges
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1233
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1234 @c Sync with mh-folder-mode docstring.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1235
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1236 @cindex message abbreviations
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1237 @cindex message ranges
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1238 @cindex ranges
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1239
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1240 Many commands that operate on individual messages, such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1241 @code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1242 argument. This argument can be used in several ways.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1243
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1244 @kindex C-u, with ranges
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1245
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1246 If you provide the prefix argument @kbd{C-u} to these commands, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1247 you will be prompted for the message range. This can be any valid MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1248 range which can include messages, sequences (@pxref{Sequences}), and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1249 the abbreviations (described in the @command{mh}(1) man page):
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1250
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1251 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1252 @item <num1>-<num2>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1253 Indicates all messages in the range <num1> to <num2>, inclusive. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1254 range must be nonempty.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1255 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1256 @item <num>:N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1257 @itemx <num>:+N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1258 @itemx <num>:-N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1259 Up to N messages beginning with (or ending with) message num. Num may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1260 be any of the predefined symbols: first, prev, cur, next or last.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1261 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1262 @item first:N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1263 @itemx prev:N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1264 @itemx next:N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1265 @itemx last:N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1266 The first, previous, next or last messages, if they exist.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1267 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1268 @item all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1269 All of the messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1270 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1271
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1272 For example, a range that shows all of these things is @samp{1 2 3
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1273 5-10 last:5 unseen}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1274
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1275 @vindex transient-mark-mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1276
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1277 If the option @code{transient-mark-mode} is turned on and you set a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1278 region in the MH-Folder buffer, then the MH-E command will perform the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1279 operation on all messages in that region.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1280
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1281 @cindex @samp{mh-range} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1282 @cindex customization group, @samp{mh-range}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1283
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1284 The @samp{mh-range} customization group contains a single option which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1285 affects how ranges are interpreted.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1286
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1287 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1288 @item mh-interpret-number-as-range-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1289 On means interpret a number as a range (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1290 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1291
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1292 @vindex mh-interpret-number-as-range-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1293
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1294 Since one of the most frequent ranges used is @samp{last:N}, MH-E will
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1295 interpret input such as @samp{200} as @samp{last:200} if the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1296 @code{mh-interpret-number-as-range-flag} option is on (which is the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1297 default). If you need to scan just the message 200, then use the range
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1298 @samp{200:1} or @samp{200-200}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1299
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1300 @node Folder Selection, , Ranges, Using This Manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1301 @section Folder Selection
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1302
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1303 @cindex completion, folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1304 @cindex folders, completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1305 @cindex folders, selecting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1307 When you choose a folder in MH-E via a command such as @kbd{o}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1308 (@code{mh-refile-msg}), completion is used to enter the folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1309 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1310 (@pxref{Completion, , , emacs, The GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1311 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1312 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1313 (see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1314 @uref{http://www.gnu.org/software/emacs/manual/html_node/Completion.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1315 Completion} in @cite{The GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1316 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1317 In addition, MH-E has several ways of choosing a suitable default so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1318 that the folder can often be selected with a single @key{RET} key.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1319
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1320 @cindex customization group, @samp{mh-folder-selection}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1321 @cindex @samp{mh-folder-selection} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1322
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1323 The @samp{mh-folder-selection} customization group contains some
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1324 options which are used to help with this.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1325
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1326 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1327 @item mh-default-folder-for-message-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1328 Function to select a default folder for refiling or @samp{Fcc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1329 (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1330 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1331 @item mh-default-folder-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1332 List of addresses and folders (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1333 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1334 @item mh-default-folder-must-exist-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1335 On means guessed folder name must exist to be used (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1336 @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1337 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1338 @item mh-default-folder-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1339 Prefix used for folder names generated from aliases (default: @code{""}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1340 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1341
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1342 @vindex mh-default-folder-for-message-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1343
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1344 You can set the option @code{mh-default-folder-for-message-function}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1345 to a function that provides a default folder for the message to be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1346 refiled. When this function is called, the current buffer contains the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1347 message being refiled and point is at the start of the message. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1348 function should return the default folder as a string with a leading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1349 @samp{+} sign. It can also return @code{nil} so that the last folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1350 name is used as the default, or an empty string to suppress the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1351 default entirely.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1352
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1353 Otherwise, the name of the destination folder is derived from the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1354 sender as follows:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1355
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1356 @enumerate
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1357 @vindex mh-default-folder-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1358 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1359 The folder name associated with the first address found in the list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1360 @code{mh-default-folder-list} is used. Each element in this list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1361 contains a @samp{Check Recipient} item. If this item is turned on,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1362 then the address is checked against the recipient instead of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1363 sender. This is useful for mailing lists.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1364 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1365 @vindex mh-default-folder-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1366 @item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1367 An alias prefixed by @code{mh-default-folder-prefix} corresponding to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1368 the address is used. The prefix is used to prevent clutter in your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1369 mail directory. @xref{Aliases}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1370 @end enumerate
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1371
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1372 @vindex mh-default-folder-must-exist-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1373
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1374 If the derived folder does not exist, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1375 @code{mh-default-folder-must-exist-flag} is @code{t}, then the last
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1376 folder name used is suggested. This is useful if you get mail from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1377 various people for whom you have an alias, but file them all in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1378 same project folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1379
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1380 @node Incorporating Mail, Reading Mail, Using This Manual, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1381 @chapter Incorporating Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1382
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1383 @cindex @samp{Folder} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1384 @cindex incorporating
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1385 @cindex menu, @samp{Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1386
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1387 This chapter talks about getting mail from your system mailbox into
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1388 your MH @samp{+inbox} folder. The following command accomplishes that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1389 and is found in the @samp{Folder} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1390
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1391 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1392 @cindex @samp{Folder > Incorporate New Mail} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1393 @cindex menu item, @samp{Folder > Incorporate New Mail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1394 @findex mh-inc-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1395 @kindex i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1396 @item i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1397 Incorporate new mail into a folder (@code{mh-inc-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1398 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1399
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1400 @cindex @samp{mh-inc} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1401 @cindex customization group, @samp{mh-inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1402
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1403 The following options in the @samp{mh-inc} customization group are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1404 used.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1405
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1406 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1407 @item mh-inc-prog
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1408 Program to incorporate mail (default: @code{"inc"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1409 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1410 @item mh-inc-spool-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1411 Alternate spool files (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1412 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1413
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1414 The following hook is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1415
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1416 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1417 @findex mh-inc-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1418 @item mh-inc-folder-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1419 Hook run by @code{mh-inc-folder} after incorporating mail into a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1420 folder (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1421 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1422
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1423 @cindex @samp{+inbox}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1424 @findex mh-inc-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1425 @kindex i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1426
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1427 If at any time you receive new mail, incorporate the new mail into
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1428 your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1429 that @kbd{i} will display the @samp{+inbox} buffer, even if there
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1430 isn't any new mail. You can incorporate mail from any file into the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1431 current folder by specifying a prefix argument; you'll be prompted for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1432 the name of the file to use as well as the destination folder (for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1433 example, @kbd{C-u i ~/mbox @key{RET} +tmp @key{RET}}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1434
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1435 @cindex @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1436 @cindex Emacs, notification of new mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1437 @cindex files, @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1438 @cindex new mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1439 @cindex notification of new mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1440
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1441 Emacs can notify you when you have new mail by displaying @samp{Mail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1442 in the mode line. To enable this behavior, and to have a clock in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1443 mode line as well, add the following to @file{~/.emacs}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1444
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1445 @findex display-time
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1446
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1447 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1448 (display-time)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1449 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1450
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1451 @cindex @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1452 @cindex incorporating
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1453 @cindex MH commands, @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1454 @vindex mh-inc-prog
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1455 @vindex mh-progs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1456
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1457 The name of the program that incorporates new mail is stored in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1458 @code{mh-inc-prog}; it is @code{"inc"} by default. This program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1459 generates a one-line summary for each of the new messages. Unless it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1460 is an absolute pathname, the file is assumed to be in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1461 @code{mh-progs} directory (@pxref{Getting Started}). You may also link
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1462 a file to @command{inc} that uses a different format (see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1463 @samp{mh-profile}(5), and sections
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1464 @uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1465 prev} and @uref{@value{MH-BOOK-HOME}/mhstr.html, MH Format Strings} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1466 the MH book). You'll then need to modify several variables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1467 appropriately (@pxref{Scan Line Formats}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1468
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1469 @vindex mh-inc-spool-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1470
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1471 You can use the @code{mh-inc-spool-list} variable to direct MH-E to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1472 retrieve mail from arbitrary spool files other than your system
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1473 mailbox, file it in folders other than your @samp{+inbox}, and assign
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1474 key bindings to incorporate this mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1475
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1476 @cindex @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1477 @cindex @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1478 @cindex Unix commands, @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1479 @cindex files, @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1480
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1481 Suppose you are subscribed to the @i{mh-e-devel} mailing list and you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1482 use @command{procmail} to filter this mail into @file{~/mail/mh-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1483 with the following recipe in @file{.procmailrc}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1484
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1485 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1486 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1487 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1488 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1489 * ^From mh-e-devel-admin@@stop.mail-abuse.org
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1490 mh-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1491 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1492
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1493 @findex mh-inc-spool-*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1494 @kindex I *
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1495
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1496 In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1497 @kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1498 and click on the @samp{INS} button. Enter a @samp{Spool File} of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1499 @samp{~/mail/mh-e}, a @samp{Folder} of @samp{mh-e}, and a @samp{Key
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1500 Binding} of @samp{m}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1501
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1502 @cindex @command{emacsclient}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1503 @cindex @command{gnuclient}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1504 @cindex @command{xbuffy}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1505 @cindex @samp{gnuserv}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1506 @cindex Unix commands, @command{emacsclient}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1507 @cindex Unix commands, @command{gnuclient}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1508 @cindex Unix commands, @command{xbuffy}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1509
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1510 You can use @command{xbuffy} to automate the incorporation of this
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
1511 mail using the Emacs 23 command @command{emacsclient} as follows:
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1512
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1513 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1514 box ~/mail/mh-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1515 title mh-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1516 origMode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1517 polltime 10
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1518 headertime 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1519 command emacsclient --eval '(mh-inc-spool-mh-e)'
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1520 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1521
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1522 In XEmacs, the command @command{gnuclient} is used in a similar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1523 fashion.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1524
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1525 @findex mh-inc-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1526 @kindex i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1527 @vindex mh-inc-folder-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1528
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1529 You can set the hook @code{mh-inc-folder-hook}, which is called after
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1530 new mail is incorporated by the @kbd{i} (@code{mh-inc-folder})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1531 command. A good use of this hook is to rescan the whole folder either
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1532 after running @kbd{M-x mh-rmail} the first time or when you've changed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1533 the message numbers from outside of MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1534
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1535 @findex mh-execute-commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1536 @findex mh-rescan-folder, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1537 @findex mh-show, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1538 @vindex mh-inc-folder-hook, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1539
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1540 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1541 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1542 (defun my-mh-inc-folder-hook ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1543 "Hook to rescan folder after incorporating mail."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1544 (if (buffer-modified-p) ; @r{if outstanding refiles and deletes,}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1545 (mh-execute-commands)) ; @r{carry them out}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1546 (mh-rescan-folder) ; @r{synchronize with +inbox}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1547 (mh-show)) ; @r{show the current message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1548
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1549 (add-hook 'mh-inc-folder-hook 'my-mh-inc-folder-hook)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1550
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1551 @i{Rescan folder after incorporating new mail via mh-inc-folder-hook}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1552
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1553 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1554 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1555
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1556 @node Reading Mail, Folders, Incorporating Mail, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1557 @chapter Reading Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1558
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1559 @cindex @samp{+inbox}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1560 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1561 @cindex MH-Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1562 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1563 @cindex modes, MH-Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1564 @cindex reading mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1565 @findex mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1566 @kindex F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1567 @kindex F v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1568 @kindex M-x mh-rmail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1569
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1570 The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1571 command incorporates your mail and creates a buffer called
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1572 @samp{+inbox} in MH-Folder mode. The command @kbd{M-x mh-rmail} shows
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1573 you only new mail, not mail you have already read@footnote{If you want
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1574 to see your old mail as well, use @kbd{F r} to pull all your messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1575 into MH-E. Or, give a prefix argument to @code{mh-rmail} so it will
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1576 prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1577 M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1578
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1579 @findex display-time
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1580 @vindex read-mail-command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1581
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1582 There are some commands that need to read mail, such as @kbd{Mouse-2}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1583 over the @samp{Mail} button that @code{display-time} adds to the mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1584 line. You can configure Emacs to have these commands use MH-E by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1585 setting the option @code{read-mail-command} to @samp{mh-rmail}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1586
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1587 @cindex @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1588 @cindex @samp{Message} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1589 @cindex MH commands, @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1590 @cindex menu, @samp{Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1591 @cindex scan lines
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1592
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1593 The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1594 summaries of each incorporated message. You can perform most MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1595 commands on these messages via one- or two-letter commands in either
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1596 the MH-Folder or MH-Show buffers or by using the @samp{Message} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1597 See @command{scan}(1) for a description of the contents of the scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1598 lines, and see the Figure in @ref{Reading Mail Tour}, for an example.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1599
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1600 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1601 @kindex ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1602 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1603 @item ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1604 Display cheat sheet for the MH-E commands (@code{mh-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1605 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1606 @cindex @samp{Message > Show Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1607 @cindex menu item, @samp{Message > Show Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1608 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1609 @findex mh-show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1610 @item @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1611 Display message (@code{mh-show}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1612 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1613 @cindex @samp{Message > Show Message with Header} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1614 @cindex menu item, @samp{Message > Show Message with Header}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1615 @kindex , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1616 @findex mh-header-display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1617 @item , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1618 Display message with all header fields (@code{mh-header-display}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1619 @c -------------------------
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1620 @cindex @samp{Message > Show Message with Preferred Alternative} menu item
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1621 @cindex menu item, @samp{Message > Show Message with Preferred Alternative}
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1622 @kindex : (colon)
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1623 @findex mh-show-preferred-alternative
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1624 @item : (colon)
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1625 Display message with the default preferred alternative
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1626 (@code{mh-show-preferred-alternative}).
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
1627 @c -------------------------
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1628 @kindex ; (semicolon)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1629 @findex mh-toggle-mh-decode-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1630 @item ; (semicolon)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1631 Toggle the value of @code{mh-decode-mime-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1632 (@code{mh-toggle-mh-decode-mime-flag}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1633 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1634 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1635 @findex mh-page-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1636 @item @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1637 Display next page in message (@code{mh-page-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1638 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1639 @kindex @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1640 @findex mh-previous-page
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1641 @item @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1642 Display previous page in message (@code{mh-previous-page}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1643 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1644 @cindex @samp{Message > Write Message to File...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1645 @cindex menu item, @samp{Message > Write Message to File...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1646 @kindex >
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1647 @findex mh-write-msg-to-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1648 @item >
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1649 Append message to end of file (@code{mh-write-msg-to-file}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1650 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1651 @cindex @samp{Message > Pipe Message to Command...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1652 @cindex menu item, @samp{Message > Pipe Message to Command...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1653 @kindex |
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1654 @findex mh-pipe-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1655 @item |
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1656 Pipe message through shell command (@code{mh-pipe-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1657 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1658 @kindex C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1659 @findex mh-delete-msg-no-motion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1660 @item C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1661 Delete range, don't move to next message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1662 (@code{mh-delete-msg-no-motion}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1663 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1664 @cindex @samp{Message > Delete Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1665 @cindex menu item, @samp{Message > Delete Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1666 @kindex d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1667 @findex mh-delete-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1668 @item d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1669 Delete range (@code{mh-delete-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1670 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1671 @kindex D ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1672 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1673 @item D ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1674 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1675 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1676 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1677 @kindex D @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1678 @findex mh-page-digest
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1679 @item D @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1680 Display next message in digest (@code{mh-page-digest}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1681 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1682 @kindex D @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1683 @findex mh-page-digest-backwards
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1684 @item D @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1685 Display previous message in digest (@code{mh-page-digest-backwards}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1686 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1687 @cindex @samp{Message > Burst Digest Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1688 @cindex menu item, @samp{Message > Burst Digest Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1689 @kindex D b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1690 @findex mh-burst-digest
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1691 @item D b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1692 Break up digest into separate messages (@code{mh-burst-digest}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1693 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1694 @cindex @samp{Message > Go to Message by Number...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1695 @cindex menu item, @samp{Message > Go to Message by Number...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1696 @kindex g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1697 @findex mh-goto-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1698 @item g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1699 Go to a message (@code{mh-goto-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1700 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1701 @kindex k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1702 @findex mh-delete-subject-or-thread
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1703 @item k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1704 Delete messages with same subject or thread
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1705 (@code{mh-delete-subject-or-thread}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1706 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1707 @kindex K ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1708 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1709 @item K ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1710 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1711 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1712 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1713 @kindex K @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1714 @findex mh-next-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1715 @item K @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1716 Go to the next button (@code{mh-next-button}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1717 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1718 @kindex K S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1719 @findex mh-prev-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1720 @item K S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1721 Go to the previous button (@code{mh-prev-button}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1722 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1723 @kindex K a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1724 @findex mh-mime-save-parts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1725 @item K a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1726 Save attachments (@code{mh-mime-save-parts}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1727 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1728 @kindex K e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1729 @findex mh-display-with-external-viewer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1730 @item K e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1731 View attachment externally (@code{mh-display-with-external-viewer}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1732 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1733 @kindex K i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1734 @findex mh-folder-inline-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1735 @item K i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1736 Show attachment verbatim (@code{mh-folder-inline-mime-part}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1737 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1738 @kindex K o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1739 @findex mh-folder-save-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1740 @item K o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1741 Save (output) attachment (@code{mh-folder-save-mime-part}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1742 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1743 @kindex K t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1744 @findex mh-toggle-mime-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1745 @item K t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1746 Toggle option @code{mh-display-buttons-for-inline-parts-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1747 (@code{mh-toggle-mime-buttons}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1748 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1749 @kindex K v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1750 @findex mh-folder-toggle-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1751 @item K v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1752 View attachment (@code{mh-folder-toggle-mime-part}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1753 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1754 @cindex @samp{Message > Modify Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1755 @cindex menu item, @samp{Message > Modify Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1756 @kindex M
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1757 @findex mh-modify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1758 @item M
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1759 Edit message (@code{mh-modify}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1760 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1761 @cindex @samp{Message > Go to First Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1762 @cindex menu item, @samp{Message > Go to First Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1763 @kindex M-<
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1764 @findex mh-first-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1765 @item M-<
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1766 Display first message (@code{mh-first-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1767 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1768 @cindex @samp{Message > Go to Last Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1769 @cindex menu item, @samp{Message > Go to Last Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1770 @kindex M->
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1771 @findex mh-last-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1772 @item M->
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1773 Display last message (@code{mh-last-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1774 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1775 @kindex M-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1776 @findex mh-next-unread-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1777 @item M-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1778 Display next unread message (@code{mh-next-unread-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1779 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1780 @kindex M-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1781 @findex mh-previous-unread-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1782 @item M-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1783 Display previous unread message (@code{mh-previous-unread-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1784 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1785 @cindex @samp{Message > Next Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1786 @cindex menu item, @samp{Message > Next Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1787 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1788 @findex mh-next-undeleted-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1789 @item n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1790 Display next message (@code{mh-next-undeleted-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1791 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1792 @cindex @samp{Message > Previous Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1793 @cindex menu item, @samp{Message > Previous Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1794 @kindex p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1795 @findex mh-previous-undeleted-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1796 @item p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1797 Display previous message (@code{mh-previous-undeleted-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1798 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1799 @kindex P ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1800 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1801 @item P ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1802 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1803 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1804 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1805 @kindex P C
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1806 @findex mh-ps-print-toggle-color
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1807 @item P C
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1808 Toggle whether color is used in printing messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1809 (@code{mh-ps-print-toggle-color}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1810 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1811 @kindex P F
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1812 @findex mh-ps-print-toggle-faces
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1813 @item P F
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1814 Toggle whether printing is done with faces or not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1815 (@code{mh-ps-print-toggle-faces}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1816 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1817 @kindex P f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1818 @findex mh-ps-print-msg-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1819 @item P f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1820 Print range to file (@code{mh-ps-print-msg-file}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1821 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1822 @cindex @samp{Message > Print Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1823 @cindex menu item, @samp{Message > Print Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1824 @kindex P l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1825 @findex mh-print-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1826 @item P l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1827 Print range the old fashioned way
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1828 (@code{mh-print-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1829 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1830 @kindex P p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1831 @findex mh-ps-print-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1832 @item P p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1833 Print range (@code{mh-ps-print-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1834 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1835 @kindex X ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1836 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1837 @item X ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1838 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1839 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1840 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1841 @cindex @samp{Message > Unpack Uuencoded Message...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1842 @cindex menu item, @samp{Message > Unpack Uuencoded Message...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1843 @kindex X s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1844 @kindex X u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1845 @findex mh-store-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1846 @item X s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1847 @itemx X u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1848 Unpack message created with @command{uudecode} or @command{shar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1849 (@code{mh-store-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1850 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1851 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1852 @findex mh-show-mouse
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1853 @item Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1854 Move point to mouse event and show message (@code{mh-show-mouse}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1855 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1856
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1857 Within the MH-Show buffer, the following command is defined.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1858
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1859 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1860 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1861 @kindex Mouse-1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1862 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1863 @findex mh-press-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1864 @item @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1865 @itemx Mouse-1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1866 @itemx Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1867 View contents of button (@code{mh-press-button}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1868 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1869
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1870 @cindex @samp{mh-show} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1871 @cindex customization group, @samp{mh-show}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1872
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1873 The following table lists options in the @samp{mh-show} customization
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1874 group that are used while reading mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1875
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1876 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1877 @item mh-bury-show-buffer-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1878 On means show buffer is buried (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1879 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1880 @item mh-clean-message-header-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1881 On means remove extraneous header fields (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1882 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1883 @item mh-decode-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1884 On means attachments are handled (default: @samp{on} if the Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1885 @samp{mm-decode} package is present).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1886 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1887 @item mh-display-buttons-for-alternatives-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1888 On means display buttons for all alternative attachments (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1889 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1890 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1891 @item mh-display-buttons-for-inline-parts-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1892 On means display buttons for all inline attachments (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1893 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1894 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1895 @item mh-do-not-confirm-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1896 On means non-reversible commands do not prompt for confirmation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1897 (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1898 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1899 @item mh-fetch-x-image-url
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1900 Control fetching of @samp{X-Image-URL:} header field image (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1901 @samp{Never Fetch}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1902 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1903 @item mh-graphical-smileys-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1904 On means graphical smileys are displayed (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1905 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1906 @item mh-graphical-emphasis-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1907 On means graphical emphasis is displayed (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1908 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1909 @item mh-highlight-citation-style
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1910 Style for highlighting citations (default: @samp{Multicolor}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1911 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1912 @item mh-invisible-header-fields-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1913 List of hidden header fields (default: a checklist too long to list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1914 here).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1915 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1916 @item mh-invisible-header-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1917 Additional header fields to hide (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1918 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1919 @item mh-lpr-command-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1920 Command used to print (default: @code{"lpr -J '%s'"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1921 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1922 @item mh-max-inline-image-height
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1923 Maximum inline image height if @samp{Content-Disposition:} is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1924 present (default: 0).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1925 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1926 @item mh-max-inline-image-width
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1927 Maximum inline image width if @samp{Content-Disposition:} is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1928 present(default: 0).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1929 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1930 @item mh-mhl-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1931 Specifies the format file to pass to the @command{mhl} program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1932 (default: @samp{Use Default mhl Format (Printing Only)}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1933 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1934 @item mh-mime-save-parts-default-directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1935 Default directory to use for @kbd{K a}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1936 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1937 @item mh-print-background-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1938 On means messages should be printed in the background (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1939 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1940 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1941 @item mh-show-buffer-mode-line-buffer-id
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1942 Format string to produce @code{mode-line-buffer-identification} for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1943 show buffers (default: @code{" @{show-%s@} %d"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1944 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1945 @item mh-show-maximum-size
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1946 Maximum size of message (in bytes) to display automatically (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1947 0).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1948 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1949 @item mh-show-use-xface-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1950 On means display face images in MH-Show buffers (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1951 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1952 @item mh-store-default-directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1953 Default directory for @kbd{X s} (default: @samp{Current}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1954 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1955 @item mh-summary-height
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1956 Number of lines in MH-Folder buffer (including the mode line)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1957 (default: depends on size of frame).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1958 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1959
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1960 The following hooks are available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1961
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1962 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1963 @item mh-delete-msg-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1964 Hook run after marking each message for deletion (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1965 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1966 @item mh-show-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1967 Hook run after @key{RET} shows a message (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1968 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1969 @item mh-show-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1970 Hook run upon entry to @code{mh-show-mode} (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1971 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1972
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1973 The following faces are available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1974
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1975 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1976 @item mh-show-cc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1977 Face used to highlight @samp{cc:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1978 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1979 @item mh-show-date
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1980 Face used to highlight @samp{Date:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1981 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1982 @item mh-show-from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1983 Face used to highlight @samp{From:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1984 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1985 @item mh-show-header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1986 Face used to deemphasize less interesting header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1987 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1988 @item mh-show-pgg-bad
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1989 Bad PGG signature face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1990 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1991 @item mh-show-pgg-good
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1992 Good PGG signature face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1993 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1994 @item mh-show-pgg-unknown
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1995 Unknown or untrusted PGG signature face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1996 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1997 @item mh-show-signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1998 Signature face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1999 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2000 @item mh-show-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2001 Face used to highlight @samp{Subject:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2002 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2003 @item mh-show-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2004 Face used to highlight @samp{To:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2005 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2006 @item mh-show-xface
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2007 X-Face image face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2008 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2009
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2010 The functions and variables introduced here are explained in more
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2011 detail in the following sections.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2012
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2013 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2014 * Viewing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2015 * Viewing Attachments::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2016 * HTML::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2017 * Digests::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2018 * Reading PGP::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2019 * Printing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2020 * Files and Pipes::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2021 * Navigating::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2022 * Miscellaneous Commands and Options::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2023 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2024
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2025 @node Viewing, Viewing Attachments, Reading Mail, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2026 @section Viewing Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2027
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2028 @findex mh-header-display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2029 @findex mh-page-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2030 @findex mh-previous-page
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2031 @findex mh-show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2032 @findex mh-show-mouse
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2033 @kindex , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2034 @kindex . (period)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2035 @kindex @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2036 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2037 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2038 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2039
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2040 The command @key{RET} (@code{mh-show}) displays the message that the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2041 cursor is on while @kbd{Mouse-2} (@code{mh-show-mouse}) displays the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2042 message that the mouse cursor is on. If the message is already
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2043 displayed, it scrolls to the beginning of the message. Use @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2044 (@code{mh-page-msg}) and @key{BS} (@code{mh-previous-page}) to move
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2045 forwards and backwards one page at a time through the message. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2046 give either of these commands a prefix argument that specifies the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2047 number of lines to scroll (such as @kbd{10 @key{SPC}}). The @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2048 command will also show the next undeleted message if it is used at the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2049 bottom of a message. MH-E normally hides a lot of the superfluous
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2050 header fields that mailers add to a message, but if you wish to see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2051 all of them, use the command @kbd{,} (comma;
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2052 @code{mh-header-display}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2053
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2054 @vindex mh-show-maximum-size
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2055
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2056 The option @code{mh-show-maximum-size} provides an opportunity to skip
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2057 over large messages which may be slow to load. The default value of 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2058 means that all message are shown regardless of size.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2059
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2060 A litany of options control what displayed messages look like.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2061
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2062 @vindex mh-show-cc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2063 @vindex mh-show-date
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2064 @vindex mh-show-from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2065 @vindex mh-show-header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2066 @vindex mh-show-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2067 @vindex mh-show-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2068
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2069 First, the appearance of the header fields can be modified by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2070 customizing the associated face: @code{mh-show-to}, @code{mh-show-cc},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2071 @code{mh-show-from}, @code{mh-show-date}, and @code{mh-show-subject}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2072 The face @code{mh-show-header} is used to deemphasize the other, less
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2073 interesting, header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2074
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2075 @cindex regular expressions, @code{mh-invisible-header-fields}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2076 @vindex mh-clean-message-header-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2077 @vindex mh-invisible-header-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2078 @vindex mh-invisible-header-fields-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2079
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2080 Normally messages are delivered with a handful of uninteresting header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2081 fields. These are hidden by turning on the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2082 @code{mh-clean-message-header-flag} (which it is by default). The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2083 header fields listed in the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2084 @code{mh-invisible-header-fields-default} are hidden, although you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2085 check off any field that you would like to see. Header fields that you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2086 would like to hide that aren't listed can be added to the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2087 @code{mh-invisible-header-fields} with a couple of caveats. Regular
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2088 expressions are not allowed. Unique fields should have a @samp{:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2089 suffix; otherwise, the element can be used to render invisible an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2090 entire class of fields that start with the same prefix. If you think a
93018
230091ad831d (Viewing): Update URL for adding header fields to
Bill Wohler <wohler@newt.com>
parents: 92984
diff changeset
2091 header field should be generally ignored, please update
230091ad831d (Viewing): Update URL for adding header fields to
Bill Wohler <wohler@newt.com>
parents: 92984
diff changeset
2092 @uref{https://sourceforge.net/tracker/index.php?func=detail&aid=1916032&group_id=13357&atid=113357,
230091ad831d (Viewing): Update URL for adding header fields to
Bill Wohler <wohler@newt.com>
parents: 92984
diff changeset
2093 SF #1916032}.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2094
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2095 @cindex header field, @samp{Face:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2096 @cindex header field, @samp{X-Face:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2097 @cindex header field, @samp{X-Image-URL:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2098 @cindex @samp{Face:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2099 @cindex @samp{X-Face:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2100 @cindex @samp{X-Image-URL:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2101 @vindex mh-show-use-xface-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2102
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2103 MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2104 @samp{X-Image-URL:} header fields. If any of these fields occur in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2105 header of your message, the sender's face will appear in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2106 @samp{From:} header field. If more than one of these fields appear,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2107 then the first field found in the order @samp{Face:}, @samp{X-Face:},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2108 and @samp{X-Image-URL:} will be used. The option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2109 @code{mh-show-use-xface-flag} is used to turn this feature on and off.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2110 This feature will be turned on by default if your system supports it.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2111
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2112 The first header field used, if present, is the Gnus-specific
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2113 @samp{Face:} field@footnote{The @samp{Face:} field appeared in GNU
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2114 Emacs 21 and XEmacs. For more information, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2115 @uref{http://quimby.gnus.org/circus/face/}.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2116
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2117 @cindex @command{uncompface}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2118 @cindex Emacs, packages, x-face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2119 @cindex Unix commands, @command{uncompface}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2120 @cindex x-face package
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2121 @vindex mh-show-xface
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2122
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2123 Next is the traditional @samp{X-Face:} header field@footnote{The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2124 display of this field requires the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2125 @uref{ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.Z,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2126 @command{uncompface} program}. Recent versions of XEmacs have internal
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2127 support for @samp{X-Face:} images. If your version of XEmacs does not,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2128 then you'll need both @command{uncompface} and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2129 @uref{ftp://ftp.jpl.org/pub/elisp/, @samp{x-face} package}.}. MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2130 renders the foreground and background of the image using the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2131 associated attributes of the face @code{mh-show-xface}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2132
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2133 @cindex @command{convert}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2134 @cindex @command{wget}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2135 @cindex ImageMagick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2136 @cindex Unix commands, @command{convert}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2137 @cindex Unix commands, @command{wget}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2138 @vindex mh-fetch-x-image-url
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2139
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2140 Finally, MH-E will display images referenced by the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2141 @samp{X-Image-URL:} header field if neither the @samp{Face:} nor the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2142 @samp{X-Face:} fields are present@footnote{The display of the images
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2143 requires the @uref{http://www.gnu.org/software/wget/wget.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2144 @command{wget} program} to fetch the image and the @command{convert}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2145 program from the @uref{http://www.imagemagick.org/, ImageMagick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2146 suite}.}. Of the three header fields this is the most efficient in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2147 terms of network usage since the image doesn't need to be transmitted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2148 with every single mail. The option @code{mh-fetch-x-image-url}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2149 controls the fetching of the @samp{X-Image-URL:} header field image
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2150 with the following values:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2151
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2152 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2153 @item Ask Before Fetching
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2154 You are prompted before the image is fetched. MH-E will remember your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2155 reply and will either use the already fetched image the next time the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2156 same URL is encountered or silently skip it if you didn't fetch it the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2157 first time. This is a good setting.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2158 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2159 @item Never Fetch
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2160 Images are never fetched and only displayed if they are already
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2161 present in the cache. This is the default.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2162 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2163
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2164 There isn't a value of @samp{Always Fetch} for privacy and DOS (denial
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2165 of service) reasons. For example, fetching a URL can tip off a spammer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2166 that you've read his email (which is why you shouldn't blindly answer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2167 yes if you've set this option to @samp{Ask Before Fetching}). Someone
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2168 may also flood your network and fill your disk drive by sending a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2169 torrent of messages, each specifying a unique URL to a very large
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2170 file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2171
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2172 @cindex @file{.mhe-x-image-cache}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2173 @cindex files, @file{.mhe-x-image-cache}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2174
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2175 The cache of images is found in the directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2176 @file{.mhe-x-image-cache} within your MH directory. You can add your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2177 own face to the @samp{From:} field too. @xref{Picture}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2178
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2179 @cindex @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2180 @cindex MH commands, @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2181 @vindex mh-mhl-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2182
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2183 Normally MH-E takes care of displaying messages itself (rather than
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2184 calling an MH program to do the work). If you'd rather have
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2185 @command{mhl} display the message (within MH-E), change the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2186 @code{mh-mhl-format-file} from its default value of @samp{Use Default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2187 mhl Format (Printing Only)}. You can set this option to @samp{Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2188 Default mhl Format} to get the same output as you would get if you ran
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2189 @command{mhl} from the shell. If you have a format file that you want
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2190 MH-E to use, you can set this option to @samp{Specify an mhl Format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2191 File} and enter the name of your format file (@command{mhl}(1) or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2192 section @uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2193 the MH book tells you how to write one). Your format file should
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2194 specify a non-zero value for @samp{overflowoffset} to allow MH-E to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2195 parse the header. Note that @command{mhl} is always used for printing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2196 and forwarding; in this case, the value of @code{mh-mhl-format-file}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2197 is consulted if you have specified a format file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2198
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2199 @cindex citations, highlighting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2200 @cindex highlighting citations
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2201 @vindex mh-highlight-citation-style
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2202
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2203 If the sender of the message has cited other messages in his message,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2204 then MH-E will highlight these citations to emphasize the sender's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2205 actual response. The option @code{mh-highlight-citation-style} can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2206 customized to change the highlighting style. The @samp{Multicolor}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2207 method uses a different color for each indentation while the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2208 @samp{Monotone} method highlights all citations in red. To disable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2209 highlighting of citations entirely, choose @samp{None}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2210
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2211 @cindex URLs, highlighting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2212 @cindex email addresses, highlighting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2213 @cindex highlighting URLs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2214 @cindex highlighting email addresses
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2215 @cindex links, following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2216 @findex goto-address-at-point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2217 @kindex C-c @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2218 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2219 @vindex goto-address-highlight-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2220
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2221 Email addresses and URLs in the message are highlighted if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2222 @code{goto-address-highlight-p} is on, which it is by default. To view
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2223 the web page for a highlighted URL or to send a message using a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2224 highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2225 (@code{goto-address-at-point}). @xref{Sending Mail}, to see how to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2226 configure Emacs to send the message using MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2227
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2228 @cindex boldface, showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2229 @cindex emphasis
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2230 @cindex italics, showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2231 @cindex smileys
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2232 @cindex typesetting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2233 @cindex underline, showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2234 @vindex gnus-emphasis-alist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2235 @vindex mh-decode-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2236 @vindex mh-graphical-emphasis-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2237 @vindex mh-graphical-smileys-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2238
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2239 It is a long standing custom to inject body language using a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2240 cornucopia of punctuation, also known as the @dfn{smileys}. MH-E can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2241 render these as graphical widgets if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2242 @code{mh-graphical-smileys-flag} is turned on, which it is by default.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2243 Smileys include patterns such as :-) and ;-). Similarly, a few
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2244 typesetting features are indicated in ASCII text with certain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2245 characters. If your terminal supports it, MH-E can render these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2246 typesetting directives naturally if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2247 @code{mh-graphical-emphasis-flag} is turned on, which it is by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2248 default. For example, _underline_ will be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2249 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2250 @html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2251 <u>underlined</u>,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2252 @end html
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2253 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2254 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2255 underlined,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2256 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2257 *bold* will appear in @b{bold}, /italics/ will appear in @i{italics},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2258 and so on. See the option @code{gnus-emphasis-alist} for the whole
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2259 list. Both of these options are disabled if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2260 @code{mh-decode-mime-flag} is turned off. @xref{Viewing Attachments}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2261
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2262 @cindex signature separator
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2263 @cindex vCard
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2264 @vindex mh-show-signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2265
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2266 MH-E normally renders signatures and vCards in italics so that the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2267 body of the message stands out more. MH-E depends on the presence of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2268 the @dfn{signature separator} (@code{"-- "}) to do this. You can also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2269 customize the face @code{mh-show-signature} so the appearance of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2270 signature block is more to your liking.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2271
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2272 @vindex mh-show-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2273 @vindex mh-show-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2274
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2275 Two hooks can be used to control how messages are displayed. The first
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2276 hook, @code{mh-show-mode-hook}, is called early on in the process of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2277 the message display. It is usually used to perform some action on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2278 message's content. The second hook, @code{mh-show-hook}, is the last
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2279 thing called after messages are displayed. It's used to affect the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2280 behavior of MH-E in general or when @code{mh-show-mode-hook} is too
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2281 early.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2282
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2283 @cindex MH-Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2284 @cindex modes, MH-Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2285 @vindex mh-show-buffer-mode-line-buffer-id
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2286
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2287 For those who like to modify their mode lines, use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2288 @code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2289 the MH-Show buffers. Place the two escape strings @samp{%s} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2290 @samp{%d}, which will display the folder name and the message number,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2291 respectively, somewhere in the string in that order. The default value
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2292 of @code{"@{show-%s@} %d"} yields a mode line of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2293
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2294 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2295 -----@{show-+inbox@} 4 (MH-Show)--Bot--------------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2296 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2297
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2298 @node Viewing Attachments, HTML, Viewing, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2299 @section Viewing Attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2300
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2301 @cindex attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2302 @cindex body parts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2303 @cindex @command{mhshow}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2304 @cindex @command{show}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2305 @cindex MH commands, @command{mhshow}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2306 @cindex MH commands, @command{show}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2307 @cindex MIME
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2308 @cindex multimedia mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2309
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2310 MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2311 Mail Extensions) messages which are simply messages with additional
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2312 @dfn{body parts} or @dfn{attachments}. You can use the MH commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2313 @command{show}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2314 @uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2315 prev} in the MH book.} or @command{mhshow}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2316 @uref{@value{MH-BOOK-HOME}/usimim.html#ReMIMa, Reading MIME Mail} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2317 the MH book.} from the shell to read @sc{mime} messages@footnote{You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2318 can call them directly from Emacs if you're running the X Window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2319 System: type @kbd{M-! xterm -e mhshow @var{message-number}}. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2320 leave out the @samp{xterm -e} if you use @command{mhlist} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2321 @command{mhstore}.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2322
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2323 @cindex Emacs, packages, mm-decode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2324 @cindex mm-decode package
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2325 @findex mh-toggle-mh-decode-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2326 @kindex ; (semicolon)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2327 @vindex mh-decode-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2328
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2329 MH-E can handle attachments as well if the Gnus @samp{mm-decode}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2330 package is present. If so, the option @code{mh-decode-mime-flag} will
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2331 be on. Otherwise, you'll see the @sc{mime} body parts rather than text
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2332 or attachments. There isn't much point in turning off the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2333 @code{mh-decode-mime-flag}; however, you can inspect it if it appears
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2334 that the body parts are not being interpreted correctly or toggle it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2335 with the command @kbd{;} (semicolon;
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2336 @code{mh-toggle-mh-decode-mime-flag}) to view the raw message. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2337 option also controls the display of quoted-printable messages and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2338 other graphical widgets. @xref{Viewing}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2339
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2340 @cindex buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2341
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2342 Attachments in MH-E are indicated by @dfn{buttons} like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2343
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2344 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2345 [1. image/jpeg; foo.jpg]...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2346 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2347
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2348 @findex mh-next-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2349 @findex mh-press-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2350 @findex mh-prev-button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2351 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2352 @kindex K @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2353 @kindex K S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2354 @kindex Mouse-1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2355 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2356
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2357 To view the contents of the button, use either @kbd{Mouse-1} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2358 @kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2359 the cursor is over the button. This command is a toggle so if you use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2360 it again on the same attachment, it is hidden. If Emacs does not know
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2361 how to display the attachment, then Emacs offers to save the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2362 attachment in a file. To move the cursor to the next button, use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2363 command @kbd{K @key{TAB}} (@code{mh-next-button}). If the end of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2364 buffer is reached then the search wraps over to the start of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2365 buffer. To move the cursor to the previous button, use the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2366 @kbd{K S-@key{TAB}} (@code{mh-prev-button}). If the beginning of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2367 buffer is reached then the search wraps over to the end of the buffer.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2368
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2369 @cindex attachments, viewing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2370 @cindex viewing attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2371 @findex mh-folder-toggle-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2372 @kindex K v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2373
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2374 Another way to view the contents of a button is to use the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2375 @kbd{K v} (@code{mh-folder-toggle-mime-part}). This command displays
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2376 (or hides) the attachment associated with the button under the cursor.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2377 If the cursor is not located over a button, then the cursor first
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2378 moves to the next button, wrapping to the beginning of the message if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2379 necessary. This command has the advantage over the previous commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2380 of working from the MH-Folder buffer. You can also provide a numeric
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2381 prefix argument (as in @kbd{4 K v}) to view the attachment labeled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2382 with that number. If Emacs does not know how to display the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2383 attachment, then Emacs offers to save the attachment in a file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2384
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2385 @cindex @file{/etc/mailcap}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2386 @cindex files, @file{/etc/mailcap}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2387 @findex mailcap-mime-info
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2388 @findex mh-display-with-external-viewer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2389 @kindex K e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2390
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2391 If Emacs does not know how to view an attachment, you could save it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2392 into a file and then run some program to open it. It is easier,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2393 however, to launch the program directly from MH-E with the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2394 @kbd{K e} (@code{mh-display-with-external-viewer}). While you'll most
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2395 likely use this to view spreadsheets and documents, it is also useful
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2396 to use your browser to view HTML attachments with higher fidelity than
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2397 what Emacs can provide. This command displays the attachment
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2398 associated with the button under the cursor. If the cursor is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2399 located over a button, then the cursor first moves to the next button,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2400 wrapping to the beginning of the message if necessary. You can provide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2401 a numeric prefix argument (as in @kbd{4 K e}) to view the attachment
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2402 labeled with that number. This command tries to provide a reasonable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2403 default for the viewer by calling the Emacs function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2404 @code{mailcap-mime-info}. This function usually reads the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2405 @file{/etc/mailcap}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2406
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2407 @cindex attachments, saving
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2408 @cindex saving attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2409 @findex mh-folder-save-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2410 @kindex K o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2411
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2412 Use the command @kbd{K o} (@code{mh-folder-save-mime-part}) to save
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2413 attachments (the mnemonic is ``output''). This command saves the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2414 attachment associated with the button under the cursor. If the cursor
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2415 is not located over a button, then the cursor first moves to the next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2416 button, wrapping to the beginning of the message if necessary. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2417 also provide a numeric prefix argument (as in @kbd{3 K o}) to save the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2418 attachment labeled with that number. This command prompts you for a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2419 filename and suggests a specific name if it is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2420
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2421 @cindex @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2422 @cindex @command{mhstore}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2423 @cindex MH commands, @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2424 @cindex MH commands, @command{mhstore}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2425 @findex mh-mime-save-parts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2426 @kindex K a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2427 @vindex mh-mime-save-parts-default-directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2428
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2429 You can save all of the attachments at once with the command @kbd{K a}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2430 (@code{mh-mime-save-parts}). The attachments are saved in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2431 directory specified by the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2432 @code{mh-mime-save-parts-default-directory} unless you use a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2433 argument (as in @kbd{C-u K a}) in which case you are prompted for the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2434 directory. These directories may be superseded by MH profile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2435 components, since this function calls on @command{mhstore}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2436 (@command{mhn}) to do the work.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2437
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2438 @vindex mh-mime-save-parts-default-directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2439
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2440 The default value for the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2441 @code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2442 that you are always prompted for the directory in which to save the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2443 attachments. However, if you usually use the same directory within a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2444 session, then you can set this option to @samp{Prompt the First Time}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2445 to avoid the prompt each time. you can make this directory permanent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2446 by choosing @samp{Directory} and entering the directory's name.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2447
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2448 @cindex attachments, inline
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2449 @cindex inline attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2450 @findex mh-toggle-mime-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2451 @kindex K t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2452 @vindex mh-display-buttons-for-inline-parts-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2453
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2454 The sender can request that attachments should be viewed inline so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2455 that they do not really appear like an attachment at all to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2456 reader. Most of the time, this is desirable, so by default MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2457 suppresses the buttons for inline attachments. On the other hand, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2458 may receive code or HTML which the sender has added to his message as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2459 inline attachments so that you can read them in MH-E. In this case, it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2460 is useful to see the buttons so that you know you don't have to cut
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2461 and paste the code into a file; you can simply save the attachment. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2462 you want to make the buttons visible for inline attachments, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2463 use the command @kbd{K t} (@code{mh-toggle-mime-buttons}) to toggle
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2464 the visibility of these buttons. You can turn on these buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2465 permanently by turning on the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2466 @code{mh-display-buttons-for-inline-parts-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2467
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2468 MH-E cannot display all attachments inline however. It can display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2469 text (including @sc{html}) and images.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2470
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2471 @cindex header field, @samp{Content-Disposition:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2472 @cindex inline images
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2473 @cindex @samp{Content-Disposition:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2474 @vindex mh-max-inline-image-height
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2475 @vindex mh-max-inline-image-width
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2476
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2477 Some older mail programs do not insert the needed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2478 plumbing@footnote{This plumbing is the @samp{Content-Disposition:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2479 header field.} to tell MH-E whether to display the attachments inline
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2480 or not. If this is the case, MH-E will display these images inline if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2481 they are smaller than the window. However, you might want to allow
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2482 larger images to be displayed inline. To do this, you can change the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2483 options @code{mh-max-inline-image-width} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2484 @code{mh-max-inline-image-height} from their default value of zero to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2485 a large number. The size of your screen is a good choice for these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2486 numbers.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2487
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2488 @cindex alternatives
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2489 @cindex attachments, alternatives
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2490 @vindex mh-display-buttons-for-alternatives-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2491
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2492 Sometimes, a mail program will produce multiple alternatives of an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2493 attachment in increasing degree of faithfulness to the original
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2494 content. By default, only the preferred alternative is displayed. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2495 the option @code{mh-display-buttons-for-alternatives-flag} is on, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2496 the preferred part is shown inline and buttons are shown for each of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2497 the other alternatives.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2498
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2499 @vindex mm-discouraged-alternatives
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2500
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2501 Many people prefer to see the @samp{text/plain} alternative rather
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2502 than the @samp{text/html} alternative. To do this in MH-E, customize
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2503 the option @code{mm-discouraged-alternatives}, and add
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2504 @samp{text/html}. The next best alternative, if any, will be shown.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2505
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2506 @findex mh-show-preferred-alternative
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2507 @kindex : (colon)
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2508
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2509 Occasionally, though, you might want to see the preferred alternative.
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2510 The command @kbd{:} (@code{mh-show-preferred-alternative}) displays
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2511 the message with the default preferred alternative. This is as if
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2512 @code{mm-discouraged-alternatives} is set to @samp{nil}. Use the
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2513 command @key{RET} (@code{mh-show}) to show the message normally again.
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
2514
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2515 @kindex K i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2516 @findex mh-folder-inline-mime-part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2517
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2518 You can view the raw contents of an attachment with the command @kbd{K
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2519 i} (@code{mh-folder-inline-mime-part}). This command displays (or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2520 hides) the contents of the attachment associated with the button under
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2521 the cursor verbatim. If the cursor is not located over a button, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2522 the cursor first moves to the next button, wrapping to the beginning
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2523 of the message if necessary. You can also provide a numeric prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2524 argument (as in @kbd{4 K i}) to view the attachment labeled with that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2525 number.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2526
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2527 For additional information on buttons, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2528 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2529 @ref{Article Buttons,,,gnus}, and @ref{MIME Commands,,,gnus}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2530 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2531 @ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2532 the chapters @uref{http://www.gnus.org/manual/gnus_101.html#SEC101,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2533 Article Buttons} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2534 @uref{http://www.gnus.org/manual/gnus_108.html#SEC108, MIME Commands}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2535 in the @cite{The Gnus Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2536 @end ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2537
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2538 @node HTML, Digests, Viewing Attachments, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2539 @section HTML
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2540
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2541 @cindex HTML
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2542 @cindex Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2543
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2544 MH-E can display messages that have been sent in HTML@footnote{This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2545 feature depends on a version of Gnus that is at least 5.10.}. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2546 content of the message will appear in the MH-Show buffer as you would
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2547 expect if the entire message is HTML, or there is an inline HTML body
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2548 part. However, if there is an HTML body part that is an attachment,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2549 then you'll see a button like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2550
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2551 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2552 [1. text/html; foo.html]...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2553 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2554
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2555 To see how to read the contents of this body part, see @ref{Viewing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2556 Attachments}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2557
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2558 @vindex mm-text-html-renderer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2559
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2560 The browser that MH-E uses is determined by the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2561 @code{mm-text-html-renderer}. The default setting is set automatically
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2562 based upon the presence of a known browser on your system. If you wish
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2563 to use a different browser, then set this option accordingly. See the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2564 documentation for the browser you use for additional information on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2565 how to use it. In particular, find and disable the option to render
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2566 images as this can tip off spammers that the email address they have
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2567 used is valid.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2568
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2569 @vindex mm-text-html-renderer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2570
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2571 If you're confused about which @code{mm-text-html-renderer} to use,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2572 here's a brief description of each, sorted by popularity, that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2573 includes the results of a quick poll of MH-E users from 2005-12-23.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2574
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2575 @table @asis
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2576 @cindex browser, @samp{w3m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2577 @cindex @samp{w3m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2578 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2579 @item @samp{w3m} 7
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2580 The @samp{w3m} browser requires an external program. It's quick,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2581 produces pretty nice output, and best of all, it's the only browser
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2582 that highlights links. These can be clicked with @kbd{Mouse-2} to view
84934
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2583 the content of the link in @samp{w3m}. The @samp{w3m} browser handles
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2584 tables well and actually respects the table's width parameter (which
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2585 can cause text to wrap if the author didn't anticipate that the page
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2586 would be viewed in Emacs).
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2587 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2588 @cindex browser, @samp{w3m-standalone}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2589 @cindex @samp{w3m-standalone}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2590 @item @samp{w3m-standalone} 3
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2591 This browser, along with @samp{nil} for the external browser, are the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2592 only choices that work without having to download a separate lisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2593 package or external program. This browser is quick, but does not show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2594 links. It handles simple tables but some tables get rendered much
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2595 wider than the Emacs frame. This browser was the only one not to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2596 handle the escape @samp{&ndash;} (it printed a @samp{?}), but it did
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2597 render @samp{&reg;}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2598 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2599 @cindex browser, @samp{links}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2600 @cindex @samp{links}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2601 @item @samp{links} 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2602 The @samp{links} browser requires an external program. It's quick, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2603 produces nicer output than @samp{lynx} on single column mails in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2604 tables. However, it doesn't show links and it doesn't do as nice a job
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2605 on multi-column tables as some lines wrap. At least it fits in 80
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2606 columns and thus seems better than @samp{w3} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2607 @samp{w3m-standalone}. Converts escapes such as @samp{&reg;} to (R).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2608 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2609 @cindex browser, @samp{lynx}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2610 @cindex @samp{lynx}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2611 @item @samp{lynx} 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2612 The @samp{lynx} browser requires an external program. It's quick and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2613 produces pretty decent output but it doesn't show links. It doesn't
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2614 seem to do multi-column tables which makes output much cleaner. It
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2615 centers the output and wraps long lines more than most. Handles
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2616 @samp{&reg;}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2617 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2618 @item @samp{nil} 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2619 This choice obviously requires an external browser. Like
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2620 @samp{w3m-standalone}, it works out of the box. With this setting,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2621 HTML messages have a button for the body part which you can view with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2622 @kbd{K v} (@code{mh-folder-toggle-mime-part}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2623 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2624 @cindex browser, @samp{w3}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2625 @cindex @samp{w3}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2626 @item @samp{w3} 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2627 This choice does not require an external program as all of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2628 rendering is done in lisp. You do need to get the package separately.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2629 This browser is @strong{slow}, and doesn't appear to have been updated
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2630 since 2001 and the author hasn't responded to my emails. It displays
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2631 unknown tags instead of hiding them, so you get to see all the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2632 Microsoft crap in certain messages. Tends to make multi-column tables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2633 wider than even a full-screen Emacs can handle. Like @samp{w3m}, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2634 can follow links, but you have to find them first as they are not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2635 highlighted. Performs well on single-column tables and handles escapes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2636 such as @samp{&reg;}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2637 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2638 @cindex browser, @samp{html2text}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2639 @cindex @samp{html2text}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2640 @item @samp{html2text} 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2641 The @samp{html2text} browser requires an external program. I noticed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2642 that it can do some nasty things with simple HTML mails (like filling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2643 the entire message as if it were one paragraph, including signature).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2644 On another message, it displayed half of the HTML tags for some
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2645 reason.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2646 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2647
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2648 @vindex mm-text-html-renderer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2649
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2650 For a couple more sources of information about
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2651 @code{mm-text-html-renderer},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2652 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2653 @xref{Display Customization,,,emacs-mime}, and the documentation for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2654 the Gnus command @kbd{W h} (@pxref{Article Washing,,,gnus},).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2655 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2656 @ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2657 see section @uref{http://www.gnus.org/manual/emacs-mime_6.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2658 Display Customization} in the @cite{The Emacs MIME Manual} and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2659 documentation for the Gnus command @kbd{W h} (see section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2660 @uref{http://www.gnus.org/manual/gnus_99.html, Article Washing} in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2661 @cite{The Gnus Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2662 @end ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2663
84934
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2664 @cindex @file{.emacs}
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2665 @cindex files, @file{.emacs}
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2666 @findex browse-url-at-mouse
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2667 @kindex S-Mouse-2
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2668
102151
328f4b370b74 Remove duplicate words.
Juanma Barranquero <lekktu@gmail.com>
parents: 102059
diff changeset
2669 A useful key binding that you can add to @file{~/.emacs} is the
84934
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2670 following which displays an HTML link or textual URL in an external
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2671 browser when clicked with @kbd{S-mouse-2}. This binding works in any
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2672 buffer, including HTML buffers.
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2673
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2674 @smalllisp
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2675 (global-set-key [S-mouse-2] 'browse-url-at-mouse)
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2676 @end smalllisp
659f550b9193 (HTML): Mention binding of S-mouse-2 to browse-url-at-mouse.
Bill Wohler <wohler@newt.com>
parents: 84329
diff changeset
2677
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2678 @node Digests, Reading PGP, HTML, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2679 @section Digests
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2680
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2681 @cindex digests
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2682 @findex mh-page-digest
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2683 @findex mh-page-digest-backwards
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2684 @kindex D @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2685 @kindex D @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2686 @kindex @key{BS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2687 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2688
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2689 A digest is a message that contains other messages. Special MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2690 commands let you read digests conveniently. You can use @key{SPC} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2691 @key{BS} to page through the digest as if it were a normal message,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2692 but if you wish to skip to the next message in the digest, use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2693 @kbd{D @key{SPC}} (@code{mh-page-digest}). To return to a previous message,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2694 use @kbd{D @key{BS}} (@code{mh-page-digest-backwards}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2695
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2696 @cindex @command{burst}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2697 @cindex MH commands, @command{burst}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2698 @cindex MH-Folder Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2699 @cindex modes, MH-Folder Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2700 @findex mh-burst-digest
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2701 @kindex d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2702 @kindex D b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2703 @kindex t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2704
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2705 Another handy command is @kbd{D b} (@code{mh-burst-digest}). This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2706 command uses the MH command @command{burst}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2707 @uref{@value{MH-BOOK-HOME}/burdig.html, Bursting Messages} in the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2708 book.} to break out each message in the digest into its own message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2709 Using this command, you can quickly delete unwanted messages, like
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2710 this: Once the digest is split up, toggle out of MH-Folder Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2711 with @kbd{t} (@pxref{Folders}) so that the scan lines fill the screen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2712 and messages aren't displayed. Then use @kbd{d} (@pxref{Reading Mail})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2713 to quickly delete messages that you don't want to read (based on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2714 @samp{Subject:} header field). You can also burst the digest to reply
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2715 directly to the people who posted the messages in the digest. One
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2716 problem you may encounter is that the @samp{From:} header fields are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2717 preceded with a @samp{>} so that your reply can't create the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2718 @samp{To:} field correctly. In this case, you must correct the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2719 @samp{To:} field yourself. This is described later (@pxref{Editing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2720 Drafts}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2721
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2722 @node Reading PGP, Printing, Digests, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2723 @section Signed and Encrypted Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2724
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2725 @cindex GPG
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2726 @cindex GnuPG
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2727 @cindex Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2728 @cindex OpenPGP
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2729 @cindex PGP
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2730 @cindex RFC 3156
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2731 @cindex encrypted messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2732 @cindex security
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2733 @cindex signed messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2734
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2735 You can read encrypted or signed PGP or GPG messages with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2736 MH-E@footnote{This feature depends on post-5.10 versions of Gnus.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2737 @cite{MIME Security with OpenPGP} is documented in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2738 @uref{http://www.rfc-editor.org/rfc/rfc3156.txt, RFC 3156}. However,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2739 MH-E can also decrypt old-style PGP messages that are not in MIME
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2740 format.}. This section assumes that you already have a good
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2741 understanding of GPG and have set up your keys appropriately.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2742
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2743 If someone sends you a signed message, here is what you'll see:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2744
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2745 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2746 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2747 [[PGP Signed Part:Bill Wohler <wohler@@stop.mail-abuse.org>]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2748 This is a signed message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2749
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2750 [[End of PGP Signed Part]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2751 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2752 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2753
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2754 @cindex keychain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2755 @cindex key server
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2756 @cindex signed messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2757
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2758 If the key for the given signature is not in your keychain, you'll be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2759 given the opportunity to fetch the key from a key server and verify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2760 the key. If the message is really large, the verification process can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2761 take a long time. You can press @kbd{C-g} at any time to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2762 cancel@footnote{Unfortunately in the current version, the validation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2763 process doesn't display a message so it appears that MH-E has hung. We
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2764 hope that this will be fixed in the future.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2765
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2766 If the signature doesn't check out, you might see something like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2767
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2768 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2769 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2770 [[PGP Signed Part:Failed]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2771 This is a signed message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2772 This is garbage added after the signature was made.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2773
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2774 [[End of PGP Signed Part]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2775 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2776 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2777
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2778 @cindex decrypting messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2779
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2780 If someone sends you an encrypted message, MH-E will ask for your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2781 passphrase to decrypt the message. You should see something like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2782
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2783 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2784 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2785 [[PGP Encrypted Part:OK]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2786
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2787 [[PGP Signed Part:Bill Wohler <wohler@@stop.mail-abuse.org>]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2788 This is the secret message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2789
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2790 [[End of PGP Signed Part]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2791
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2792 [[End of PGP Encrypted Part]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2793 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2794 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2795
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2796 If there is a problem decrypting the message, the button will say:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2797
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2798 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2799 [[PGP Encrypted Part:Failed]]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2800 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2801
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2802 You can read the contents of this button using the methods described in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2803 @ref{Viewing Attachments}. If the message were corrupted, you'd see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2804 this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2805
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2806 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2807 [[PGP Encrypted Part:Failed]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2808 Invalid base64 data]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2809 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2810
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2811 If your passphrase were incorrect, you'd see something like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2812
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2813 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2814 [GNUPG:] ENC_TO CD9C88BB610BD9AD 1 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2815 [GNUPG:] USERID_HINT CD9C88BB610BD9AD Bill Wohler <wohler@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2816 [GNUPG:] NEED_PASSPHRASE CD9C88BB610BD9AD CD9C88BB610BD9AD 1 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2817 [GNUPG:] BAD_PASSPHRASE CD9C88BB610BD9AD
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2818 gpg: encrypted with 1024-bit RSA key, ID 610BD9AD, created 1997-09-09
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2819 "Bill Wohler <wohler@@stop.mail-abuse.org>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2820 gpg: public key decryption failed: bad passphrase
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2821 [GNUPG:] BEGIN_DECRYPTION
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2822 [GNUPG:] DECRYPTION_FAILED
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2823 gpg: decryption failed: secret key not available
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2824 [GNUPG:] END_DECRYPTION
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2825
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2826 gpg exited abnormally: '2'
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2827 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2828
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2829 @vindex mh-show-pgg-bad
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2830 @vindex mh-show-pgg-good
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2831 @vindex mh-show-pgg-unknown
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2832
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2833 The appearance of the buttons is controlled by the faces
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2834 @code{mh-show-pgg-good}, @code{mh-show-pgg-bad}, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2835 @code{mh-show-pgg-unknown} depending on the validity of the signature.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2836 The latter is used whether the signature is unknown or untrusted.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2837
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2838 @cindex @samp{pgg} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2839 @cindex PGG
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2840 @cindex customization group, @samp{pgg}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2841
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2842 The @samp{pgg} customization group may have some settings which may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2843 interest you.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2844 @iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2845 See @cite{The PGG Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2846 @end iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2847 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2848 @xref{Top, , The PGG Manual, pgg, The PGG Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2849 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2850 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2851 See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2852 @uref{http://www.dk.xemacs.org/Documentation/packages/html/pgg.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2853 @cite{The PGG Manual}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2854 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2855
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2856 @node Printing, Files and Pipes, Reading PGP, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2857 @section Printing Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2858
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2859 @cindex printing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2860 @findex mh-ps-print-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2861 @findex mh-ps-print-msg-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2862 @kindex P f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2863 @kindex P p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2864 @vindex mh-lpr-command-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2865 @vindex mh-print-background-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2866
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2867 To print messages in MH-E, use the command @kbd{P p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2868 (@code{mh-ps-print-msg}). You can print all the messages in a range
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2869 (as in @kbd{C-u P p 1 3 5-7 last:5 frombob @key{RET}},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2870 @pxref{Ranges}). You can also send the output to a file with @kbd{P f}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2871 (@code{mh-ps-print-msg-file}). This command will print inline text
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2872 attachments but will not decrypt messages. However, when a message is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2873 displayed in an MH-Show buffer, then that buffer is used verbatim for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2874 printing with the caveat that only text attachments, if opened inline,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2875 are printed. Therefore, encrypted messages can be printed by showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2876 and decrypting them first. The commands @kbd{P p} and @kbd{P f} do not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2877 use the options @code{mh-lpr-command-format} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2878 @code{mh-print-background-flag}, described below.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2879
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2880 @findex mh-ps-print-toggle-color
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2881 @kindex P C
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2882 @vindex ps-print-color-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2883
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2884 Colors are emulated on black-and-white printers with shades of gray.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2885 This might produce illegible output, even if your screen colors only
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2886 use shades of gray. If this is the case, try using the command @kbd{P
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2887 C} (@code{mh-ps-print-toggle-color}) to toggle between color, no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2888 color, and a black and white representation of the colors and see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2889 which works best. You change this setting permanently by customizing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2890 the option @code{ps-print-color-p}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2891
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2892 @findex mh-ps-print-toggle-faces
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2893 @kindex P F
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2894
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2895 Another related function is the command @kbd{P F}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2896 (@code{mh-ps-print-toggle-faces}). This command toggles between using
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2897 faces and not. When faces are enabled, the printed message will look
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2898 very similar to the message in the MH-Show buffer.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2899
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2900 @cindex ps-print package
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2901 @cindex Emacs, packages, ps-print
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2902
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2903 MH-E uses the @samp{ps-print} package to do the printing, so you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2904 customize the printing further by going to the @samp{ps-print}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2905 customization group.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2906
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2907 @cindex @command{lpr}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2908 @cindex @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2909 @cindex MH commands, @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2910 @cindex Unix commands, @command{lpr}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2911 @findex mh-print-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2912 @kindex P l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2913
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2914 An alternative to using the @samp{ps-print} package is the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2915 @kbd{P l} (@code{mh-print-msg}) (the @i{l} is for @i{l}ine printer or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2916 @i{l}pr). You can print all the messages in a range. The message is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2917 formatted with @command{mhl}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2918 @uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2919 book.} and printed with the @command{lpr} command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2920
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2921 @kindex P f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2922 @kindex P l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2923 @kindex P p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2924 @vindex mh-lpr-command-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2925 @vindex mh-print-background-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2926
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2927 The command @kbd{P l} uses two options. The option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2928 @code{mh-lpr-command-format} contains the Unix command line which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2929 performs the actual printing. The string can contain one escape,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2930 @samp{%s}, which is replaced by the name of the folder and the message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2931 number and is useful for print job names. The default setting is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2932 @code{"lpr -J '%s'"}. I use @code{"mpage -h'%s' -b Letter -H1of -mlrtb
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2933 -P"} which produces a nice header and adds a bit of margin so the text
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2934 fits within my printer's margins. Normally messages are printed in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2935 foreground. If this is slow on your system, you may elect to turn on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2936 the option @code{mh-print-background-flag} to print in the background.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2937 If you do this, do not delete the message until it is printed or else
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2938 the output may be truncated. These options are not used by the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2939 commands @kbd{P p} or @kbd{P f}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2940
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2941 @node Files and Pipes, Navigating, Printing, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2942 @section Files and Pipes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2943
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2944 @cindex files
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2945 @cindex pipes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2946 @findex mh-refile-or-write-again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2947 @findex mh-write-msg-to-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2948 @kindex >
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2949 @kindex !
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2950
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2951 MH-E does offer a couple of commands that are not a part of MH@. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2952 first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2953 a file. You are prompted for the filename. If the file already exists,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2954 the message is appended to it. You can also write the message to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2955 file without the header by specifying a prefix argument (such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2956 @kbd{C-u > /tmp/foobar @key{RET}}). Subsequent writes to the same file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2957 can be made with the command @kbd{!}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2958 (@code{mh-refile-or-write-again}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2959
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2960 @findex mh-pipe-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2961 @kindex |
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2962 @kindex l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2963
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2964 You can also pipe the message through a Unix shell command with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2965 command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2966 command through which you wish to run your message. If you give a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2967 prefix argument to this command, the message header is included in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2968 text passed to the command (the contrived example @kbd{C-u | lpr}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2969 would be done with the @kbd{l} command instead).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2970
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2971 @cindex @command{shar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2972 @cindex @command{uuencode}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2973 @cindex Unix commands, @command{shar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2974 @cindex Unix commands, @command{uuencode}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2975 @findex mh-store-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2976 @kindex X s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2977 @vindex mh-store-default-directory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2978
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2979 If the message is a shell archive @command{shar} or has been run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2980 through @command{uuencode} use @kbd{X s} (@code{mh-store-msg}) to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2981 extract the body of the message. The default directory for extraction
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2982 is the current directory; however, you have a chance to specify a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2983 different extraction directory. The next time you use this command,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2984 the default directory is the last directory you used. If you would
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2985 like to change the initial default directory, customize the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2986 @code{mh-store-default-directory}, change the value from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2987 @samp{Current} to @samp{Directory}, and then enter the name of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2988 directory for storing the content of these messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2989
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2990 @findex mh-store-buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2991 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2992 @kindex X s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2993
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2994 By the way, @kbd{X s} calls the Emacs Lisp function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2995 @code{mh-store-buffer}. I mention this because you can use it directly
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2996 if you're editing a buffer that contains a file that has been run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2997 through @command{uuencode} or @command{shar}. For example, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2998 extract the contents of the current buffer in your home directory by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2999 typing @kbd{M-x mh-store-buffer @key{RET} ~ @key{RET}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3000
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3001 @node Navigating, Miscellaneous Commands and Options, Files and Pipes, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3002 @section Navigating
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3003
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3004 @cindex moving between messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3005 @cindex navigation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3006 @findex mh-first-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3007 @findex mh-goto-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3008 @findex mh-last-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3009 @findex mh-next-undeleted-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3010 @findex mh-next-unread-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3011 @findex mh-previous-undeleted-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3012 @findex mh-previous-unread-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3013 @kindex g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3014 @kindex M-<
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3015 @kindex M->
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3016 @kindex M-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3017 @kindex M-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3018 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3019 @kindex p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3020
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3021 To move on to the next message, use the command @kbd{n}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3022 (@code{mh-next-undeleted-msg}); use @kbd{p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3023 (@code{mh-previous-undeleted-msg}) to read the previous message. To
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3024 move to the next unread message, use @kbd{M-n}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3025 (@code{mh-next-unread-msg}); use @kbd{M-p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3026 (@code{mh-previous-unread-msg}) to move to the previous unread
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3027 message. These commands can be given a prefix argument to specify how
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3028 many messages to skip (for example, @kbd{5 n}). You can also move to a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3029 specific message with @kbd{g} (@code{mh-goto-msg}). You can enter the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3030 message number either before or after typing @kbd{g}. In the latter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3031 case, Emacs prompts you. Finally, you can go to the first or last
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3032 message with @kbd{M-<} (@code{mh-first-msg}) and @kbd{M->}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3033 (@code{mh-last-msg}) respectively.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3034
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3035 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3036 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3037 @findex next-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3038 @findex previous-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3039 @kindex C-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3040 @kindex C-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3041 @kindex @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3042
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3043 You can also use the Emacs commands @kbd{C-p} (@code{previous-line})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3044 and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3045 the MH-Folder window. These commands can be used in conjunction with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3046 @key{RET} to look at deleted or refiled messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3047
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3048 @cindex deleting messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3049 @findex mh-delete-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3050 @kindex d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3051 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3052 @kindex p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3053
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3054 To mark a message for deletion, use the command @kbd{d}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3055 (@code{mh-delete-msg}). A @samp{D} is placed by the message in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3056 scan window, and the next undeleted message is displayed. If the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3057 previous command had been @kbd{p}, then the next message displayed is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3058 the first undeleted message previous to the message just deleted. Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3059 @kbd{n} to force subsequent @kbd{d} commands to move forward to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3060 next undeleted message after deleting the message under the cursor.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3061 You may also specify a range (for example, @kbd{C-u d 1 3 5-7 last:5
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3062 frombob @key{RET}}, @pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3063
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3064 @findex mh-delete-msg-no-motion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3065 @kindex C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3066
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3067 The command @kbd{C-d} (@code{mh-delete-msg-no-motion}) marks the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3068 message (or messages in range) for deletion but leaves the cursor at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3069 the current message in case you wish to perform other operations on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3070 the message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3071
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3072 @findex mh-delete-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3073 @findex mh-delete-subject-or-thread
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3074 @findex mh-thread-delete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3075 @findex mh-undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3076 @kindex k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3077 @kindex T d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3078 @kindex u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3079
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3080 And to delete more messages faster, you can use @kbd{k}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3081 (@code{mh-delete-subject-or-thread}) to delete all the messages with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3082 the same subject as the current message. This command puts these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3083 messages in a sequence named @samp{subject}. You can undo this action
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3084 by using @kbd{u} (@code{mh-undo}) with a prefix argument and then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3085 specifying the @samp{subject} sequence. However, if the buffer is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3086 displaying a threaded view of the folder then @kbd{k} behaves like
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3087 @kbd{T d} (@code{mh-thread-delete}). @xref{Threading}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3088
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3089 @findex mh-execute-commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3090 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3091
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3092 However you mark a message for deletion, the command @kbd{x}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3093 (@code{mh-execute-commands}) actually carries out the deletion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3094 (@pxref{Folders}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3095
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3096 @vindex mh-delete-msg-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3097
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3098 The hook @code{mh-delete-msg-hook} is called after you mark a message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3099 for deletion. For example, a past maintainer of MH-E used this once
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3100 when he kept statistics on his mail usage.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3101
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3102 @node Miscellaneous Commands and Options, , Navigating, Reading Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3103 @section Miscellaneous Commands and Options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3104
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3105 This section contains a few more miscellaneous commands and options.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3106
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3107 @cindex editing message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3108 @findex mh-modify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3109 @kindex M
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3110
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3111 There are times when you need to edit a message. For example, you may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3112 need to fix a broken Content-Type header field. You can do this with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3113 the command @kbd{M} (@code{mh-modify}). It displays the raw message in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3114 an editable buffer. When you are done editing, save and kill the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3115 buffer as you would any other.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3116
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3117 @findex mh-kill-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3118 @findex mh-pack-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3119 @vindex mh-do-not-confirm-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3120
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3121 Commands such as @code{mh-pack-folder} prompt to confirm whether to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3122 process outstanding moves and deletes or not before continuing.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3123 Turning on the option @code{mh-do-not-confirm-flag} means that these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3124 actions will be performed---which is usually desired but cannot be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3125 retracted---without question@footnote{In previous versions of MH-E,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3126 this option suppressed the confirmation in @code{mh-kill-folder}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3127 Since this kept most users from setting this option,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3128 @code{mh-kill-folder} was modified in version 6.0 to always ask for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3129 confirmation subject to @code{mh-kill-folder-suppress-prompt-hook}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3130 @xref{Folders}.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3131
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3132 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3133 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3134 @vindex mh-summary-height
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3135
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3136 The option @code{mh-summary-height} controls the number of scan lines
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3137 displayed in the MH-Folder window, including the mode line. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3138 default value of this option is @samp{Automatic} which means that the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3139 MH-Folder buffer will maintain the same proportional size if the frame
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3140 is resized. If you'd prefer a fixed height, then choose the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3141 @samp{Fixed Size} option and enter the number of lines you'd like to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3142 see.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3143
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3144 @vindex mh-bury-show-buffer-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3145
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3146 Normally the buffer for displaying messages is buried at the bottom at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3147 the buffer stack. You may wish to disable this feature by turning off
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3148 the option @code{mh-bury-show-buffer-flag}. One advantage of not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3149 burying the show buffer is that one can delete the show buffer more
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3150 easily in an electric buffer list because of its proximity to its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3151 associated MH-Folder buffer. Try running @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3152 electric-buffer-list} to see what I mean.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3153
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3154 @cindex @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3155 @cindex files, @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3156 @cindex reading mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3157
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3158 Before we leave this section, I'll include a function that I use as a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3159 front end to MH-E@footnote{Stephen Gildea's favorite binding is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3160 @kbd{(global-set-key "\C-cr" 'mh-rmail)}.}. It toggles between your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3161 working window configuration, which may be quite involved---windows
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3162 filled with source, compilation output, man pages, and other
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3163 documentation---and your MH-E window configuration. Like the rest of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3164 the customization described in this section, simply add the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3165 code to @file{~/.emacs}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3166
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3167 @iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3168 @filbreak
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3169 @end iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3170
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3171 @findex mh-rmail, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3172
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3173 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3174 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3175 (defvar my-mh-screen-saved nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3176 "Set to non-@code{nil} when MH-E window configuration shown.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3177 (defvar my-normal-screen nil "Normal window configuration.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3178 (defvar my-mh-screen nil "MH-E window configuration.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3179
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3180 (defun my-mh-rmail (&optional arg)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3181 "Toggle between MH-E and normal screen configurations.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3182 With non-@code{nil} or prefix argument, @i{inc} mailbox as well
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3183 when going into mail."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3184 (interactive "P") ; @r{user callable function, P=prefix arg}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3185 (setq my-mh-screen-saved ; @r{save state}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3186 (cond
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3187 ;; @r{Bring up MH-E screen if arg or normal window configuration.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3188 ;; @r{If arg or +inbox buffer doesn't exist, run mh-rmail.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3189 ((or arg (null my-mh-screen-saved))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3190 (setq my-normal-screen (current-window-configuration))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3191 (if (or arg (null (get-buffer "+inbox")))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3192 (mh-rmail)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3193 (set-window-configuration my-mh-screen))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3194 t) ; @r{set my-mh-screen-saved to @code{t}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3195 ;; @r{Otherwise, save MH-E screen and restore normal screen.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3196 (t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3197 (setq my-mh-screen (current-window-configuration))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3198 (set-window-configuration my-normal-screen)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3199 nil)))) ; @r{set my-mh-screen-saved to nil}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3200
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3201 (global-set-key "\C-x\r" 'my-mh-rmail) ;@r{ call with C-x @key{RET}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3202
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3203 @i{Starting MH-E}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3204
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3205 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3206 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3207
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3208 If you type an argument (@kbd{C-u}) or if @code{my-mh-screen-saved} is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3209 @code{nil} (meaning a non-MH-E window configuration), the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3210 window configuration is saved, either the @samp{+inbox} buffer is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3211 displayed or @code{mh-rmail} is run, and the MH-E window configuration
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3212 is shown. Otherwise, the MH-E window configuration is saved and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3213 original configuration is displayed.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3214
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3215 @node Folders, Sending Mail, Reading Mail, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3216 @chapter Organizing Your Mail with Folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3217
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3218 @cindex @samp{Folder} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3219 @cindex @samp{Message} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3220 @cindex folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3221 @cindex menu, @samp{Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3222 @cindex menu, @samp{Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3223 @cindex using folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3224
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3225 This chapter discusses the things you can do with folders within MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3226 The commands in this chapter are also found in the @samp{Folder} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3227 @samp{Message} menus.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3228
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3229 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3230 @kindex ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3231 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3232 @item ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3233 Display cheat sheet for the MH-E commands (@code{mh-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3234 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3235 @kindex !
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3236 @findex mh-refile-or-write-again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3237 @item !
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3238 Repeat last output command (@code{mh-refile-or-write-again}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3239 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3240 @cindex @samp{Message > Copy Message to Folder...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3241 @cindex menu item, @samp{Message > Copy Message to Folder...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3242 @kindex c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3243 @findex mh-copy-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3244 @item c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3245 Copy range to folder (@code{mh-copy-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3246 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3247 @kindex F ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3248 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3249 @item F ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3250 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3251 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3252 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3253 @kindex F '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3254 @findex mh-index-ticked-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3255 @item F '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3256 Display ticked messages (@code{mh-index-ticked-messages}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3257 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3258 @kindex F c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3259 @findex mh-catchup
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3260 @item F c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3261 Delete range from the @samp{unseen} sequence (@code{mh-catchup}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3262 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3263 @kindex F k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3264 @findex mh-kill-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3265 @item F k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3266 Remove folder (@code{mh-kill-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3267 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3268 @cindex @samp{Folder > List Folders} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3269 @cindex menu item, @samp{Folder > List Folders}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3270 @kindex F l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3271 @findex mh-list-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3272 @item F l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3273 List all folders (@code{mh-list-folders}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3274 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3275 @cindex @samp{Folder > View New Messages} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3276 @cindex menu item, @samp{Folder > View New Messages}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3277 @kindex F n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3278 @findex mh-index-new-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3279 @item F n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3280 Display unseen messages (@code{mh-index-new-messages}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3281 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3282 @cindex @samp{Folder > Pack Folder} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3283 @cindex menu item, @samp{Folder > Pack Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3284 @kindex F p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3285 @findex mh-pack-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3286 @item F p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3287 Pack folder (@code{mh-pack-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3288 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3289 @kindex F q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3290 @findex mh-index-sequenced-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3291 @item F q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3292 Display messages in any sequence (@code{mh-index-sequenced-messages}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3293 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3294 @cindex @samp{Folder > Rescan Folder} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3295 @cindex menu item, @samp{Folder > Rescan Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3296 @kindex F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3297 @findex mh-rescan-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3298 @item F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3299 Rescan folder (@code{mh-rescan-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3300 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3301 @cindex @samp{Folder > Search...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3302 @cindex menu item, @samp{Folder > Search...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3303 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3304 @findex mh-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3305 @item F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3306 Search your MH mail (@code{mh-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3307 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3308 @cindex @samp{Folder > Sort Folder} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3309 @cindex menu item, @samp{Folder > Sort Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3310 @kindex F S
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3311 @findex mh-sort-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3312 @item F S
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3313 Sort folder (@code{mh-sort-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3314 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3315 @kindex F u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3316 @findex mh-undo-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3317 @item F u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3318 Undo all refiles and deletes in the current folder (@code{mh-undo-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3319 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3320 @cindex @samp{Folder > Visit a Folder...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3321 @cindex menu item, @samp{Folder > Visit a Folder...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3322 @kindex F v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3323 @findex mh-visit-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3324 @item F v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3325 Visit folder (@code{mh-visit-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3326 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3327 @cindex @samp{Message > Refile Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3328 @cindex menu item, @samp{Message > Refile Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3329 @kindex o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3330 @findex mh-refile-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3331 @item o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3332 Refile (output) range into folder (@code{mh-refile-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3333 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3334 @cindex @samp{Folder > Quit MH-E} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3335 @cindex menu item, @samp{Folder > Quit MH-E}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3336 @kindex q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3337 @findex mh-quit
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3338 @item q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3339 Quit the current MH-E folder (@code{mh-quit}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3340 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3341 @cindex @samp{Folder > Toggle Show/Folder} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3342 @cindex menu item, @samp{Folder > Toggle Show/Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3343 @kindex t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3344 @findex mh-toggle-showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3345 @item t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3346 Toggle between MH-Folder and MH-Folder Show modes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3347 (@code{mh-toggle-showing}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3348 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3349 @cindex @samp{Message > Undo Delete/Refile} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3350 @cindex menu item, @samp{Message > Undo Delete/Refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3351 @kindex u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3352 @findex mh-undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3353 @item u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3354 Undo pending deletes or refiles in range (@code{mh-undo}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3355 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3356 @cindex @samp{Message > Execute Delete/Refile} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3357 @cindex menu item, @samp{Message > Execute Delete/Refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3358 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3359 @findex mh-execute-commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3360 @item x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3361 Process outstanding delete and refile requests
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3362 (@code{mh-execute-commands}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3363 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3364
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3365 @cindex @samp{mh-folder} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3366 @cindex customization group, @samp{mh-folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3367
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3368 The @samp{mh-folder} customization group is used to tune these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3369 commands.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3370
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3371 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3372 @item mh-new-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3373 Folders searched for the @samp{unseen} sequence (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3374 @code{Inbox}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3375 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3376 @item mh-ticked-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3377 Folders searched for @code{mh-tick-seq} (default: @code{t}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3378 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3379 @item mh-large-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3380 The number of messages that indicates a large folder (default: 200).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3381 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3382 @item mh-recenter-summary-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3383 On means to recenter the summary window (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3384 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3385 @item mh-recursive-folders-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3386 On means that commands which operate on folders do so recursively
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3387 (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3388 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3389 @item mh-sortm-args
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3390 Additional arguments for @command{sortm} (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3391 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3392
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3393 The following hooks are available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3394
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3395 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3396 @item mh-after-commands-processed-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3397 Hook run by @kbd{x} after performing outstanding refile and delete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3398 requests (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3399 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3400 @item mh-before-commands-processed-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3401 Hook run by @kbd{x} before performing outstanding refile and delete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3402 requests (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3403 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3404 @item mh-before-quit-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3405 Hook run by q before quitting MH-E (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3406 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3407 @item mh-folder-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3408 Hook run by @code{mh-folder-mode} when visiting a new folder (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3409 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3410 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3411 @item mh-kill-folder-suppress-prompt-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3412 Abnormal hook run at the beginning of @code{mh-kill-folder} (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3413 @code{'mh-search-p}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3414 @c -------------------------
103407
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3415 @item mh-pack-folder-hook
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3416 Hook run by @code{mh-pack-folder} after renumbering the messages
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3417 (default: @code{nil}).
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3418 @c -------------------------
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3419 @item mh-quit-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3420 Hook run by q after quitting MH-E (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3421 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3422 @item mh-refile-msg-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3423 Hook run by o after marking each message for refiling (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3424 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3425 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3426
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3427 The following faces are available for customizing the appearance of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3428 the MH-Folder buffer. @xref{Scan Line Formats}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3429
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3430 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3431 @item mh-folder-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3432 Recipient face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3433 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3434 @item mh-folder-body
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3435 Body text face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3436 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3437 @item mh-folder-cur-msg-number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3438 Current message number face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3439 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3440 @item mh-folder-date
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3441 Date face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3442 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3443 @item mh-folder-deleted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3444 Deleted message face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3445 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3446 @item mh-folder-followup
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3447 @samp{Re:} face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3448 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3449 @item mh-folder-msg-number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3450 Message number face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3451 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3452 @item mh-folder-refiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3453 Refiled message face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3454 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3455 @vindex mh-scan-format-nmh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3456 @vindex mh-scan-sent-to-me-sender-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3457 @item mh-folder-sent-to-me-hint
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3458 Fontification hint face in messages sent directly to us. The detection
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3459 of messages sent to us is governed by the scan format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3460 @code{mh-scan-format-nmh} and regular expression
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3461 @code{mh-scan-sent-to-me-sender-regexp}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3462 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3463 @vindex mh-scan-format-nmh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3464 @vindex mh-scan-sent-to-me-sender-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3465 @item mh-folder-scan-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3466 Sender face in messages sent directly to us. The detection of messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3467 sent to us is governed by the scan format @code{mh-scan-format-nmh}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3468 and regular expression @code{mh-scan-sent-to-me-sender-regexp}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3469 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3470 @item mh-folder-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3471 Subject face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3472 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3473 @item mh-folder-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3474 Ticked message face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3475 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3476 @item mh-folder-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3477 @samp{To:} face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3478 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3479
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3480 @vindex mh-folder-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3481
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3482 The hook @code{mh-folder-mode-hook} is called when visiting a new
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3483 folder in MH-Folder mode. This could be used to set your own key
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3484 bindings, for example:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3485
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3486 @vindex mh-folder-mode-hook, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3487
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3488 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3489 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3490 (defvar my-mh-init-done nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3491 "Non-@code{nil} when one-time MH-E settings made.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3492
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3493 (defun my-mh-folder-mode-hook ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3494 "Hook to set key bindings in MH-Folder mode."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3495 (if (not my-mh-init-done) ; @r{only need to bind the keys once }
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3496 (progn
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3497 (local-set-key "//" 'my-search-msg)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3498 (local-set-key "b" 'mh-burst-digest) ; @r{better use of @kbd{b}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3499 (setq my-mh-init-done t))))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3500
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3501 (add-hook 'mh-folder-mode-hook 'my-mh-folder-mode-hook)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3502
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3503 (defun my-search-msg ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3504 "Search for a regexp in the current message."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3505 (interactive) ; @r{user function}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3506 (save-window-excursion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3507 (other-window 1) ; @r{go to next window}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3508 (isearch-forward-regexp))) ; @r{string search; hit return}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3509 ; @r{ when done}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3510
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3511 @i{Create additional key bindings via mh-folder-mode-hook}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3512
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3513 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3514 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3515
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3516 @cindex @command{folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3517 @cindex @command{refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3518 @cindex MH commands, @command{folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3519 @cindex MH commands, @command{refile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3520 @findex mh-refile-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3521 @kindex o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3522 @vindex mh-refile-msg-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3523
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3524 MH-E has analogies for each of the MH @command{folder} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3525 @command{refile} commands@footnote{See the sections
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3526 @uref{@value{MH-BOOK-HOME}/fol.html#Youfol, Your Current Folder:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3527 folder} and @uref{@value{MH-BOOK-HOME}/fol.html#Movref, Moving and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3528 Linking Messages: refile} in the MH book.}. To refile a message in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3529 another folder, use the command @kbd{o} (@code{mh-refile-msg})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3530 (mnemonic: ``output''). You are prompted for the folder name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3531 (@pxref{Folder Selection}). Note that this command can also be used to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3532 create folders. If you specify a folder that does not exist, you will
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3533 be prompted to create it. The hook @code{mh-refile-msg-hook} is called
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3534 after a message is marked to be refiled.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3535
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3536 @findex mh-write-msg-to-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3537 @kindex !
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3538
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3539 If you are refiling several messages into the same folder, you can use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3540 the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3541 last refile or write (for the description of @kbd{>}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3542 (@code{mh-write-msg-to-file}), @pxref{Files and Pipes}). You can use a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3543 range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3544 @key{RET}}, @pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3545
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3546 @cindex expunging refiles and deletes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3547 @cindex undoing refiles and deletes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3548 @findex mh-undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3549 @kindex u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3550
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3551 If you've deleted a message or refiled it, but changed your mind, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3552 can cancel the action before you've executed it. Use @kbd{u}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3553 (@code{mh-undo}) to undo a refile on or deletion of a single message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3554 You can also undo refiles and deletes for messages that are found in a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3555 given range (@pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3556
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3557 @findex mh-undo-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3558 @kindex F u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3559
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3560 Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3561 all refiles and deletes in the current folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3562
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3563 @findex mh-execute-commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3564 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3565
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3566 If you've marked messages to be deleted or refiled and you want to go
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3567 ahead and delete or refile the messages, use @kbd{x}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3568 (@code{mh-execute-commands}). Many MH-E commands that may affect the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3569 numbering of the messages (such as @kbd{F r} or @kbd{F p}) will ask if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3570 you want to process refiles or deletes first and then either run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3571 @kbd{x} for you or undo the pending refiles and deletes.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3572
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3573 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3574 @vindex mh-after-commands-processed-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3575 @vindex mh-before-commands-processed-hook
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3576 @vindex mh-current-folder
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3577
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3578 The command @kbd{x} runs @code{mh-before-commands-processed-hook}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3579 before the commands are processed and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3580 @code{mh-after-commands-processed-hook} after the commands are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3581 processed. Variables that are useful with the former hook include
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3582 @code{mh-delete-list} and @code{mh-refile-list} which can be used to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3583 see which changes will be made to the current folder,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3584 @code{mh-current-folder}. Variables that are useful with the latter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3585 hook include @code{mh-folders-changed}, which lists which folders were
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3586 affected by deletes and refiles. This list will always include the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3587 current folder @code{mh-current-folder}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3588
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3589 @findex mh-copy-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3590 @kindex c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3591 @kindex o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3592
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3593 If you wish to copy a message to another folder, you can use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3594 command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3595 to @command{refile}(1)). Like the command @kbd{o}, this command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3596 prompts you for the name of the target folder and you can specify a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3597 range (@pxref{Ranges}). Note that unlike the command @kbd{o}, the copy
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3598 takes place immediately. The original copy remains in the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3599 folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3600
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3601 @cindex junk mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3602 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3603 @cindex MH-Folder Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3604 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3605 @cindex modes, MH-Folder Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3606 @cindex spam
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3607 @findex mh-toggle-showing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3608 @kindex t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3609
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3610 The command @kbd{t} (@code{mh-toggle-showing}) switches between
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3611 MH-Folder mode and MH-Folder Show mode@footnote{For you Emacs wizards,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3612 this is implemented as an Emacs minor mode.}. MH-Folder mode turns off
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3613 the associated show buffer so that you can perform operations on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3614 messages quickly without reading them. This is an excellent way to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3615 prune out your junk mail or to refile a group of messages to another
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3616 folder for later examination.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3617
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3618 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3619 @cindex MH-Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3620 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3621 @cindex modes, MH-Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3622 @cindex moving between messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3623 @kindex t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3624 @vindex mh-recenter-summary-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3625
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3626 When you use @kbd{t} to toggle from MH-Folder Show mode to MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3627 mode, the MH-Show buffer is hidden and the MH-Folder buffer is left
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3628 alone. Setting @code{mh-recenter-summary-flag} to a non-@code{nil}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3629 value causes the toggle to display as many scan lines as possible,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3630 with the cursor at the middle. The effect of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3631 @code{mh-recenter-summary-flag} is rather useful, but it can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3632 annoying on a slow network connection.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3633
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3634 @findex mh-visit-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3635 @kindex F v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3636 @vindex mh-large-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3637
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3638 When you want to read the messages that you have refiled into folders,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3639 use the command @kbd{F v} (@code{mh-visit-folder}) to visit the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3640 folder. You are prompted for the folder name. The folder buffer will
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3641 show just unseen messages if there are any; otherwise, it will show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3642 all the messages in the buffer as long there are fewer than
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3643 @code{mh-large-folder} messages. If there are more, then you are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3644 prompted for a range of messages to scan. You can provide a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3645 argument in order to specify a range of messages to show when you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3646 visit the folder (@pxref{Ranges}). In this case, regions are not used
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3647 to specify the range and @code{mh-large-folder} is ignored. Note that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3648 this command can also be used to create folders. If you specify a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3649 folder that does not exist, you will be prompted to create it.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3650
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3651 @findex mh-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3652 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3653
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3654 If you forget where you've refiled your messages, you can find them
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3655 using @kbd{F s} (@code{mh-search}). @xref{Searching}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3656
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3657 @cindex @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3658 @cindex @samp{unseen} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3659 @cindex sequence, @samp{unseen}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3660 @cindex Unix commands, @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3661 @cindex unseen messages, viewing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3662 @findex mh-index-new-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3663 @kindex F n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3664 @vindex mh-new-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3666 If you use a program such as @command{procmail} to file your incoming
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3667 mail automatically, you can display new, unseen, messages using the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3668 command @kbd{F n} (@code{mh-index-new-messages}). All messages in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3669 @samp{unseen} sequence from the folders in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3670 @code{mh-new-messages-folders} are listed. However, this list of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3671 folders can be overridden with a prefix argument: with a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3672 argument, enter a space-separated list of folders, or nothing to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3673 search all folders.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3674
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3675 @cindex @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3676 @cindex sequence, @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3677 @cindex ticked messages, viewing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3678 @findex mh-index-ticked-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3679 @kindex F '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3680 @vindex mh-ticked-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3681
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3682 If you have ticked messages (@pxref{Sequences}), you can display them
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3683 using the command @kbd{F '} (@code{mh-index-ticked-messages}). All
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3684 messages in the @samp{tick} sequence from the folders in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3685 @code{mh-ticked-messages-folders} are listed. With a prefix argument,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3686 enter a space-separated list of folders, or nothing to search all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3687 folders.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3688
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3689 @findex mh-index-sequenced-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3690 @kindex F q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3691 @vindex mh-new-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3692
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3693 You can display messages in any sequence with the command @kbd{F q}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3694 (@code{mh-index-sequenced-messages}). All messages from the folders in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3695 @code{mh-new-messages-folders} in the sequence you provide are listed.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3696 With a prefix argument, enter a space-separated list of folders at the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3697 prompt, or nothing to search all folders.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3698
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3699 @vindex mh-new-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3700 @vindex mh-recursive-folders-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3701 @vindex mh-ticked-messages-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3702
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3703 Set the options @code{mh-new-messages-folders} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3704 @code{mh-ticked-messages-folders} to @samp{Inbox} to search the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3705 @samp{+inbox} folder or @samp{All} to search all of the top level
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3706 folders. Otherwise, list the folders that should be searched with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3707 @samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3708
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3709 @cindex buffers, @samp{*MH-E Folders*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3710 @cindex @samp{*MH-E Folders*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3711 @findex mh-kill-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3712 @findex mh-list-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3713 @findex mh-pack-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3714 @findex mh-rescan-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3715 @findex mh-sort-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3716 @kindex F k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3717 @kindex F l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3718 @kindex F p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3719 @kindex F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3720 @kindex F S
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3721
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3722 Other commands you can perform on folders include: @kbd{F l}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3723 (@code{mh-list-folders}), to place a listing of all the folders in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3724 your mail directory in a buffer called @samp{*MH-E Folders*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3725 (@pxref{Miscellaneous}); @kbd{F k} (@code{mh-kill-folder}), to remove
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3726 a folder; @kbd{F S} (@code{mh-sort-folder}), to sort the messages by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3727 date (see @command{sortm}(1) to see how to sort by other criteria);
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3728 @kbd{F p} (@code{mh-pack-folder}), to pack a folder, removing gaps
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3729 from the numbering sequence; and @kbd{F r} (@code{mh-rescan-folder}),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3730 to rescan the folder, which is useful to grab all messages in your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3731 @samp{+inbox} after processing your new mail for the first time. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3732 you don't want to rescan the entire folder, the commands @kbd{F r} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3733 @kbd{F p} will accept a range (@pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3734
103407
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3735 @kindex F p
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3736 @vindex mh-pack-folder-hook
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3737
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3738 The command @kbd{F p} runs @code{mh-pack-folder-hook} after
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3739 renumbering the messages. A variable that is useful with this hook
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3740 is @code{mh-current-folder}.
b808aff23253 (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for release 8.2.
Bill Wohler <wohler@newt.com>
parents: 102151
diff changeset
3741
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3742 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3743 @vindex mh-recursive-folders-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3744
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3745 By default, operations on folders work only one level at a time. Set
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3746 @code{mh-recursive-folders-flag} to non-@code{nil} to operate on all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3747 folders. This mostly means that you'll be able to see all your folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3748 when you press @key{TAB} when prompted for a folder name.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3749
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3750 @findex mh-search-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3751 @kindex k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3752 @vindex mh-kill-folder-suppress-prompt-hooks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3753
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3754 The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3755 hook run at the beginning of the command @kbd{k}. The hook functions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3756 are called with no arguments and should return a non-nil value to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3757 suppress the normal prompt when you remove a folder. This is useful
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3758 for folders that are easily regenerated. The default value of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3759 @code{mh-search-p} suppresses the prompt on folders generated by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3760 searching.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3761
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3762 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3763 @center @strong{NOTE}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3764
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3765 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3766 Use this hook with care. If there is a bug in your hook which returns
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3767 @code{t} on @samp{+inbox} and you press @kbd{k} by accident in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3768 @code{+inbox} folder, you will not be happy.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3769 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3770 @sp 1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3771
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3772 @cindex @command{sortm}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3773 @cindex @file{.mh_profile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3774 @cindex files, @file{.mh_profile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3775 @cindex MH commands, @command{sortm}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3776 @cindex MH profile component, @samp{sortm:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3777 @cindex @samp{sortm:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3778 @kindex F S
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3779 @vindex mh-sortm-args
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3780
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3781 The option @code{mh-sortm-args} holds extra arguments to pass on to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3782 the command @command{sortm}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3783 @uref{@value{MH-BOOK-HOME}/sorsor.html, Sorting Messages: sortm} in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3784 MH book.} when a prefix argument is used with @kbd{F S}. Normally
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3785 default arguments to @command{sortm} are specified in the MH profile.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3786 This option may be used to provide an alternate view. For example,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3787 @samp{'(\"-nolimit\" \"-textfield\" \"subject\")} is a useful setting.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3788
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3789 @cindex exiting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3790 @cindex quitting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3791 @findex mh-quit
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3792 @kindex q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3793
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3794 When you want to quit using MH-E and go back to editing, you can use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3795 the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3796 current MH-E folder and restores the buffers that were present when
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3797 you first ran @kbd{M-x mh-rmail}. It also removes any MH-E working
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3798 buffers whose name begins with @samp{ *mh-} or @samp{*MH-E }
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3799 (@pxref{Miscellaneous}). You can later restore your MH-E session by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3800 selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3801 again.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3802
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3803 @findex mh-execute-commands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3804 @kindex q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3805 @vindex mh-before-quit-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3806 @vindex mh-before-quit-hook, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3807 @vindex mh-quit-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3808 @vindex mh-quit-hook, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3809
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3810 The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3811 called by @kbd{q}. The former one is called before the quit occurs, so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3812 you might use it to perform any MH-E operations; you could perform
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3813 some query and abort the quit or call @code{mh-execute-commands}, for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3814 example. The latter is not run in an MH-E context, so you might use it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3815 to modify the window setup. If you find that @kbd{q} buries a lot of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3816 buffers that you would rather remove, you can use both
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3817 @code{mh-before-quit-hook} and @code{mh-quit-hook} to accomplish that.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3818
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3819 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3820 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3821 (defvar my-mh-folder-buffer-to-delete nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3822 "Folder buffer that is being quit.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3823
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3824 (defun my-mh-before-quit-hook ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3825 "Save folder buffer that is to be deleted."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3826 (setq my-mh-folder-buffer-to-delete (current-buffer)))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3827
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3828 (defun my-mh-quit-hook ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3829 "Kill folder buffer rather than just bury it."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3830 (set-buffer my-mh-folder-buffer-to-delete)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3831 (if (get-buffer mh-show-buffer)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3832 (kill-buffer mh-show-buffer))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3833 (kill-buffer (current-buffer)))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3834
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3835 @i{Kill MH-Folder buffer instead of burying it}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3836 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3837 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3838
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3839 @cindex folders, renaming
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3840 @cindex renaming folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3841 @findex dired
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3842 @findex dired-do-rename
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3843
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3844 You can use dired to manipulate the folders themselves. For example, I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3845 renamed my @samp{+out} folder to the more common @samp{+outbox} by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3846 running dired on my mail directory (@kbd{M-x dired RET ~/Mail RET}),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3847 moving my cursor to @samp{out} and using the command @kbd{R}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3848 (@code{dired-do-rename}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3849
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3850 @node Sending Mail, Editing Drafts, Folders, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3851 @chapter Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3852
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3853 @cindex sending mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3854 @findex mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3855 @kindex M-x mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3856
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3857 You can send a mail message in several ways. You can call @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3858 mh-smail} directly, or from the command line like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3859
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3860 @cindex starting from command line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3861
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3862 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3863 $ @kbd{emacs -f mh-smail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3864 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3865
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3866 @findex goto-address-at-point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3867 @vindex mail-user-agent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3868
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3869 There are some commands that need to send a mail message, such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3870 @code{goto-address-at-point}. You can configure Emacs to have these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3871 commands use MH-E by setting the option @code{mail-user-agent} to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3872 @samp{Emacs interface to MH}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3873
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3874 @cindex @samp{Message} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3875 @cindex menu, @samp{Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3876
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3877 From within MH-E's MH-Folder mode, other methods of sending mail are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3878 available as well. These can also be found in the @samp{Message} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3879
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3880 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3881 @cindex @samp{Message > Edit Message Again} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3882 @cindex menu item, @samp{Message > Edit Message Again}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3883 @kindex e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3884 @findex mh-edit-again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3885 @item e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3886 Edit a message to send it again (@code{mh-edit-again}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3887 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3888 @cindex @samp{Message > Re-edit a Bounced Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3889 @cindex menu item, @samp{Message > Re-edit a Bounced Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3890 @kindex E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3891 @findex mh-extract-rejected-mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3892 @item E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3893 Edit a message that was returned by the mail system
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3894 (@code{mh-extract-rejected-mail}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3895 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3896 @cindex @samp{Message > Forward Message...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3897 @cindex menu item, @samp{Message > Forward Message...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3898 @kindex f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3899 @findex mh-forward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3900 @item f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3901 Forward message (@code{mh-forward}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3902 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3903 @cindex @samp{Message > Reply to Message...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3904 @cindex menu item, @samp{Message > Reply to Message...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3905 @kindex r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3906 @findex mh-reply
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3907 @item r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3908 Reply to a message (@code{mh-reply}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3909 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3910 @cindex @samp{Message > Compose a New Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3911 @cindex menu item, @samp{Message > Compose a New Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3912 @kindex s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3913 @findex mh-send
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3914 @item s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3915 Compose a message (@code{mh-send}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3916 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3917 @cindex @samp{Message > Redistribute Message...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3918 @cindex menu item, @samp{Message > Redistribute Message...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3919 @kindex M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3920 @findex mh-redistribute
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3921 @item M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3922 Redistribute a message (@code{mh-redistribute}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3923 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3924 @findex mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3925 @item M-x mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3926 Compose a message with the MH mail system.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3927 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3928 @findex mh-smail-other-window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3929 @item M-x mh-smail-other-window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3930 Compose a message with the MH mail system in other window.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3931 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3932
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3933 @cindex @samp{mh-sending-mail} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3934 @cindex customization group, @samp{mh-sending-mail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3935
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3936 In addition, several options from the @samp{mh-sending-mail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3937 customization group are useful when sending mail or replying to mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3938 They are summarized in the following table.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3939
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3940 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3941 @item mh-compose-forward-as-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3942 On means that messages are forwarded as attachments (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3943 @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3944 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3945 @item mh-compose-letter-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3946 Hook run when starting a new draft (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3947 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3948 @item mh-compose-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3949 On means prompt for header fields when composing a new draft (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3950 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3951 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3952 @item mh-forward-subject-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3953 Format string for forwarded message subject (default: @code{"%s:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3954 %s"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3955 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3956 @item mh-insert-x-mailer-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3957 On means append an @samp{X-Mailer:} header field to the header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3958 (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3959 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3960 @item mh-redist-full-contents-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3961 On means the @command{dist} command needs entire letter for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3962 redistribution (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3963 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3964 @item mh-reply-default-reply-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3965 Sets the person or persons to whom a reply will be sent (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3966 @samp{Prompt}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3967 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3968 @item mh-reply-show-message-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3969 On means the MH-Show buffer is displayed using @kbd{r}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3970 (@code{mh-reply}) (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3971 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3972
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3973 The following hooks are available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3974
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3975 @vtable @code
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3976 @item mh-annotate-msg-hook
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3977 Hook run by @code{mh-annotate-msg} after annotation (default:
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3978 @code{nil}).
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3979 @c -------------------------
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3980 @item mh-forward-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3981 Hook run by @code{mh-forward} on a forwarded letter (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3982 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3983 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3984 @item mh-letter-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3985 Hook run by @code{mh-letter-mode} on a new letter (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3986 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3987 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3988
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3989 @findex mh-annotate-msg
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3990 @vindex mh-annotate-list
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3991 @vindex mh-annotate-msg-hook
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3992 @vindex mh-current-folder
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3993
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3994 A hook that is called whenever a message is sent and after the scan
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3995 lines and message are annotated is @code{mh-annotate-msg-hook}. Hook
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3996 functions can access the current folder name with
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3997 @code{mh-current-folder} and obtain the message numbers of the
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3998 annotated messages with @code{mh-annotate-list}.
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
3999
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
4000 The rest of the functions and options introduced here are explained in
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
4001 more detail in the following sections.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4002
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4003 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4004 * Composing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4005 * Replying::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4006 * Forwarding::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4007 * Redistributing::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4008 * Editing Again::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4009 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4010
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4011 @node Composing, Replying, Sending Mail, Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4012 @section Composing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4013
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4014 @cindex @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4015 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4016 @cindex composing mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4017 @cindex draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4018 @cindex files, @file{.emacs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4019 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4020 @cindex sending mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4021 @findex mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4022 @findex mh-smail-other-window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4023 @kindex M-x mh-smail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4024 @kindex M-x mh-smail-other-window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4025
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4026 Outside of an MH-Folder buffer, you must call either @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4027 mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4028 The former command always creates a two-window layout with the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4029 buffer on top and the draft on the bottom. Use the latter command if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4030 you would rather preserve the window layout. You may find adding the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4031 following key bindings to @file{~/.emacs} useful:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4032
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4033 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4034 (global-set-key "\C-xm" 'mh-smail)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4035 (global-set-key "\C-x4m" 'mh-smail-other-window)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4036 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4037
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4038 @cindex draft folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4039 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4040 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4041 @findex mh-send
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4042 @kindex m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4043
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4044 From within a MH-Folder buffer, you can simply use the command @kbd{m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4045 (@code{mh-send}). However you invoke @code{mh-send}, your letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4046 appears in an Emacs buffer whose mode is MH-Letter (to see what the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4047 buffer looks like, @pxref{Sending Mail Tour}). MH-Letter mode allows
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4048 you to edit your message, to check the validity of the recipients, to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4049 insert attachments and other messages into your message, and to send
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4050 the message. We'll go more into depth about editing a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4051 @dfn{draft}@footnote{I highly recommend that you use a @dfn{draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4052 folder} so that you can edit several drafts in parallel. To do so,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4053 create a folder named @samp{+drafts} for example, and add the profile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4054 component @samp{Draft-Folder: drafts} (see @code{mh-profile}(5)).} (a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4055 message you're composing) in just a moment (@pxref{Editing Drafts}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4056
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4057 @vindex mh-compose-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4058
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4059 If you prefer to be prompted for the recipient and subject fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4060 before the MH-Letter buffer appears, turn on the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4061 @code{mh-compose-prompt-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4062
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4063 @cindex header field, @samp{X-Mailer:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4064 @cindex @samp{X-Mailer:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4065 @vindex mh-insert-x-mailer-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4066
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4067 MH-E adds an @samp{X-Mailer:} header field to the header that includes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4068 the version of MH-E and Emacs that you are using. If you don't want to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4069 participate in our marketing, you can turn off the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4070 @code{mh-insert-x-mailer-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4071
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4072 @cindex @command{repl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4073 @cindex @file{components}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4074 @cindex MH commands, @command{repl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4075 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4076 @cindex Mail mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4077 @cindex files, @file{components}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4078 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4079 @cindex modes, Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4080 @vindex mail-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4081 @vindex mh-letter-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4082 @vindex text-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4083
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4084 Two hooks are provided to run commands on your freshly created draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4085 The first hook, @code{mh-letter-mode-hook}, allows you to do some
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4086 processing before editing a letter@footnote{Actually, because
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4087 MH-Letter mode inherits from Mail mode, the hooks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4088 @code{text-mode-hook} and @code{mail-mode-hook} are run (in that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4089 order) before @code{mh-letter-mode-hook}.}. For example, you may wish
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4090 to modify the header after @command{repl} has done its work, or you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4091 may have a complicated @file{components} file and need to tell MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4092 where the cursor should go. Here's an example of how you would use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4093 this hook.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4094
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4095 @findex mh-insert-signature, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4096
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4097 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4098 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4099 (defvar letter-mode-init-done-flag nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4100 "Non-nil means one-time MH-E settings have been made.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4101
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4102 (defun my-mh-letter-mode-hook ()
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4103 "Prepare letter for editing."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4104 (when (not letter-mode-init-done) ; @r{only need to bind the keys once}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4105 (local-set-key "\C-ctb" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4106 (local-set-key "\C-cti" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4107 (local-set-key "\C-ctf" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4108 (local-set-key "\C-cts" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4109 (local-set-key "\C-ctB" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4110 (local-set-key "\C-ctu" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4111 (local-set-key "\C-ctc" 'add-enriched-text)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4112 (setq letter-mode-init-done t))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4113 (save-excursion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4114 (goto-char (point-max)) ; @r{go to end of message to}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4115 (mh-insert-signature))) ; @r{insert signature}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4116
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4117 @i{Prepare draft for editing via mh-letter-mode-hook}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4118
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4119 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4120 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4121
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4122 The function, @code{add-enriched-text} is defined in the example in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4123 @ref{Adding Attachments}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4124
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4125 @vindex mh-compose-letter-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4126 @vindex mh-letter-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4127
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4128 The second hook, a function really, is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4129 @code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4130 is called just before editing a new message; however, it is the last
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4131 function called before you edit your message. The consequence of this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4132 is that you can write a function to write and send the message for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4133 you. This function is passed three arguments: the contents of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4134 @samp{To:}, @samp{Subject:}, and @samp{Cc:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4135
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4136 @node Replying, Forwarding, Composing, Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4137 @section Replying to Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4138
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4139 @cindex @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4140 @cindex @file{mhl.reply}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4141 @cindex MH commands, @command{mhl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4142 @cindex files, @file{mhl.reply}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4143 @cindex replying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4144 @findex mh-reply
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4145 @kindex r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4146
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4147 To compose a reply to a message, use the @kbd{r} (@code{mh-reply})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4148 command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4149
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4150 When you reply to a message, you are first prompted with @samp{Reply
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4151 to whom?}. You have several choices here.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4152
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4153 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4154 @multitable @columnfractions .20 .80
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4155 @c @headitem Response @tab Reply Goes To
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4156 @c XXX @headitem not yet supported by SourceForge's texi2pdf.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4157 @item @b{Response} @tab @b{Reply Goes To}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4158 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4159 @item @kbd{from}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4160 @tab
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4161 The person who sent the message. This is the default, so @key{RET} is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4162 sufficient.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4163 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4164 @item @kbd{to}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4165 @tab
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4166 Replies to the sender, plus all recipients in the @samp{To:} header field.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4167 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4168 @item @kbd{cc}@*@kbd{all}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4169 @tab
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4170 Forms a reply to the addresses in the @samp{Mail-Followup-To:} header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4171 field if one exists; otherwise forms a reply to the sender, plus all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4172 recipients.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4173 @end multitable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4174 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4175
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4176 @cindex @command{repl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4177 @cindex MH commands, @command{repl}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4178 @vindex mh-reply-default-reply-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4179
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4180 Depending on your answer, @command{repl}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4181 @uref{@value{MH-BOOK-HOME}/reprep.html, Replying to Messages: repl} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4182 the MH book.} is given a different argument to form your reply.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4183 Specifically, a choice of @kbd{from} or none at all runs @samp{repl
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4184 -nocc all}, and a choice of @kbd{to} runs @samp{repl -cc to}. Finally,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4185 either @kbd{cc} or @kbd{all} runs @samp{repl -cc all -nocc me}. If you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4186 find that most of the time you specify one of these choices when you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4187 reply to a message, you can change the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4188 @code{mh-reply-default-reply-to} from its default value of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4189 @samp{Prompt} to one of the choices listed above. You can always edit
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4190 the recipients in the draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4191
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4192 @cindex @samp{repl:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4193 @cindex MH profile component, @samp{repl:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4194 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4195 @cindex MH-Show mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4196 @cindex draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4197 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4198 @cindex modes, MH-Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4199
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4200 Two windows are then created. One window contains the message to which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4201 you are replying in an MH-Show buffer. Your draft, in MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4202 (@pxref{Editing Drafts}), is in the other window. If the reply draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4203 was not one that you expected, check the things that affect the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4204 behavior of @command{repl} which include the @samp{repl:} profile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4205 component and the @file{replcomps} and @file{replgroupcomps} files.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4206
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4207 If you supply a prefix argument (as in @kbd{C-u r}), the message you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4208 are replying to is inserted in your reply after having first been run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4209 through @command{mhl} with the format file @file{mhl.reply}. See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4210 @command{mhl}(1) or the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4211 @uref{@value{MH-BOOK-HOME}/shomes.html#Usisho, Using mhl} in the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4212 book to see how you can modify the default @file{mhl.reply} file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4213
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4214 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4215
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4216 Alternatively, you can customize the option @code{mh-yank-behavior}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4217 and choose one of its @samp{Automatically} variants to do the same
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4218 thing. @xref{Inserting Letter}. If you do so, the prefix argument has
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4219 no effect.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4220
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4221 Another way to include the message automatically in your draft is to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4222 use @samp{repl: -filter repl.filter} in your MH profile.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4223
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4224 @vindex mh-reply-show-message-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4225
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4226 If you include the message automatically, you can hide the MH-Show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4227 buffer by turning off the option @code{mh-reply-show-message-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4228
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4229 If you wish to customize the header or other parts of the reply draft,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4230 please see @command{repl}(1) and @code{mh-format}(5).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4231
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4232 @node Forwarding, Redistributing, Replying, Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4233 @section Forwarding Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4234
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4235 @cindex @command{forw}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4236 @cindex draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4237 @cindex forwarding
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4238 @cindex MH commands, @command{forw}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4239 @findex mh-forward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4240 @kindex f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4241 @vindex mh-forward-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4242
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4243 To forward a message, use the @kbd{f} (@code{mh-forward}) command. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4244 are prompted for the @samp{To:} and @samp{cc:} recipients. You are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4245 given a draft to edit that looks like it would if you had run the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4246 command @command{forw}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4247 @uref{@value{MH-BOOK-HOME}/forfor.html, Forwarding Messages: forw} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4248 the MH book.}. You can then add some text (@pxref{Editing Drafts}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4249 You can forward several messages by using a range (@pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4250 All of the messages in the range are inserted into your draft. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4251 hook @code{mh-forward-hook} is called on the draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4252
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4253 @cindex @file{.mh_profile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4254 @cindex files, @file{.mh_profile}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4255 @cindex MH profile component, @samp{forw:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4256 @cindex @samp{forw:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4257 @vindex mh-compose-forward-as-mime-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4258
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4259 By default, the option @code{mh-compose-forward-as-mime-flag} is on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4260 which means that the forwarded messages are included as attachments.
92984
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4261 These are inline attachments so the forwarded message should appear in
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4262 the body of your recipient's mail program. If you would prefer to
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4263 forward your messages verbatim (as text, inline), then turn off this
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4264 option. Forwarding messages verbatim works well for short, textual
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4265 messages, but your recipient won't be able to view any non-textual
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4266 attachments that were in the forwarded message. Be aware that if you
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4267 have @samp{forw: -mime} in your MH profile, then forwarded messages
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4268 will always be included as attachments regardless of the settings of
46a2b7ab3cd6 (Preface): Add Gnus to requirements.
Bill Wohler <wohler@newt.com>
parents: 87903
diff changeset
4269 @code{mh-compose-forward-as-mime-flag}.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4270
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4271 @vindex mh-forward-subject-format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4272
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4273 The format of the @samp{Subject:} header field for forwarded messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4274 is controlled by the option @code{mh-forward-subject-format}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4275 option is a string which includes two escapes (@samp{%s}). The first
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4276 @samp{%s} is replaced with the sender of the original message, and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4277 second one is replaced with the original @samp{Subject:}. The default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4278 value of @code{"%s: %s"} takes a message with the header:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4279
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4280 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4281 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4282 To: Bill Wohler <wohler@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4283 Subject: Re: 49er football
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4284 From: Greg DesBrisay <gd@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4285 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4286 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4287
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4288 and creates a subject header field of:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4289
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4290 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4291 Subject: Greg DesBrisay: Re: 49er football
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4292 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4293
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4294 @node Redistributing, Editing Again, Forwarding, Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4295 @section Redistributing Your Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4296
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4297 @cindex @command{dist}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4298 @cindex MH commands, @command{dist}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4299 @cindex redistributing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4300 @findex mh-redistribute
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4301 @kindex M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4302
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4303 The command @kbd{M-d} (@code{mh-redistribute}) is similar in function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4304 to forwarding mail, but it does not allow you to edit the message, nor
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4305 does it add your name to the @samp{From:} header field. It appears to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4306 the recipient as if the message had come from the original sender.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4307 When you run this command, you are prompted for the recipients.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4308
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4309 @findex mh-edit-again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4310 @kindex e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4311
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4312 For more information on redistributing messages, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4313 @command{dist}(1). Also investigate the command @kbd{e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4314 (@code{mh-edit-again}) for another way to redistribute messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4315 (@pxref{Editing Again}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4316
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4317 @cindex @command{send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4318 @cindex MH commands, @command{send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4319 @vindex mh-redist-full-contents-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4320
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4321 The option @code{mh-redist-full-contents-flag} must be turned on if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4322 @command{dist}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4323 @uref{@value{MH-BOOK-HOME}/disdis.html, Distributing Messages with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4324 dist} in the MH book.} requires the whole letter for redistribution,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4325 which is the case if @command{send}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4326 @uref{@value{MH-BOOK-HOME}/sensen.html, Sending Some Mail: comp send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4327 in the MH book.} is compiled with the @sc{berk} option (which many
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4328 people abhor). If you find that MH will not allow you to redistribute
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4329 a message that has been redistributed before, turn off this option.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4330
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
4331 The hook @code{mh-annotate-msg-hook} is run after annotating the
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
4332 message and scan line (@pxref{Sending Mail}).
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
4333
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4334 @node Editing Again, , Redistributing, Sending Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4335 @section Editing Old Drafts and Bounced Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4336
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4337 @cindex @file{draft}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4338 @cindex files, @file{draft}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4339 @cindex re-editing drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4340 @findex mh-edit-again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4341 @kindex F v drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4342 @kindex e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4343 @kindex n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4344
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4345 If you don't complete a draft for one reason or another, and if the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4346 draft buffer is no longer available, you can pick your draft up again
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4347 with @kbd{e} (@code{mh-edit-again}). If you don't use a draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4348 folder, your last @file{draft} file will be used. If you use draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4349 folders, you'll need to visit the draft folder with @kbd{F v drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4350 @key{RET}}, use @kbd{n} to move to the appropriate message, and then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4351 use @kbd{e} to prepare the message for editing.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4352
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4353 @kindex e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4354
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4355 The @kbd{e} command can also be used to take messages that were sent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4356 to you and to send them to more people.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4357
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4358 @cindex Mailer-Daemon
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4359 @findex mh-extract-rejected-mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4360 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4361 @kindex E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4362
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4363 Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4364 complained that your mail wasn't posted for some reason or another. In
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4365 this case, use @kbd{E} (@code{mh-extract-rejected-mail}) to prepare
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4366 the message for editing by removing the @i{Mailer-Daemon} envelope and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4367 unneeded header fields. Fix whatever addressing problem you had, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4368 send the message again with @kbd{C-c C-c}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4369
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4370 @node Editing Drafts, Aliases, Sending Mail, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4371 @chapter Editing a Draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4372
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4373 @cindex @samp{Letter} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4374 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4375 @cindex draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4376 @cindex editing draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4377 @cindex menu, @samp{Letter}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4378 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4379
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4380 When you edit a message that you want to send (called a @dfn{draft} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4381 this case), the mode used is MH-Letter. This mode provides several
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4382 commands in addition to the normal Emacs editing commands to help you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4383 edit your draft. These can also be found in the @samp{Letter} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4384
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4385 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4386 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4387 @findex mh-letter-complete-or-space
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4388 @item @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4389 Perform completion or insert space (@code{mh-letter-complete-or-space}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4390 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4391 @kindex M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4392 @findex mh-letter-complete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4393 @item M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4394 Perform completion on header field or word preceding point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4395 (@code{mh-letter-complete}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4396 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4397 @kindex , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4398 @findex mh-letter-confirm-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4399 @item , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4400 Flash alias expansion (@code{mh-letter-confirm-address}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4401 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4402 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4403 @findex mh-letter-next-header-field-or-indent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4404 @item @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4405 Cycle to next field (@code{mh-letter-next-header-field-or-indent}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4406 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4407 @kindex S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4408 @findex mh-letter-previous-header-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4409 @item S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4410 Cycle to the previous header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4411 (@code{mh-letter-previous-header-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4412 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4413 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4414 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4415 @item C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4416 Display cheat sheet for the MH-E commands (@code{mh-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4417 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4418 @cindex @samp{Letter > Send This Draft} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4419 @cindex menu item, @samp{Letter > Send This Draft}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4420 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4421 @findex mh-send-letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4422 @item C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4423 Save draft and send message (@code{mh-send-letter}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4424 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4425 @kindex C-c C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4426 @findex mh-insert-identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4427 @item C-c C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4428 Insert fields specified by the given identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4429 (@code{mh-insert-identity}). @xref{Identities}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4430 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4431 @cindex @samp{Letter > Pull in All Compositions (MH)} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4432 @cindex menu item, @samp{Letter > Pull in All Compositions (MH)}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4433 @kindex C-c C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4434 @findex mh-mh-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4435 @item C-c C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4436 Compose @sc{mime} message from MH-style directives
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4437 (@code{mh-mh-to-mime}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4438 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4439 @kindex C-c C-f C-a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4440 @kindex C-c C-f a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4441 @findex mh-to-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4442 @item C-c C-f C-a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4443 @itemx C-c C-f a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4444 Move to @samp{Mail-Reply-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4445 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4446 @kindex C-c C-f C-b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4447 @kindex C-c C-f b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4448 @item C-c C-f C-b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4449 @itemx C-c C-f b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4450 Move to @samp{Bcc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4451 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4452 @kindex C-c C-f C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4453 @kindex C-c C-f c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4454 @item C-c C-f C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4455 @itemx C-c C-f c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4456 Move to @samp{Cc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4457 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4458 @kindex C-c C-f C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4459 @kindex C-c C-f d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4460 @item C-c C-f C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4461 @itemx C-c C-f d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4462 Move to @samp{Dcc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4463 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4464 @kindex C-c C-f C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4465 @kindex C-c C-f f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4466 @findex mh-to-fcc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4467 @item C-c C-f C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4468 @itemx C-c C-f f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4469 Move to @samp{Fcc:} header field (@code{mh-to-fcc}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4470 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4471 @kindex C-c C-f C-l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4472 @kindex C-c C-f l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4473 @item C-c C-f C-l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4474 @itemx C-c C-f l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4475 Move to @samp{Mail-Followup-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4476 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4477 @kindex C-c C-f C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4478 @kindex C-c C-f m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4479 @item C-c C-f C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4480 @itemx C-c C-f m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4481 Move to @samp{From:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4482 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4483 @kindex C-c C-f C-r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4484 @kindex C-c C-f r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4485 @item C-c C-f C-r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4486 @itemx C-c C-f r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4487 Move to @samp{Reply-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4488 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4489 @kindex C-c C-f C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4490 @kindex C-c C-f s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4491 @item C-c C-f C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4492 @itemx C-c C-f s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4493 Move to @samp{Subject:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4494 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4495 @kindex C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4496 @kindex C-c C-f t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4497 @item C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4498 @itemx C-c C-f t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4499 Move to @samp{To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4500 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4501 @cindex @samp{Letter > Insert a Message...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4502 @cindex menu item, @samp{Letter > Insert a Message...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4503 @kindex C-c C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4504 @findex mh-insert-letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4505 @item C-c C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4506 Insert a message (@code{mh-insert-letter}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4507 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4508 @kindex C-c C-m C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4509 @findex mh-mml-secure-message-encrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4510 @item C-c C-m C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4511 Add tag to encrypt the message (@code{mh-mml-secure-message-encrypt}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4512 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4513 @cindex @samp{Letter > Compose Forward...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4514 @cindex menu item, @samp{Letter > Compose Forward...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4515 @kindex C-c C-m C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4516 @kindex C-c C-m f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4517 @findex mh-compose-forward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4518 @item C-c C-m C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4519 @itemx C-c C-m f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4520 Add tag to forward a message (@code{mh-compose-forward}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4521 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4522 @cindex @samp{Letter > Compose Get File (MH)...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4523 @cindex menu item, @samp{Letter > Compose Get File (MH)...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4524 @kindex C-c C-m C-g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4525 @kindex C-c C-m g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4526 @findex mh-mh-compose-anon-ftp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4527 @item C-c C-m C-g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4528 @itemx C-c C-m g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4529 Add tag to include anonymous ftp reference to a file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4530 (@code{mh-mh-compose-anon-ftp}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4531 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4532 @cindex @samp{Letter > Compose Insertion...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4533 @cindex menu item, @samp{Letter > Compose Insertion...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4534 @kindex C-c C-m C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4535 @kindex C-c C-m i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4536 @findex mh-compose-insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4537 @item C-c C-m C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4538 @itemx C-c C-m i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4539 Add tag to include a file such as an image or sound
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4540 (@code{mh-compose-insertion}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4541 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4542 @cindex @samp{Letter > Pull in All Compositions (MML)} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4543 @cindex menu item, @samp{Letter > Pull in All Compositions (MML)}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4544 @kindex C-c C-m C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4545 @kindex C-c C-m m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4546 @findex mh-mml-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4547 @item C-c C-m C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4548 @itemx C-c C-m m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4549 Compose @sc{mime} message from MML tags (@code{mh-mml-to-mime}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4550 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4551 @kindex C-c C-m C-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4552 @kindex C-c C-m n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4553 @findex mh-mml-unsecure-message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4554 @item C-c C-m C-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4555 @itemx C-c C-m n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4556 Remove any secure message tags (@code{mh-mml-unsecure-message}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4557 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4558 @kindex C-c C-m C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4559 @findex mh-mml-secure-message-sign
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4560 @item C-c C-m C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4561 Add tag to sign the message (@code{mh-mml-secure-message-sign}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4562 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4563 @cindex @samp{Letter > Compose Compressed tar (MH)...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4564 @cindex menu item, @samp{Letter > Compose Compressed tar (MH)...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4565 @kindex C-c C-m C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4566 @kindex C-c C-m t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4567 @findex mh-mh-compose-external-compressed-tar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4568 @item C-c C-m C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4569 @itemx C-c C-m t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4570 Add tag to include anonymous ftp reference to a compressed tar file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4571 (@code{mh-mh-compose-external-compressed-tar}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4572 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4573 @cindex @samp{Letter > Revert to Non-MIME Edit (MH)} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4574 @cindex menu item, @samp{Letter > Revert to Non-MIME Edit (MH)}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4575 @kindex C-c C-m C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4576 @kindex C-c C-m u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4577 @findex mh-mh-to-mime-undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4578 @item C-c C-m C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4579 @itemx C-c C-m u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4580 Undo effects of @kbd{C-c C-e} (@code{mh-mh-to-mime-undo}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4581 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4582 @kindex C-c C-m C-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4583 @kindex C-c C-m x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4584 @findex mh-mh-compose-external-type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4585 @item C-c C-m C-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4586 @itemx C-c C-m x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4587 Add tag to refer to a remote file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4588 (@code{mh-mh-compose-external-type}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4589 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4590 @kindex C-c C-m e e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4591 @findex mh-mml-secure-message-encrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4592 @item C-c C-m e e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4593 Add tag to encrypt the message (@code{mh-mml-secure-message-encrypt}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4594 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4595 @kindex C-c C-m e s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4596 @findex mh-mml-secure-message-signencrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4597 @item C-c C-m e s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4598 Add tag to encrypt and sign the message@*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4599 (@code{mh-mml-secure-message-signencrypt}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4600 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4601 @kindex C-c C-m s e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4602 @findex mh-mml-secure-message-signencrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4603 @item C-c C-m s e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4604 Add tag to encrypt and sign the message@*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4605 (@code{mh-mml-secure-message-signencrypt}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4606 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4607 @kindex C-c C-m s s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4608 @findex mh-mml-secure-message-sign
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4609 @item C-c C-m s s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4610 Add tag to sign the message (@code{mh-mml-secure-message-sign}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4611 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4612 @cindex @samp{Letter > Split Current Line} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4613 @cindex menu item, @samp{Letter > Split Current Line}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4614 @kindex C-c C-o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4615 @findex mh-open-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4616 @item C-c C-o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4617 Insert a newline and leave point before it (@code{mh-open-line}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4618 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4619 @cindex @samp{Letter > Kill This Draft} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4620 @cindex menu item, @samp{Letter > Kill This Draft}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4621 @kindex C-c C-q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4622 @findex mh-fully-kill-draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4623 @item C-c C-q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4624 Quit editing and delete draft message (@code{mh-fully-kill-draft}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4625 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4626 @cindex @samp{Letter > Insert Signature} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4627 @cindex menu item, @samp{Letter > Insert Signature}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4628 @kindex C-c C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4629 @findex mh-insert-signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4630 @item C-c C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4631 Insert signature in message (@code{mh-insert-signature}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4632 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4633 @kindex C-c C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4634 @findex mh-letter-toggle-header-field-display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4635 @item C-c C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4636 Toggle display of header field at point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4637 (@code{mh-letter-toggle-header-field-display}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4638 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4639 @cindex @samp{Letter > Check Recipient} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4640 @cindex menu item, @samp{Letter > Check Recipient}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4641 @kindex C-c C-w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4642 @findex mh-check-whom
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4643 @item C-c C-w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4644 Verify recipients, showing expansion of any aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4645 (@code{mh-check-whom}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4646 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4647 @cindex @samp{Letter > Yank Current Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4648 @cindex menu item, @samp{Letter > Yank Current Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4649 @kindex C-c C-y
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4650 @findex mh-yank-cur-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4651 @item C-c C-y
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4652 Insert the current message into the draft buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4653 (@code{mh-yank-cur-msg}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4654 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4655 @kindex C-c M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4656 @findex mh-insert-auto-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4657 @item C-c M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4658 Insert custom fields if recipient is found in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4659 @code{mh-auto-fields-list} (@code{mh-insert-auto-fields}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4660 @xref{Identities}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4661 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4662
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4663 @cindex @samp{mh-letter} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4664 @cindex customization group, @samp{mh-letter}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4666 Several options from the @samp{mh-letter} customization group are used
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4667 while editing a draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4668
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4669 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4670 @item mh-compose-insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4671 Type of @sc{mime} message tags in messages (default: @samp{MML} if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4672 available; otherwise @samp{MH}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4673 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4674 @item mh-compose-skipped-header-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4675 List of header fields to skip over when navigating in draft (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4676 @code{'("From"} @code{"Organization"} @code{"References"}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4677 @code{"In-Reply-To"} @code{"X-Face"} @code{"Face"}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4678 @code{"X-Image-URL"} @code{"X-Mailer")}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4679 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4680 @item mh-compose-space-does-completion-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4681 On means @key{SPC} does completion in message header (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4682 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4683 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4684 @item mh-delete-yanked-msg-window-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4685 On means delete any window displaying the message (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4686 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4687 @item mh-extract-from-attribution-verb
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4688 Verb to use for attribution when a message is yanked by @kbd{C-c C-y}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4689 (default: @code{"wrote:"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4690 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4691 @item mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4692 String to put before each line of a yanked or inserted message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4693 (default: @code{"> "}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4694 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4695 @item mh-letter-complete-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4696 Function to call when completing outside of address or folder fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4697 (default: @code{ispell-complete-word}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4698 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4699 @item mh-letter-fill-column
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4700 Fill column to use in MH-Letter mode (default: 72).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4701 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4702 @item mh-mml-method-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4703 Default method to use in security tags (default: @samp{PGP (MIME)} if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4704 support for it is available; otherwise @samp{None}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4705 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4706 @item mh-signature-file-name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4707 Source of user's signature (default: @code{"~/.signature"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4708 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4709 @item mh-signature-separator-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4710 On means a signature separator should be inserted (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4711 @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4712 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4713 @item mh-x-face-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4714 File containing X-Face or Face header field to insert in outgoing mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4715 (default: @code{"~/.face"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4716 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4717 @item mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4718 Controls which part of a message is yanked by @kbd{C-c C-y} (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4719 @samp{Body With Attribution}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4720 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4721
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4722 The following hooks are available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4723
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4724 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4725 @item mail-citation-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4726 Hook for modifying a citation just inserted in the mail buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4727 (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4728 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4729 @item mh-before-send-letter-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4730 Hook run at the beginning of the @kbd{C-c C-c} command (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4731 @samp{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4732 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4733 @item mh-mh-to-mime-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4734 Hook run on the formatted letter by @kbd{C-c C-e} (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4735 @samp{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4736 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4737 @item mh-insert-signature-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4738 Hook run by @kbd{C-c C-s} after signature has been inserted (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4739 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4740 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4741
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4742 The following face is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4743
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4744 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4745 @item mh-letter-header-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4746 Editable header field value face in draft buffers.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4747 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4748
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4749 The commands and options introduced here are explained in more
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4750 detail in the following sections.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4751
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4752 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4753 * Editing Message::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4754 * Inserting Letter::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4755 * Inserting Messages::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4756 * Signature::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4757 * Picture::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4758 * Adding Attachments::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4759 * Sending PGP::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4760 * Checking Recipients::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4761 * Sending Message::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4762 * Killing Draft::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4763 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4764
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4765 @node Editing Message, Inserting Letter, Editing Drafts, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4766 @section Editing the Message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4767
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4768 @cindex @samp{Bcc:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4769 @cindex @samp{Cc:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4770 @cindex @samp{Dcc:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4771 @cindex @samp{From:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4772 @cindex @samp{Mail-Followup-To:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4773 @cindex @samp{Mail-Reply-To:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4774 @cindex @samp{Reply-To:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4775 @cindex @samp{Subject:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4776 @cindex @samp{To:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4777 @cindex editing header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4778 @cindex header field, @samp{Bcc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4779 @cindex header field, @samp{Cc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4780 @cindex header field, @samp{Dcc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4781 @cindex header field, @samp{From:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4782 @cindex header field, @samp{Mail-Followup-To:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4783 @cindex header field, @samp{Mail-Reply-To:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4784 @cindex header field, @samp{Reply-To:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4785 @cindex header field, @samp{Subject:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4786 @cindex header field, @samp{To:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4787 @findex mh-to-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4788 @kindex C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4789 @kindex C-c C-f t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4790
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4791 Because the header is part of the message, you can edit the header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4792 fields as you wish. However, several convenience commands exist to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4793 help you create and edit them. For example, the command @kbd{C-c C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4794 C-t} (@code{mh-to-field}; alternatively, @kbd{C-c C-f t}) moves the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4795 cursor to the @samp{To:} header field, creating it if necessary. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4796 commands for moving to the @samp{Cc:}, @samp{Subject:}, @samp{From:},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4797 @samp{Reply-To:}, @samp{Mail-Reply-To:}, @samp{Mail-Followup-To},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4798 @samp{Bcc:}, and @samp{Dcc:} header fields are similar.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4799
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4800 @findex mh-to-fcc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4801 @kindex C-c C-f C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4802 @kindex C-c C-f f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4803
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4804 One command behaves differently from the others, namely, @kbd{C-c C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4805 C-f} (@code{mh-to-fcc}; alternatively, @kbd{C-c C-f f}). This command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4806 will prompt you for the folder name in which to file a copy of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4807 draft. @xref{Folder Selection}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4808
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4809 @findex indent-relative
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4810 @findex mh-letter-next-header-field-or-indent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4811 @findex mh-letter-previous-header-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4812 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4813 @kindex S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4814 @vindex mh-compose-skipped-header-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4815 @vindex mh-letter-header-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4816
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4817 Within the header of the message, the command@* @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4818 (@code{mh-letter-next-header-field-or-indent}) moves between fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4819 that are highlighted with the face @code{mh-letter-header-field},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4820 skipping those fields listed in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4821 @code{mh-compose-skipped-header-fields}. After the last field, this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4822 command then moves point to the message body before cycling back to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4823 the first field. If point is already past the first line of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4824 message body, then this command indents by calling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4825 @code{indent-relative} with the given prefix argument. The command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4826 @kbd{S-@key{TAB}} (@code{mh-letter-previous-header-field}) moves
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4827 backwards between the fields and cycles to the body of the message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4828 after the first field. Unlike the command @key{TAB}, it will always
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4829 take point to the last field from anywhere in the body.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4830
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4831 @cindex alias completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4832 @cindex completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4833 @cindex spell check
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4834 @findex ispell-complete-word
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4835 @findex mh-letter-complete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4836 @findex mh-letter-complete-or-space
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4837 @findex mh-letter-confirm-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4838 @kindex , (comma)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4839 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4840 @kindex M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4841 @vindex mh-alias-flash-on-comma
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4842 @vindex mh-compose-space-does-completion-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4843 @vindex mh-letter-complete-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4844
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4845 If the field contains addresses (for example, @samp{To:} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4846 @samp{Cc:}) or folders (for example, @samp{Fcc:}) then the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4847 @kbd{M-@key{TAB}} (@code{mh-letter-complete}) will provide alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4848 completion (@pxref{Aliases}). In the body of the message,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4849 @kbd{M-@key{TAB}} runs @code{mh-letter-complete-function} instead,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4850 which is set to @samp{'ispell-complete-word} by default. The command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4851 @kbd{M-@key{TAB}} (@code{mh-letter-complete}) takes a prefix argument
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4852 that is passed to the @code{mh-letter-complete-function}. In addition,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4853 turn on the option @code{mh-compose-space-does-completion-flag} to use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4854 the command @key{SPC} (@code{mh-letter-complete-or-space}) to perform
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4855 completion in the header as well; use a prefix argument to specify
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4856 more than one space. Addresses are separated by a comma; when you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4857 press the comma, the command @code{mh-letter-confirm-address} flashes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4858 the alias expansion in the minibuffer if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4859 @code{mh-alias-flash-on-comma} is turned on.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4860
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4861 @c XXX Document the replacement for the inaccessible 'long argument.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4862
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4863 @findex mh-letter-toggle-header-field-display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4864 @kindex C-c C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4865
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4866 Use the command @kbd{C-c C-t}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4867 @code{mh-letter-toggle-header-field-display} to display truncated
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4868 header fields. This command is a toggle so entering it again will hide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4869 the field. This command takes a prefix argument: if negative then the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4870 field is hidden, if positive then the field is displayed (for example,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4871 @kbd{C-u C-c C-t}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4872
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4873 Be sure to leave a row of dashes or a blank line between the header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4874 and the body of the message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4875
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4876 @vindex mh-letter-fill-column
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4877
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4878 The body of the message is edited as you would edit any Emacs buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4879 although there are a few commands and options to assist you. You can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4880 change the fill column in MH-Letter mode with the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4881 @code{mh-letter-fill-column}. By default, this option is 72 to allow
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4882 others to quote your message without line wrapping.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4883
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4884 @cindex filling paragraphs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4885 @cindex paragraphs, filling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4886 @findex fill-paragraph
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4887 @kindex M-q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4888 @vindex mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4889
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4890 You'll often include messages that were sent from user agents that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4891 haven't yet realized that paragraphs consist of more than a single
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4892 line. This makes for long lines that wrap in an ugly fashion. You'll
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4893 find that @kbd{M-q} (@code{fill-paragraph}) works well even on these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4894 quoted messages, even if they are nested, just as long as all of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4895 quotes match the value of @code{mh-ins-buf-prefix} (@pxref{Inserting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4896 Letter}). For example, let's assume you have the following in your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4897 draft:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4898
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4899 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4900 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4901 > Hopefully this gives you an idea of what I'm currently doing. I'm \
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4902 not sure yet whether I'm completely satisfied with my setup, but \
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4903 it's worked okay for me so far.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4904 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4905 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4906
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4907 Running @kbd{M-q} on this paragraph produces:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4908
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4909 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4910 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4911 > Hopefully this gives you an idea of what I'm currently doing. I'm not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4912 > sure yet whether I'm completely satisfied with my setup, but it's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4913 > worked okay for me so far.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4914 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4915 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4916
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4917 @findex mh-open-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4918 @findex open-line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4919 @kindex C-c C-o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4920 @kindex C-o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4921
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4922 The command @kbd{C-c C-o} (@code{mh-open-line}) is similar to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4923 command @kbd{C-o} (@code{open-line}) in that it inserts a newline
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4924 after point. It differs in that it also inserts the right number of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4925 quoting characters and spaces so that the next line begins in the same
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4926 column as it was. This is useful when breaking up paragraphs in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4927 replies. For example, if this command was used when point was after
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4928 the first period in the paragraph above, the result would be this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4929
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4930 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4931 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4932 > Hopefully this gives you an idea of what I'm currently doing.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4933
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4934 > I'm not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4935 > sure yet whether I'm completely satisfied with my setup, but it's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4936 > worked okay for me so far.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4937 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4938 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4939
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4940 @node Inserting Letter, Inserting Messages, Editing Message, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4941 @section Inserting Letter to Which You're Replying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4942
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4943 @cindex inserting messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4944 @cindex replying to messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4945 @cindex yanking messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4946 @findex mh-yank-cur-msg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4947 @kindex C-c C-y
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4948 @vindex mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4949
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4950 It is often useful to insert a snippet of text from a letter that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4951 someone mailed to provide some context for your reply. The command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4952 @kbd{C-c C-y} (@code{mh-yank-cur-msg}) does this by adding an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4953 attribution, yanking a portion of text from the message to which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4954 you're replying, and inserting @code{mh-ins-buf-prefix} (@samp{> })
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4955 before each line.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4956
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4957 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4958 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4959 Michael W Thelen <thelenm@@stop.mail-abuse.org> wrote:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4960
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4961 > Hopefully this gives you an idea of what I'm currently doing. I'm not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4962 > sure yet whether I'm completely satisfied with my setup, but it's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4963 > worked okay for me so far.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4964 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4965 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4966
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4967 @vindex mh-extract-from-attribution-verb
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4968
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4969 The attribution consists of the sender's name and email address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4970 followed by the content of the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4971 @code{mh-extract-from-attribution-verb}. This option can be set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4972 @samp{wrote:}, @samp{a �crit:}, and @samp{schrieb:}. You can also use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4973 the @samp{Custom String} menu item to enter your own verb.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4974
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4975 @vindex mail-citation-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4976 @vindex mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4977 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4978
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4979 The prefix @code{"> "} is the default setting for the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4980 @code{mh-ins-buf-prefix}. I suggest that you not modify this option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4981 since it is used by many mailers and news readers: messages are far
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4982 easier to read if several included messages have all been indented by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4983 the same string. This prefix is not inserted if you use one of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4984 supercite flavors of @code{mh-yank-behavior} or you have added a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4985 @code{mail-citation-hook} as described below.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4986
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4987 @vindex mh-delete-yanked-msg-window-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4988
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4989 You can also turn on the @code{mh-delete-yanked-msg-window-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4990 option to delete the window containing the original message after
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4991 yanking it to make more room on your screen for your reply.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4992
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4993 @cindex Emacs, packages, supercite
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4994 @cindex supercite package
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4995 @kindex r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4996 @vindex mail-citation-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4997 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4998
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4999 You can control how the message to which you are replying is yanked
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5000 into your reply using @code{mh-yank-behavior}. To include the entire
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5001 message, including the entire header, use @samp{Body and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5002 Header}@footnote{If you'd rather have the header cleaned up, use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5003 @kbd{C-u r} instead of @kbd{r} when replying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5004 (@pxref{Replying}).}@footnote{In the past you would use this setting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5005 and set @code{mail-citation-hook} to @samp{supercite}, but this usage
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5006 is now deprecated in favor of the @samp{Invoke supercite} setting.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5007 Use @samp{Body} to yank just the body without the header. To yank only
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5008 the portion of the message following the point, set this option to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5009 @samp{Below Point}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5010
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5011 Choose @samp{Invoke supercite}@footnote{@emph{Supercite} is a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5012 full-bodied, full-featured, citation package that comes standard with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5013 Emacs.} to pass the entire message and header through supercite.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5014
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5015 @vindex mh-extract-from-attribution-verb
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5016
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5017 If the @samp{Body With Attribution} setting is used, then the message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5018 minus the header is yanked and a simple attribution line is added at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5019 the top using the value of the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5020 @code{mh-extract-from-attribution-verb}. This is the default.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5021
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5022 @kindex C-c C-y
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5023 @vindex mh-delete-yanked-msg-window-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5024
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5025 If the @samp{Invoke supercite} or @samp{Body With Attribution}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5026 settings are used, the @samp{-noformat} argument is passed to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5027 @command{repl} program to override a @samp{-filter} or @samp{-format}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5028 argument. These settings also have @samp{Automatically} variants that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5029 perform the action automatically when you reply so that you don't need
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5030 to use @kbd{C-c C-y} at all. Note that this automatic action is only
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5031 performed if the show buffer matches the message being replied to.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5032 People who use the automatic variants tend to turn on the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5033 @code{mh-delete-yanked-msg-window-flag} as well so that the show
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5034 window is never displayed.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5035
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5036 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5037
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5038 If the show buffer has a region, the option @code{mh-yank-behavior} is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5039 ignored unless its value is one of @samp{Attribution} variants in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5040 which case the attribution is added to the yanked region.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5041
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5042 @findex trivial-cite
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5043 @vindex mail-citation-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5044 @vindex mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5045 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5046
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5047 If this isn't enough, you can gain full control over the appearance of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5048 the included text by setting @code{mail-citation-hook} to a function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5049 that modifies it. This hook is ignored if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5050 @code{mh-yank-behavior} is set to one of the supercite flavors.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5051 Otherwise, this option controls how much of the message is passed to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5052 the hook. The function can find the citation between point and mark
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5053 and it should leave point and mark around the modified citation text
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5054 for the next hook function. The standard prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5055 @code{mh-ins-buf-prefix} is not added if this hook is set.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5056
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5057 @cindex Emacs, packages, trivial-cite
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5058 @cindex trivial-cite package
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5059 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5060
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5061 For example, if you use the hook function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5062 @uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5063 @code{trivial-cite}} (which is NOT part of Emacs), set
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5064 @code{mh-yank-behavior} to @samp{Body and Header}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5065
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5066 @node Inserting Messages, Signature, Inserting Letter, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5067 @section Inserting Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5068
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5069 @cindex inserting messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5070 @findex mh-insert-letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5071 @findex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5072 @kindex C-c C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5073 @vindex mh-ins-buf-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5074 @vindex mh-invisible-header-fields-compiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5075 @vindex mh-yank-behavior
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5076
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5077 Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5078 This command prompts you for the folder and message number, which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5079 defaults to the current message in that folder. It then inserts the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5080 messages, indented by @code{mh-ins-buf-prefix} (@samp{> }) unless
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5081 @code{mh-yank-behavior} is set to one of the supercite flavors in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5082 which case supercite is used to format the message. Certain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5083 undesirable header fields (see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5084 @code{mh-invisible-header-fields-compiled}) are removed before
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5085 insertion.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5086
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5087 If given a prefix argument (like @kbd{C-u C-c C-i}), the header is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5088 left intact, the message is not indented, and @samp{> } is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5089 inserted before each line. This command leaves the mark before the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5090 letter and point after it.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5091
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5092 @node Signature, Picture, Inserting Messages, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5093 @section Inserting Your Signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5094
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5095 @cindex signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5096 @findex mh-insert-signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5097 @kindex C-c C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5098
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5099 You can insert your signature at the current cursor location with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5100 command @kbd{C-c C-s} (@code{mh-insert-signature}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5101
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5102 @cindex files, @file{.signature}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5103 @cindex @file{.signature}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5104 @cindex vCard
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5105 @vindex mh-signature-file-name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5106
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5107 By default, the text of your signature is taken from the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5108 @file{~/.signature}. You can read from other sources by changing the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5109 option @code{mh-signature-file-name}. This file may contain a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5110 @dfn{vCard} in which case an attachment is added with the vCard.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5111
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5112 @findex mh-signature-separator-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5113 @vindex mh-signature-file-name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5114 @vindex mh-signature-separator
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5115 @vindex mh-signature-separator-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5116
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5117 The option @code{mh-signature-file-name} may also be a symbol, in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5118 which case that function is called. You may not want a signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5119 separator to be added for you; instead you may want to insert one
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5120 yourself. Options that you may find useful to do this include
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5121 @code{mh-signature-separator} (when inserting a signature separator)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5122 and @code{mh-signature-separator-regexp} (for finding said separator).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5123 The function @code{mh-signature-separator-p}, which reports @code{t}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5124 if the buffer contains a separator, may be useful as well.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5125
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5126 @cindex signature separator
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5127 @vindex mh-signature-separator-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5128
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5129 A signature separator (@code{"-- "}) will be added if the signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5130 block does not contain one and @code{mh-signature-separator-flag} is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5131 on. It is not recommended that you change this option since various
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5132 mail user agents, including MH-E, use the separator to present the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5133 signature differently, and to suppress the signature when replying or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5134 yanking a letter into a draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5135
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5136 @vindex mh-insert-signature-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5137 @vindex mh-signature-file-name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5138
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5139 The hook @code{mh-insert-signature-hook} is run after the signature is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5140 inserted. Hook functions may access the actual name of the file or the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5141 function used to insert the signature with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5142 @code{mh-signature-file-name}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5143
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5144 The signature can also be inserted using Identities.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5145 @xref{Identities}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5146
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5147 @node Picture, Adding Attachments, Signature, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5148 @section Inserting Your Picture
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5149
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5150 @cindex @file{.face}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5151 @cindex files, @file{.face}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5152 @vindex mh-x-face-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5153
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5154 You can insert your picture in the header of your mail message so that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5155 recipients see your face in the @samp{From:} header field if their
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5156 mail user agent is sophisticated enough. In MH-E, this is done by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5157 placing your image in the file named by the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5158 @code{mh-x-face-file} which is @file{~/.face} by default.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5159
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5160 @cindex @samp{Face:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5161 @cindex @samp{X-Face:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5162 @cindex @samp{X-Image-URL:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5163 @cindex header field, @samp{Face:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5164 @cindex header field, @samp{X-Face:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5165 @cindex header field, @samp{X-Image-URL:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5166
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5167 If the file starts with either of the strings @samp{X-Face:},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5168 @samp{Face:} or @samp{X-Image-URL:} then the contents are added to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5169 message header verbatim. Otherwise it is assumed that the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5170 contains the value of the @samp{X-Face:} header field.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5171
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5172 @cindex @command{compface}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5173 @cindex Unix commands, @command{compface}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5174
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5175 The @samp{X-Face:} header field, which is a low-resolution, black and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5176 white image, can be generated using the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5177 @uref{ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.Z,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5178 @command{compface}} command. The @uref{http://www.dairiki.org/xface/,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5179 @cite{Online X-Face Converter}} is a useful resource for quick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5180 conversion of images into @samp{X-Face:} header fields.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5181
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5182 Use the @uref{http://quimby.gnus.org/circus/face/make-face,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5183 @command{make-face}} script to convert a JPEG image to the higher
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5184 resolution, color, @samp{Face:} header field.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5185
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5186 The URL of any image can be used for the @samp{X-Image-URL:} field and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5187 no processing of the image is required.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5188
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5189 @vindex mh-x-face-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5190
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5191 To prevent the setting of any of these header fields, either set
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5192 @code{mh-x-face-file} to @code{nil}, or simply ensure that the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5193 defined by this option doesn't exist.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5194
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5195 @xref{Viewing}, to see how these header fields are displayed in MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5196
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5197 @node Adding Attachments, Sending PGP, Picture, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5198 @section Adding Attachments
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5199
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5200 @cindex @command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5201 @cindex @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5202 @cindex MH commands, @command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5203 @cindex MH commands, @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5204 @cindex MIME
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5205 @cindex multimedia mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5206
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5207 MH-E has the capability to create multimedia messages. It uses the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5208 @sc{mime} (Multipurpose Internet Mail Extensions)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5209 protocol@footnote{@sc{mime} is defined in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5210 @uref{http://www.rfc-editor.org/rfc/rfc2045.txt, RFC 2045}.} The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5211 @sc{mime} protocol allows you to incorporate images, sound, video,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5212 binary files, and even commands that fetch a file with @samp{ftp} when
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5213 your recipient reads the message!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5214
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5215 @kindex C-c C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5216
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5217 If you were to create a multimedia message with plain MH commands, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5218 would insert @command{mhbuild} or @command{mhn} directives (henceforth
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5219 called @dfn{MH-style directives} into your draft and use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5220 @command{mhbuild} command in nmh or @command{mhn} command in MH and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5221 GNU mailutils to expand them. MH-E works in much the same way,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5222 although it provides a handful of commands prefixed with @kbd{C-c C-m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5223 to insert the directives so you don't need to remember the syntax of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5224 them. Remember: you can always add MH-style directives by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5225 hand@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5226 @uref{@value{MH-BOOK-HOME}/usimim.html#SeMIMa, Sending MIME Mail} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5227 the MH book.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5228
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5229 @cindex MIME Meta Language (MML)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5230 @cindex MML
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5231 @vindex mh-compose-insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5232
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5233 In addition to MH-style directives, MH-E also supports MML (@sc{mime}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5234 Meta Language) tags@footnote{
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5235 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5236 @c Although the third argument should default to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5237 @c first, makeinfo goes to the wrong Info file without it being
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5238 @c different--it seems to be getting our own Composing node.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5239 @xref{Composing,,Composing with MML,emacs-mime}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5240 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5241 @ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5242 See the section Composing in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5243 @uref{http://www.gnus.org/manual/emacs-mime.html, @cite{The Emacs MIME
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5244 Manual}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5245 @end ifnotinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5246 }. The option @code{mh-compose-insertion} can be used to choose
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5247 between them. By default, this option is set to @samp{MML} if it is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5248 supported since it provides a lot more functionality. This option can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5249 also be set to @samp{MH} if MH-style directives are preferred.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5250
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5251 @cindex media types
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5252 @cindex MIME, media types
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5253
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5254 The MH-E @sc{mime} commands require a @dfn{media type} for each body
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5255 part or attachment. For example, a PDF document is of type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5256 @samp{application/pdf} and an HTML document is of type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5257 @samp{text/html}. Some commands fill in the media type for you,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5258 whereas others require you to enter one.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5259
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5260 @cindex @command{file}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5261 @cindex @file{/etc/mime.types}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5262 @cindex files, @file{/etc/mime.types}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5263 @cindex Unix commands, @command{file}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5264 @findex mailcap-mime-types
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5265
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5266 In the cases where MH-E can do so, it will determine the media type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5267 automatically. It uses the @command{file} command to do this. Failing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5268 that, the Emacs function @code{mailcap-mime-types} is used to provide
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5269 a list from which to choose. This function usually reads the file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5270 @file{/etc/mime.types}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5271
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5272 Whether the media type is chosen automatically, or you choose it from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5273 a list, use the type that seems to match best the file that you are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5274 including. In the case of binaries, the media type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5275 @samp{application/x-executable} can be useful. If you can't find an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5276 appropriate media type, use @samp{text/plain} for text messages and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5277 @samp{application/octet-stream} for everything else.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5278
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5279 @cindex content description
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5280 @cindex MIME, content description
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5281
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5282 You are also sometimes asked for a @dfn{content description}. This is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5283 simply an optional brief phrase, in your own words, that describes the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5284 object. If you don't care to enter a content description, just press
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5285 return and none will be included; however, a reader may skip over
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5286 multimedia fields unless the content description is compelling.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5287
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5288 You can also create your own @sc{mime} body parts. In the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5289 example, I describe how you can create and edit a @samp{text/enriched}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5290 body part to liven up your plain text messages with boldface,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5291 underlining, and italics. I include an Emacs function which inserts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5292 enriched text tags.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5293
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5294 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5295 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5296 (defvar enriched-text-types '(("b" . "bold") ("i" . "italic")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5297 ("u" . "underline")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5298 ("s" . "smaller") ("B" . "bigger")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5299 ("f" . "fixed")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5300 ("c" . "center"))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5301 "Alist of (final-character . tag) choices for add-enriched-text.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5302 Additional types can be found in RFC 1563.")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5303
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5304 (defun add-enriched-text (begin end)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5305 "Add enriched text tags around region.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5306 The tag used comes from the list enriched-text-types and is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5307 specified by the last keystroke of the command. When called from Lisp,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5308 arguments are BEGIN and END@."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5309 (interactive "r")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5310 ;; @r{Set type to the tag indicated by the last keystroke.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5311 (let ((type (cdr (assoc (char-to-string (logior last-input-char ?@w{`}))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5312 enriched-text-types))))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5313 (save-restriction ; @r{restores state from narrow-to-region}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5314 (narrow-to-region begin end) ; @r{narrow view to region}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5315 (goto-char (point-min)) ; @r{move to beginning of text}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5316 (insert "<" type ">") ; @r{insert beginning tag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5317 (goto-char (point-max)) ; @r{move to end of text}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5318 (insert "</" type ">")))) ; @r{insert terminating tag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5319 @i{Emacs function for entering enriched text}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5320
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5321 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5322 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5323
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5324 To use the function @code{add-enriched-text}, first add it to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5325 @file{~/.emacs} and create key bindings for it (@pxref{Composing}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5326
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5327 Then, in your plain text message, set the mark with @kbd{C-@@} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5328 @kbd{C-@key{SPC}}, type in the text to be highlighted, and type @kbd{C-c t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5329 b}. This adds @samp{<bold>} where you set the mark and adds
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5330 @samp{</bold>} at the location of your cursor, giving you something
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5331 like: @samp{You should be <bold>very</bold>}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5332
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5333 Before sending this message, use @kbd{C-c C-m C-m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5334 (@code{mh-mml-to-mime})@footnote{Use @kbd{C-c C-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5335 (@code{mh-mh-to-mime}) if you're using MH-style directives.} to add
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5336 MIME header fields. Then replace @samp{text/plain} with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5337 @samp{text/enriched} in the @samp{Content-Type:} header field.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5338
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5339 You may also be interested in investigating @code{sgml-mode}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5340
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5341 @subheading Including Files
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5342
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5343 @cindex attachments, inserting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5344 @cindex images
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5345 @cindex MIME, images
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5346 @cindex MIME, sound
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5347 @cindex MIME, video
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5348 @cindex sound
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5349 @cindex video
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5350 @findex mh-compose-insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5351 @kindex C-c C-m C-i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5352 @kindex C-c C-m i
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5353 @vindex mh-compose-insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5354
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5355 Binaries, images, sound, and video can be inserted in your message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5356 with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5357 are prompted for the filename containing the object, the media type if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5358 it cannot be determined automatically, and a content description. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5359 you're using MH-style directives, you will also be prompted for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5360 additional attributes.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5361
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5362 @subheading Forwarding Multimedia Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5363
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5364 @findex mh-compose-forward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5365 @kindex C-c C-m C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5366 @kindex C-c C-m f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5367
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5368 Mail may be forwarded with @sc{mime} using the command @kbd{C-c C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5369 C-f} (@code{mh-compose-forward}). You are prompted for a content
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5370 description, the name of the folder in which the messages to forward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5371 are located, and a range of messages, which defaults to the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5372 message in that folder. @xref{Ranges}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5373
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5374 @subheading Including an FTP Reference
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5375
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5376 @cindex @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5377 @cindex MIME, @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5378 @cindex Unix commands, @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5379 @findex mh-mh-compose-anon-ftp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5380 @kindex C-c C-m C-g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5381 @kindex C-c C-m g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5382
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5383 You can have your message initiate an @command{ftp} transfer when the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5384 recipient reads the message. To do this, use the command @kbd{C-c C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5385 C-g} (@code{mh-mh-compose-anon-ftp}). You are prompted for the remote
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5386 host and filename, the media type, and the content description.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5387
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5388 @subheading Including tar Files
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5389
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5390 @cindex @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5391 @cindex @command{tar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5392 @cindex MIME, @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5393 @cindex MIME, @command{tar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5394 @cindex Unix commands, @command{ftp}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5395 @cindex Unix commands, @command{tar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5396 @findex mh-mh-compose-anon-ftp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5397 @findex mh-mh-compose-external-compressed-tar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5398 @kindex C-c C-m C-g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5399 @kindex C-c C-m C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5400 @kindex C-c C-m t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5401
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5402 If the remote file is a compressed tar file, you can use @kbd{C-c C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5403 C-t} (@code{mh-mh-compose-external-compressed-tar}). Then, in addition
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5404 to retrieving the file via anonymous @emph{ftp} as per the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5405 @kbd{C-c C-m C-g} (@code{mh-mh-compose-anon-ftp}), the file will also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5406 be uncompressed and untarred. You are prompted for the remote host and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5407 filename and the content description.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5408
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5409 @subheading Including Other External Files
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5410
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5411 @findex mh-mh-compose-external-type
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5412 @kindex C-c C-m C-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5413 @kindex C-c C-m x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5414
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5415 The command @kbd{C-c C-m C-x} (@code{mh-mh-compose-external-type}) is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5416 a general utility for referencing external files. In fact, all of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5417 other commands that insert tags to access external files call this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5418 command. You are prompted for the access type, remote host and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5419 filename, and content type. If you provide a prefix argument, you are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5420 also prompted for a content description, attributes, parameters, and a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5421 comment.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5422
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5423 @subheading Previewing Multimedia Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5424
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5425 When you are finished editing a @sc{mime} message, it might look like this:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5426
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5427 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5428 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5429 3 t08/24 root received fax files on Wed Aug 24 11:00:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5430 4+t08/24 To:wohler Test<<This is a test message to get the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5431
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5432
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5433
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5434
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5435
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5436 --:%% @{+inbox@} 4 msgs (1-4) Bot L4 (MH-Folder Show)---------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5437 To: wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5438 cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5439 Subject: Test of MIME
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5440 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5441 Here is the SETI@@Home logo:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5442
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5443 <#part type="image/x-xpm" filename="~/lib/images/setiathome.xpm"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5444 disposition=inline description="SETI@@home logo">
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5445 <#/part>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5446 --:** @{draft@} All L8 (MH-Letter)----------------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5447
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5448 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5449 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5450 @i{MH-E @sc{mime} draft}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5451
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5452 @findex mh-mml-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5453 @kindex C-c C-m C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5454 @kindex C-c C-m m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5455
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5456 Typically, you send a message with attachments just like any other
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5457 message (@pxref{Sending Message}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5458
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5459 @findex mh-mml-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5460 @kindex C-c C-m C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5461
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5462 However, you may take a sneak preview of the @sc{mime} encoding if you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5463 wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5464 The following screen shows the @sc{mime} encoding specified by the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5465 tags. You can see why mail user agents are usually built to hide these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5466 details from the user.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5467
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5468 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5469 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5470 To: wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5471 cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5472 Subject: Test of MIME
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
5473 X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5474 MIME-Version: 1.0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5475 Content-Type: multipart/mixed; boundary="=-=-="
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5476 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5477 --=-=-=
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5478
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5479 Here is the SETI@@Home logo:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5480
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5481
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5482 --=-=-=
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5483 Content-Type: image/x-xpm
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5484 Content-Disposition: inline; filename=setiathome.xpm
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5485 Content-Transfer-Encoding: base64
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5486 Content-Description: SETI@@home logo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5487
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5488 LyogWFBNICovCnN0YXRpYyBjaGFyICogc2V0aWF0aG9tZV94cG1bXSA9IHsKIjQ1IDQ1IDc2N
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5489 --:-- @{draft@} Top L1 (MH-Letter)----------------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5490
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5491 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5492 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5493 @i{MH-E @sc{mime} draft ready to send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5494
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5495 @cindex undo effects of mh-mml-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5496
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5497 This action can be undone by running @kbd{C-_} (@code{undo}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5498
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5499 @cindex @command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5500 @cindex @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5501 @cindex MH commands, @command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5502 @cindex MH commands, @command{mhn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5503 @cindex undo effects of mh-mh-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5504 @findex mh-mh-to-mime
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5505 @findex mh-mh-to-mime-undo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5506 @kindex C-c C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5507 @kindex C-c C-m C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5508 @kindex C-c C-m C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5509 @kindex C-c C-m u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5510
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5511 If you're using MH-style directives, use @kbd{C-c C-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5512 (@code{mh-mh-to-mime}) instead of @kbd{C-c C-m C-m}. This runs the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5513 command @command{mhbuild} (@command{mhn}) on the message which expands
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5514 the tags@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5515 @uref{@value{MH-BOOK-HOME}/usimim.html#SeMIMa, Sending MIME Mail} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5516 the MH book.}. This action can be undone by running @kbd{C-c C-m C-u}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5517 (@code{mh-mh-to-mime-undo}), which works by reverting to a backup
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5518 file. You are prompted to confirm this action, but you can avoid the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5519 confirmation by adding an argument (for example, @kbd{C-u C-c C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5520 C-u}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5521
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5522 @kindex C-c C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5523 @vindex mh-mh-to-mime-args
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5524
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5525 If you wish to pass additional arguments to @command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5526 (@command{mhn}) to affect how it builds your message, use the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5527 @code{mh-mh-to-mime-args}. For example, you can build a consistency
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5528 check into the message by setting @code{mh-mh-to-mime-args} to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5529 @samp{-check}. The recipient of your message can then run
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5530 @samp{mhbuild -check} on the message---@command{mhbuild}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5531 (@command{mhn}) will complain if the message has been corrupted on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5532 way. The command @kbd{C-c C-e} only consults this option when given a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5533 prefix argument (as in @kbd{C-u C-c C-e}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5534
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5535 @kindex C-c C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5536 @vindex mh-mh-to-mime-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5537
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5538 The hook @code{mh-mh-to-mime-hook} is called after the message has
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5539 been formatted by @kbd{C-c C-e}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5540
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5541 @node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5542 @section Signing and Encrypting Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5543
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5544 @cindex signing messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5545 @cindex encrypting messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5546 @cindex RFC 3156
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5547
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5548 MH-E can sign and encrypt messages as defined in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5549 @uref{http://www.rfc-editor.org/rfc/rfc3156.txt, RFC 3156}. If you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5550 should choose to sign or encrypt your message, use one of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5551 following commands to do so any time before sending your message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5552
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5553 @findex mh-mml-secure-message-encrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5554 @findex mh-mml-secure-message-sign
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5555 @findex mh-mml-secure-message-signencrypt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5556 @kindex C-c C-m C-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5557 @kindex C-c C-m C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5558 @kindex C-c C-m e e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5559 @kindex C-c C-m e s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5560 @kindex C-c C-m s e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5561 @kindex C-c C-m s s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5562
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5563 The command @kbd{C-c C-m C-s} (@code{mh-mml-secure-message-sign})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5564 inserts the following tag:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5565
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5566 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5567 <#secure method=pgpmime mode=sign>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5568 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5569
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5570 This is used to sign your message digitally. Likewise, the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5571 @kbd{C-c C-m C-e} (@code{mh-mml-secure-message-encrypt}) inserts the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5572 following tag:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5573
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5574 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5575 <#secure method=pgpmime mode=encrypt>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5576 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5577
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5578 This is used to encrypt your message. Finally, the command @kbd{C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5579 C-m s e} (@code{mh-mml-secure-message-signencrypt}) inserts the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5580 following tag:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5581
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5582 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5583 <#secure method=pgpmime mode=signencrypt>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5584 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5585
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5586 @findex mh-mml-unsecure-message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5587 @kindex C-c C-m C-n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5588 @kindex C-c C-m n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5589 @vindex mh-mml-method-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5590
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5591 This is used to sign and encrypt your message. In each of these cases,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5592 a proper multipart message is created for you when you send the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5593 message. Use the command @kbd{C-c C-m C-n}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5594 (@code{mh-mml-unsecure-message}) to remove these tags. Use a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5595 argument (as in @kbd{C-u C-c C-m s e}) to be prompted for one of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5596 possible security methods (see @code{mh-mml-method-default}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5597
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5598 @vindex mh-mml-method-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5599
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5600 The option @code{mh-mml-method-default} is used to select between a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5601 variety of mail security mechanisms. The default is @samp{PGP (MIME)}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5602 if it is supported; otherwise, the default is @samp{None}. Other
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5603 mechanisms include vanilla @samp{PGP} and @samp{S/MIME}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5604
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5605 @cindex @samp{pgg} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5606 @cindex PGG
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5607 @cindex customization group, @samp{pgg}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5608
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5609 The @samp{pgg} customization group may have some settings which may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5610 interest you.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5611 @iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5612 See @cite{The PGG Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5613 @end iftex
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5614 @ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5615 @xref{Top, , The PGG Manual, pgg, The PGG Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5616 @end ifinfo
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5617 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5618 See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5619 @uref{http://www.dk.xemacs.org/Documentation/packages/html/pgg.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5620 @cite{The PGG Manual}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5621 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5622
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5623 @cindex header field, @samp{Fcc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5624 @cindex @samp{Fcc:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5625 @vindex pgg-encrypt-for-me
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5626
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5627 In particular, I turn on the option @code{pgg-encrypt-for-me} so that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5628 all messages I encrypt are encrypted with my public key as well. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5629 you keep a copy of all of your outgoing mail with a @samp{Fcc:} header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5630 field, this setting is vital so that you can read the mail you write!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5631
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5632 @node Checking Recipients, Sending Message, Sending PGP, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5633 @section Checking Recipients
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5634
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5635 @cindex @samp{*MH-E Recipients*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5636 @cindex @command{whom}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5637 @cindex MH commands, @command{whom}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5638 @cindex buffers, @samp{*MH-E Recipients*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5639 @cindex checking recipients
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5640 @cindex recipients, checking
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5641 @findex mh-check-whom
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5642 @kindex C-c C-w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5643
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5644 The command @kbd{C-c C-w} (@code{mh-check-whom}) expands aliases so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5645 you can check the actual address(es) in the alias. A new buffer named
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5646 @samp{*MH-E Recipients*} is created with the output of @command{whom}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5647 (@pxref{Miscellaneous})@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5648 @uref{@value{MH-BOOK-HOME}/senove.html#WhaPro, What now? -- and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5649 whatnow Program} in the MH book.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5650
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5651 @node Sending Message, Killing Draft, Checking Recipients, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5652 @section Sending a Message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5653
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5654 @cindex buffers, @samp{*MH-E Mail Delivery*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5655 @cindex @samp{*MH-E Mail Delivery*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5656 @cindex sending mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5657 @findex mh-send-letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5658 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5659
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5660 When you are all through editing a message, you send it with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5661 command @kbd{C-c C-c} (@code{mh-send-letter}). You can give a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5662 argument (as in @kbd{C-u C-c C-c}) to monitor the first stage of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5663 delivery; this output can be found in a buffer called @samp{*MH-E Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5664 Delivery*} (@pxref{Miscellaneous}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5666 @cindex sending mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5667 @cindex spell check
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5668 @findex ispell-message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5669 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5670 @vindex mh-before-send-letter-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5671
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5672 The hook @code{mh-before-send-letter-hook} is run at the beginning of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5673 the command @kbd{C-c C-c}. For example, if you want to check your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5674 spelling in your message before sending, add the function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5675 @code{ispell-message}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5676
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5677 @cindex @command{send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5678 @cindex MH commands, @command{send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5679 @vindex mh-send-prog
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5680
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5681 In case the MH @command{send} program@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5682 @uref{@value{MH-BOOK-HOME}/sensen.html, Sending Some Mail: comp send}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5683 in the MH book.} is installed under a different name, use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5684 @code{mh-send-prog} to tell MH-E the name.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5685
97192
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
5686 The hook @code{mh-annotate-msg-hook} is run after annotating the
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
5687 message and scan line (@pxref{Sending Mail}).
31496191ccd4 (Reading Mail)
Bill Wohler <wohler@newt.com>
parents: 95925
diff changeset
5688
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5689 @node Killing Draft, , Sending Message, Editing Drafts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5690 @section Killing the Draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5691
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5692 @cindex killing draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5693 @findex kill-buffer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5694 @findex mh-fully-kill-draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5695 @kindex C-c C-q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5696 @kindex C-x k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5697
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5698 If for some reason you are not happy with the draft, you can use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5699 command @kbd{C-c C-q} (@code{mh-fully-kill-draft}) to kill the draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5700 buffer and delete the draft message. Use the command @kbd{C-x k}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5701 (@code{kill-buffer}) if you don't want to delete the draft message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5702
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5703 @node Aliases, Identities, Editing Drafts, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5704 @chapter Aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5705
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5706 @cindex aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5707
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5708 MH aliases are used in the same way in MH-E as they are in MH. Any
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5709 alias listed as a recipient will be expanded when the message is sent.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5710 This chapter discusses other things you can do with aliases in MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5711
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5712 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5713 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5714
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5715 The following commands are available in MH-Letter mode with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5716 exception of @code{mh-alias-reload} which can be called from anywhere.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5717
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5718 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5719 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5720 @findex mh-letter-complete-or-space
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5721 @item @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5722 Perform completion or insert space (@code{mh-letter-complete-or-space}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5723 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5724 @kindex M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5725 @findex mh-letter-complete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5726 @item M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5727 Perform completion on header field or word preceding point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5728 (@code{mh-letter-complete}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5729 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5730 @findex mh-alias-apropos
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5731 @item mh-alias-apropos
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5732 Show all aliases or addresses that match a regular expression.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5733 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5734 @findex mh-alias-grab-from-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5735 @item mh-alias-grab-from-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5736 Add alias for the sender of the current message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5737 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5738 @findex mh-alias-reload
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5739 @item mh-alias-reload
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5740 Reload MH aliases.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5741 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5742
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5743 @cindex @samp{mh-alias} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5744 @cindex customization group, @samp{mh-alias}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5745
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5746 The @samp{mh-alias} customization group contains options associated
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5747 with aliases.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5748
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5749 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5750 @item mh-alias-completion-ignore-case-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5751 On means don't consider case significant in MH alias completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5752 (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5753 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5754 @item mh-alias-expand-aliases-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5755 On means to expand aliases entered in the minibuffer (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5756 @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5757 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5758 @item mh-alias-flash-on-comma
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5759 Specify whether to flash address or warn on translation (default: @samp{Flash
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5760 but Don't Warn If No Alias}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5761 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5762 @item mh-alias-insert-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5763 Filename used to store a new MH-E alias (default: @samp{Use Aliasfile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5764 Profile Component}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5765 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5766 @item mh-alias-insertion-location
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5767 Specifies where new aliases are entered in alias files (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5768 @samp{Alphabetical}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5769 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5770 @item mh-alias-local-users
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5771 If @samp{on}, local users are added to alias completion (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5772 @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5773 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5774 @item mh-alias-local-users-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5775 String prefixed to the real names of users from the password file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5776 (default: @code{"local."}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5777 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5778 @item mh-alias-passwd-gecos-comma-separator-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5779 On means the GECOS field in the password file uses a comma separator
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5780 (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5781 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5782
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5783 The following hook is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5784
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5785 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5786 @item mh-alias-reloaded-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5787 Hook run by @code{mh-alias-reload} after loading aliases (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5788 @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5789 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5790
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5791 @subheading Adding Addresses to Draft
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5792
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5793 You can use aliases when you are adding recipients to a message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5794
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5795 @findex minibuffer-complete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5796 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5797 @vindex mh-alias-expand-aliases-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5798 @vindex mh-compose-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5799
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5800 In order to use minibuffer prompting for recipients and the subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5801 line in the minibuffer, turn on the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5802 @code{mh-compose-prompt-flag} (@pxref{Composing}), and use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5803 @key{TAB} (@code{minibuffer-complete}) command to complete aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5804 (and optionally local logins) when prompted for the recipients. Turn
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5805 on the option @code{mh-alias-expand-aliases-flag} if you want these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5806 aliases to be expanded to their respective addresses in the draft.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5807
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5808 @findex mh-letter-complete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5809 @findex mh-letter-complete-or-space
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5810 @kindex @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5811 @kindex M-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5812
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5813 Otherwise, you can complete aliases in the header of the draft with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5814 @kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5815 (@code{mh-letter-complete-or-space}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5816
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5817 @vindex mh-alias-completion-ignore-case-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5818
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5819 As MH ignores case in the aliases, so too does MH-E. However, you may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5820 turn off the option @code{mh-alias-completion-ignore-case-flag} to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5821 make case significant which can be used to segregate completion of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5822 your aliases. You might use uppercase for mailing lists and lowercase
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5823 for people. For example, you might have:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5824
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5825 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5826 mark.baushke: Mark Baushke <mdb@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5827 MH-E: MH-E Mailing List <mh-e-devel@@stop.mail-abuse.org>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5828 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5829
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5830 When this option is turned off, if you were to type @kbd{M} in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5831 @samp{To:} field and then @kbd{M-@key{TAB}}, then you'd get the list;
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5832 if you started with @kbd{m} and then entered @kbd{M-@key{TAB}}, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5833 you'd get Mark's address. Note that this option affects completion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5834 only. If you were to enter @kbd{Mark.Baushke}, it would still be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5835 identified with your @samp{mark.baushke} alias.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5836
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5837 @findex mh-alias-minibuffer-confirm-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5838 @findex mh-letter-confirm-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5839 @vindex mh-alias-flash-on-comma
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5840 @vindex mh-compose-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5841
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5842 To verify that the alias you've entered is valid, the alias will be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5843 displayed in the minibuffer when you type a comma
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5844 (@code{mh-letter-confirm-address} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5845 @code{mh-alias-minibuffer-confirm-address} if the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5846 @code{mh-compose-prompt-flag} is turned on). @xref{Composing}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5847 behavior can be controlled with the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5848 @code{mh-alias-flash-on-comma} which provides three choices:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5849 @samp{Flash but Don't Warn If No Alias}, @samp{Flash and Warn If No
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5850 Alias}, and @samp{Don't Flash Nor Warn If No Alias}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5851
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5852 For another way to verify the alias expansion, see @ref{Checking
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5853 Recipients}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5854
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5855 @subheading Loading Aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5856
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5857 @cindex @command{ali}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5858 @cindex @file{/etc/nmh/MailAliases}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5859 @cindex @samp{Aliasfile:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5860 @cindex MH commands, @command{ali}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5861 @cindex MH profile component, @samp{Aliasfile:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5862 @cindex files, @file{/etc/nmh/MailAliases}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5863
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5864 MH-E loads aliases for completion and folder name hints from various
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5865 places. It uses the MH command @command{ali}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5866 @uref{@value{MH-BOOK-HOME}/mh.html, MH Aliases} in the MH book.} to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5867 read aliases from the files listed in the profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5868 @samp{Aliasfile:} as well as system-wide aliases (for example,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5869 @file{/etc/nmh/MailAliases}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5870
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5871 @cindex @file{/etc/passwd}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5872 @cindex files, @file{/etc/passwd}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5873
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5874 In addition, aliases are created from @file{/etc/passwd} entries with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5875 a user ID larger than a magical number, typically 200. This can be a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5876 handy tool on a machine where you and co-workers exchange messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5877 These aliases have the form @samp{local.@var{first.last}} if a real
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5878 name is present in the password file. Otherwise, the alias will have
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5879 the form @samp{local.@var{login}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5880
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5881 @vindex mh-alias-local-users-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5882
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5883 The prefix @samp{local.} can be modified via the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5884 @code{mh-alias-local-users-prefix}. This option can also be set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5885 @samp{Use Login}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5886
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5887 For example, consider the following password file entry:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5888
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5889 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5890 psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5891 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5892
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5893 @vindex mh-alias-local-users-prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5894
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5895 The following settings of option @code{mh-alias-local-users-prefix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5896 will produce the associated aliases:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5897
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5898 @table @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5899 @item "local."
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5900 local.peter.galbraith
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5901 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5902 @item ""
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5903 peter.galbraith
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5904 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5905 @item Use Login
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5906 psg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5907 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5908
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5909 @vindex mh-alias-passwd-gecos-comma-separator-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5910
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5911 In the example above, commas are used to separate different values
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5912 within the so-called GECOS field. This is a fairly common usage.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5913 However, in the rare case that the GECOS field in your password file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5914 is not separated by commas and whose contents may contain commas, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5915 can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5916 off.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5917
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5918 @cindex NIS, obtaining local aliases from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5919 @cindex @samp{ypcat passwd}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5920 @vindex mh-alias-local-users
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5921
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5922 If you're on a system with thousands of users you don't know, and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5923 loading of local aliases slows MH-E down noticeably, then the local
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5924 alias feature can be disabled by turning off the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5925 @code{mh-alias-local-users}. This option also takes a string which is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5926 executed to generate the password file. For example, use @samp{ypcat
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5927 passwd} to obtain the NIS password file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5928
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5929 @findex mh-alias-reload
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5930 @kindex M-x mh-alias-reload
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5931 @vindex mh-alias-reloaded-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5932
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5933 Since aliases are updated frequently, MH-E reloads aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5934 automatically whenever an alias lookup occurs if an alias source has
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5935 changed. However, you can reload your aliases manually by calling the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5936 command @kbd{M-x mh-alias-reload} directly. This command runs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5937 @code{mh-alias-reloaded-hook} after the aliases have been loaded.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5938
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5939 @subheading Adding Aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5940
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5941 In the past, you have manually added aliases to your alias file(s)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5942 listed in your @samp{Aliasfile:} profile component. MH-E provides
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5943 other methods for maintaining your alias file(s).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5944
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5945 @findex mh-alias-add-alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5946 @kindex M-x mh-alias-add-alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5947
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5948 You can use the @kbd{M-x mh-alias-add-alias} command which will prompt
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5949 you for the alias and address that you would like to add. If the alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5950 exists already, you will have the choice of inserting the new alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5951 before or after the old alias. In the former case, this alias will be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5952 used when sending mail to this alias. In the latter case, the alias
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5953 serves as an additional folder name hint when filing messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5954 (@pxref{Folder Selection}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5955
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5956 Earlier, the alias prefix @samp{local} was presented. You can use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5957 other prefixes to organize your aliases or disambiguate entries. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5958 might use prefixes for locales, jobs, or activities. For example, I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5959 have:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5960
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5961 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5962 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5963 ; Work
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5964 attensity.don.mitchell: Don Mitchell <dmitchell@@stop.mail-abuse.com>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5965 isharp.don.mitchell: Don Mitchell <donaldsmitchell@@stop.mail-abuse.com>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5966 ...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5967 ; Sport
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5968 diving.ken.mayer: Ken Mayer <kmayer@@stop.mail-abuse.com>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5969 sailing.mike.maloney: Mike Maloney <mmaloney@@stop.mail-abuse.com>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5970 ...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5971 ; Personal
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5972 ariane.kolkmann: Ariane Kolkmann <ArianeKolkmann@@stop.mail-abuse.com>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5973 ...
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5974 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5975 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5976
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5977 Using prefixes instead of postfixes helps you explore aliases during
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5978 completion. If you forget the name of an old dive buddy, you can enter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5979 @samp{div} and then @key{SPC} to get a listing of all your dive buddies.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5980
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5981 @kindex M-x mh-alias-add-address-under-point
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5982 @kindex M-x mh-alias-grab-from-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5983
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5984 An alias for the sender of the current message is added automatically
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5985 by clicking on the @samp{Grab From alias} tool bar button or by running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5986 the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5987 recipients of the current message are added by placing your cursor
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5988 over the desired recipient and giving the @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5989 mh-alias-add-address-under-point} command.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5990
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5991 @vindex mh-alias-insert-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5992 @vindex mh-alias-insertion-location
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5993
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5994 The options @code{mh-alias-insert-file} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5995 @code{mh-alias-insertion-location} controls how and where these aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5996 are inserted.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5997
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5998 @vindex mh-alias-insert-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5999
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6000 The default setting of option @code{mh-alias-insert-file} is @samp{Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6001 Aliasfile Profile Component}. This option can also hold the name of a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6002 file or a list a file names. If this option is set to a list of file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6003 names, or the @samp{Aliasfile:} profile component contains more than
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6004 one file name, MH-E will prompt for one of them.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6005
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6006 @vindex mh-alias-insertion-location
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6007
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6008 The option @code{mh-alias-insertion-location} is set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6009 @samp{Alphabetical} by default. If you organize your alias file in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6010 other ways, then the settings @samp{Top} and @samp{Bottom} might be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6011 more appropriate.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6012
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6013 @subheading Querying Aliases
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6014
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6015 @cindex regular expressions, @code{mh-alias-apropos}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6016 @findex mh-alias-apropos
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6017 @kindex M-x mh-alias-apropos
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6018
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6019 If you can't quite remember an alias, you can use @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6020 mh-alias-apropos} to show all aliases or addresses that match a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6021 regular expression
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6022 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6023 (@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6024 GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6025 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6026 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6027 (see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6028 @uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6029 Syntax of Regular Expressions} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6030 @cite{The GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6031 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6032
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6033 @node Identities, Speedbar, Aliases, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6034 @chapter Identities
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6035
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6036 @cindex identities
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6037 @cindex multiple personalities
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6038
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6039 MH-E supports the concept of multiple personalities or identities.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6040 This means that you can easily have a different header and signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6041 at home and at work.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6042
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6043 @cindex @samp{Identity} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6044 @cindex menu, @samp{Identity}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6045
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6046 A couple of commands are used to insert identities in MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6047 which are also found in the @samp{Identity} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6048
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6049 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6050 @kindex C-c C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6051 @findex mh-insert-identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6052 @item C-c C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6053 Insert fields specified by given identity (@code{mh-insert-identity}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6054 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6055 @cindex @samp{Identity > Insert Auto Fields} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6056 @cindex menu item, @samp{Identity > Insert Auto Fields}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6057 @kindex C-c M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6058 @findex mh-insert-auto-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6059 @item C-c M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6060 Insert custom fields if recipient found in @code{mh-auto-fields-list}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6061 (@code{mh-insert-auto-fields}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6062 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6063
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6064 @cindex @samp{mh-identity} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6065 @cindex customization group, @samp{mh-identity}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6066
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6067 The @samp{mh-identity} customization group contains the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6068 options.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6069
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6070 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6071 @item mh-auto-fields-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6072 List of recipients for which header lines are automatically inserted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6073 (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6074 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6075 @item mh-auto-fields-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6076 On means to prompt before sending if fields inserted (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6077 @samp{on})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6078 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6079 @item mh-identity-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6080 Default identity to use when @code{mh-letter-mode} is called (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6081 @samp{None}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6082 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6083 @item mh-identity-handlers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6084 Handler functions for fields in @code{mh-identity-list}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6085 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6086 @item mh-identity-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6087 List of identities (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6088 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6089
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6090 Some of the common header fields that people change depending on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6091 context are the @samp{From:} and @samp{Organization:} fields, as well
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6092 as the signature.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6093
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6094 @vindex mh-identity-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6095
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6096 This is done by customizing the option @code{mh-identity-list}. In the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6097 customization buffer for this option, click on the @samp{INS} button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6098 and enter a label such as @samp{Home} or @samp{Work}. Then click on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6099 the @samp{INS} button with the label @samp{Add at least one item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6100 below}. The @samp{Value Menu} has the following menu items:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6101
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6102 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6103 @cindex header field, @samp{From:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6104 @cindex @samp{From:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6105 @item From Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6106 Specify an alternate @samp{From:} header field. You must include a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6107 valid email address. A standard format is @samp{First Last
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6108 <login@@host.domain>}. If you use an initial with a period, then you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6109 must quote your name as in @samp{"First I. Last"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6110 <login@@host.domain>}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6111 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6112 @cindex header field, @samp{Organization:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6113 @cindex @samp{Organization:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6114 @item Organization Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6115 People usually list the name of the company where they work here.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6116 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6117 @item Other Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6118 Set any arbitrary header field and value here. Unless the header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6119 is a standard one, precede the name of your field's label with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6120 @samp{X-}, as in @samp{X-Fruit-of-the-Day:}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6121 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6122 @item Attribution Verb
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6123 This value overrides the setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6124 @code{mh-extract-from-attribution-verb}. @xref{Inserting Letter}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6125 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6126 @cindex signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6127 @vindex mh-signature-file-name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6128 @item Signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6129 Set your signature with this item. You can specify the contents of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6130 @code{mh-signature-file-name}, a file, or a function.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6131 @xref{Signature}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6132 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6133 @item GPG Key ID
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6134 Specify a different key to sign or encrypt messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6135 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6136
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6137 @cindex Identity menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6138 @cindex menu, Identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6139 @findex mh-insert-identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6140 @kindex C-c C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6141
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6142 You can select the identities you have added via the menu called
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6143 @samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6144 C-d} (@code{mh-insert-identity}). To clear the fields and signature
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6145 added by the identity, select the @samp{None} identity.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6146
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6147 @cindex menu item, @samp{Identity > Customize Identities}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6148 @cindex menu item, @samp{Identity > Save as Default}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6149 @cindex menu item, @samp{Identity > Set Default for Session}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6150 @cindex @samp{Identity > Customize Identities} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6151 @cindex @samp{Identity > Save as Default} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6152 @cindex @samp{Identity > Set Default for Session} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6153 @vindex mh-identity-default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6154
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6155 The @samp{Identity} menu contains two other items to save you from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6156 having to set the identity on every message. The menu item @samp{Set
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6157 Default for Session} can be used to set the default identity to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6158 current identity until you exit Emacs. The menu item @samp{Save as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6159 Default} sets the option @code{mh-identity-default} to the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6160 identity setting. You can also customize the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6161 @code{mh-identity-default} in the usual fashion. If you find that you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6162 need to add another identity, the menu item @samp{Customize
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6163 Identities} is available for your convenience.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6164
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6165 @cindex regular expressions, @code{mh-auto-fields-list}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6166 @vindex mh-auto-fields-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6167
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6168 The option @code{mh-auto-fields-list} can also be used to set the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6169 identity depending on the recipient to provide even more control. To
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6170 customize @code{mh-auto-fields-list}, click on the @samp{INS} button
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6171 and enter a regular expression for the recipient's address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6172 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6173 (@pxref{Regexps, , Syntax of Regular Expressions, emacs, The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6174 GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6175 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6176 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6177 (see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6178 @uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6179 Syntax of Regular Expressions} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6180 @cite{The GNU Emacs Manual}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6181 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6182 Click on the @samp{INS} button with the @samp{Add at least one item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6183 below} label. The @samp{Value Menu} contains the following menu items:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6184
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6185 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6186 @item Identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6187 Select an identity from those configured in @code{mh-identity-list}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6188 All of the information for that identity will be added if the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6189 recipient matches.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6190 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6191 @cindex @samp{Fcc:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6192 @cindex header field, @samp{Fcc:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6193 @item Fcc Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6194 Insert an @samp{Fcc:} header field with the folder you provide. When
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6195 you send the message, MH will put a copy of your message in this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6196 folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6197 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6198 @cindex @samp{Mail-Followup-To:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6199 @cindex header field, @samp{Mail-Followup-To:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6200 @item Mail-Followup-To Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6201 Insert an @samp{Mail-Followup-To:} header field with the recipients
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6202 you provide. If the recipient's mail user agent supports this header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6203 field@footnote{@samp{Mail-Followup-To:} is supported by nmh.}, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6204 their replies will go to the addresses listed. This is useful if their
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6205 replies go both to the list and to you and you don't have a mechanism
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6206 to suppress duplicates. If you reply to someone not on the list, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6207 must either remove the @samp{Mail-Followup-To:} field, or ensure the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6208 recipient is also listed there so that he receives replies to your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6209 reply.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6210 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6211 @item Other Field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6212 Other header fields may be added using this menu item.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6213 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6214
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6215 @findex mh-insert-auto-fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6216 @kindex C-c M-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6217 @vindex mh-auto-fields-prompt-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6218
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6219 These fields can only be added after the recipient is known. Because
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6220 you can continue to add recipients as you edit the draft, MH-E waits
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6221 until the message is sent to perform the auto-insertions. This seems
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6222 strange at first, but you'll get used to it. There are two ways to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6223 help you feel that the desired fields are added. The first is the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6224 action when the message is sent: if any fields are added
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6225 automatically, you are given a chance to see and to confirm these
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6226 fields before the message is actually sent. You can do away with this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6227 confirmation by turning off the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6228 @code{mh-auto-fields-prompt-flag}. The second method is manual: once
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6229 the header contains one or more recipients, you may run the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6230 @kbd{C-c M-d} (@code{mh-insert-auto-fields}) or choose the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6231 @samp{Identity -> Insert Auto Fields} menu item to insert these fields
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6232 manually. However, if you use this command, the automatic insertion
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6233 when the message is sent is disabled.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6234
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6235 @vindex mh-auto-fields-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6236 @vindex mh-identity-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6237
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6238 You should avoid using the same header field in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6239 @code{mh-auto-fields-list} and @code{mh-identity-list} definitions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6240 that may apply to the same message as the result is undefined.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6241
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6242 @vindex mh-identity-handlers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6243 @vindex mh-identity-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6244
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6245 The option @code{mh-identity-handlers} is used to change the way that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6246 fields, signatures, and attributions in @code{mh-identity-list} are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6247 added. To customize @code{mh-identity-handlers}, replace the name of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6248 an existing handler function associated with the field you want to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6249 change with the name of a function you have written. You can also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6250 click on an @samp{INS} button and insert a field of your choice and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6251 the name of the function you have written to handle it.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6252
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6253 @vindex mh-identity-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6254
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6255 The @samp{Field} field can be any field that you've used in your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6256 @code{mh-identity-list}. The special fields @samp{:attribution-verb},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6257 @samp{:signature}, or @samp{:pgg-default-user-id} are used for the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6258 @code{mh-identity-list} choices @samp{Attribution Verb},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6259 @samp{Signature}, and @samp{GPG Key ID} respectively.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6260
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6261 The handler associated with the @samp{:default} field is used when no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6262 other field matches.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6263
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6264 The handler functions are passed two or three arguments: the field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6265 itself (for example, @samp{From}), or one of the special fields (for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6266 example, @samp{:signature}), and the action @samp{'remove} or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6267 @samp{'add}. If the action is @samp{'add}, an additional argument
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6268 containing the value for the field is given.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6269
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6270 @node Speedbar, Menu Bar, Identities, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6271 @chapter The Speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6272
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6273 @cindex folder navigation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6274 @cindex speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6275 @findex mh-visit-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6276 @kindex F v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6277 @kindex M-x speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6278 @kindex Mouse-2
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6279
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6280 You can also use the speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6281 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6282 (@pxref{Speedbar, , Speedbar Frames, emacs, The GNU Emacs Manual},)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6283 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6284 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6285 (see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6286 @uref{http://www.gnu.org/software/emacs/manual/html_node/Speedbar.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6287 Speedbar Frames} in @cite{The GNU Emacs Manual})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6288 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6289 to view your folders. To bring up the speedbar, run @kbd{M-x speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6290 @key{RET}}. You will see a new frame appear with all of your MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6291 folders. Folders with unseen messages appear in boldface. Click on a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6292 folder name with @kbd{Mouse-2} to visit that folder in a similar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6293 fashion to the command @kbd{F v} (@code{mh-visit-folder})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6294 (@pxref{Folders}). Click on the @samp{+} icon to expand and view the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6295 sub-folders of that folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6296
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6297 The speedbar can be manipulated with the keyboard as well. Use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6298 Emacs navigational keys (like the arrow keys, or @kbd{C-n}) to move
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6299 the cursor over the desired folder and then use the shortcuts for the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6300 menu items listed in the table below.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6301
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6302 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6303 @findex mh-speed-view
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6304 @item Visit Folder (@key{RET})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6305 Visits the selected folder just as if you had used @kbd{F v}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6306 (@code{mh-speed-view}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6307 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6308 @findex mh-speed-expand-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6309 @item Expand Nested Folders (@kbd{+})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6310 Expands the selected folder in the speedbar, exposing the children
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6311 folders inside it (@code{mh-speed-expand-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6312 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6313 @findex mh-speed-contract-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6314 @item Contract Nested Folders (@kbd{-})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6315 Contracts or collapses the selected folder in the speedbar, hiding the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6316 children folders inside it (@code{mh-speed-contract-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6317 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6318 @findex mh-speed-refresh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6319 @item Refresh Speedbar (@kbd{r})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6320 Regenerates the list of folders in the speedbar. Run this command if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6321 you've added or deleted a folder, or want to update the unseen message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6322 count before the next automatic update (@code{mh-speed-refresh}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6323 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6324
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6325 @findex delete-frame
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6326 @kindex C-x 5 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6327 @kindex Mouse-3
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6328
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6329 You can click on @kbd{Mouse-3} to bring up a context menu that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6330 contains these items. Dismiss the speedbar with @kbd{C-x 5 0}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6331 (@code{delete-frame}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6332
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6333 @cindex @command{flists}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6334 @cindex MH commands, @command{flists}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6335 @cindex @samp{mh-speedbar} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6336 @cindex customization group, @samp{mh-speedbar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6337
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6338 The MH-E speedbar uses the MH command @command{flists}@footnote{See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6339 the section @uref{@value{MH-BOOK-HOME}/morseq.html#flist, Searching for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6340 Sequences with flist} in the MH book.} to generate the list of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6341 folders. The @samp{mh-speedbar} customization group contains the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6342 following option which controls how often the speedbar calls
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6343 @command{flists}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6344
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6345 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6346 @item mh-speed-update-interval
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6347 Time between speedbar updates in seconds (default: 60). Set to 0 to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6348 disable automatic update.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6349 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6350
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6351 You can modify the appearance of the folders in the speedbar by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6352 customizing the following faces.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6353
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6354 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6355 @item mh-speedbar-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6356 Basic folder face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6357 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6358 @item mh-speedbar-folder-with-unseen-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6359 Folder face when folder contains unread messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6360 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6361 @item mh-speedbar-selected-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6362 Selected folder face.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6363 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6364 @item mh-speedbar-selected-folder-with-unseen-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6365 Selected folder face when folder contains unread messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6366 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6367
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6368 @node Menu Bar, Tool Bar, Speedbar, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6369 @chapter The Menu Bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6370
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6371 @cindex @samp{Folder} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6372 @cindex @samp{Identity} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6373 @cindex @samp{Letter} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6374 @cindex @samp{Message} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6375 @cindex @samp{Search} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6376 @cindex @samp{Sequence} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6377 @cindex Folder menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6378 @cindex Identity menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6379 @cindex Letter menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6380 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6381 @cindex MH-Letter mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6382 @cindex MH-Search mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6383 @cindex Message menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6384 @cindex Search menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6385 @cindex Sequence menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6386 @cindex menu bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6387 @cindex menu, Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6388 @cindex menu, Identity
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6389 @cindex menu, Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6390 @cindex menu, Message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6391 @cindex menu, Search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6392 @cindex menu, Sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6393 @cindex menu, @samp{Folder}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6394 @cindex menu, @samp{Identity}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6395 @cindex menu, @samp{Letter}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6396 @cindex menu, @samp{Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6397 @cindex menu, @samp{Search}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6398 @cindex menu, @samp{Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6399 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6400 @cindex modes, MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6401 @cindex modes, MH-Search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6402
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6403 For those of you who prefer to mouse and menu instead of using the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6404 meta-coke-bottle-bucky keys, MH-E provides menu items for most of its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6405 functions. The MH-Folder buffer adds the @samp{Folder},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6406 @samp{Message}, and @samp{Sequence} menus. The MH-Letter buffer adds
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6407 the @samp{Identity} and @samp{Letter} menus. The MH-Search buffer adds
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6408 the @samp{Search} menu. There's no need to list the actual items here,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6409 as you can more easily see them for yourself, and the functions are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6410 already described elsewhere in this manual.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6411
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6412 For a description of the menu bar, please
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6413 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6414 @xref{Menu Bar, , The Menu Bar, emacs, The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6415 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6416 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6417 see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6418 @uref{http://www.gnu.org/software/emacs/manual/html_node/Menu-Bar.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6419 The Menu Bar} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6420 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6421
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6422 The Emacs manual describes how to get online help for a particular
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6423 menu item. You can also look up a menu item in the index of this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6424 manual in two ways: all of the menu items are listed alphabetically,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6425 and you can also browse all of the items under the index entry
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6426 @samp{menu item}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6427
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6428 @node Tool Bar, Searching, Menu Bar, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6429 @chapter The Tool Bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6430
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6431 @cindex tool bar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6432
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6433 Emacs also provides a graphical tool bar. For a description of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6434 tool bar, please
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6435 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6436 @xref{Tool Bars, , Tool Bars, emacs, The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6437 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6438 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6439 see the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6440 @uref{http://www.gnu.org/software/emacs/manual/html_node/Tool-Bars.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6441 Tool Bars} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6442 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6443
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6444 @cindex @samp{mh-tool-bar} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6445 @cindex customization group, @samp{mh-tool-bar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6446
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6447 MH-E adds several icons to this tool bar; you can modify the MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6448 aspects of the tool bar via the @samp{mh-tool-bar} customization group.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6449
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6450 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6451 @item mh-tool-bar-folder-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6452 List of buttons to include in MH-Folder tool bar (default: a checklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6453 too long to list here).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6454 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6455 @item mh-tool-bar-letter-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6456 List of buttons to include in MH-Letter tool bar (default: a checklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6457 too long to list here).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6458 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6459 @item mh-tool-bar-search-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6460 Function called by the tool bar search button (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6461 @code{mh-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6462 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6463 @item mh-xemacs-tool-bar-position
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6464 Tool bar location (default: @samp{Same As Default Tool Bar}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6465 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6466 @item mh-xemacs-use-tool-bar-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6467 If @samp{on}, use tool bar (default: @samp{on}, if supported).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6468 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6469
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6470 In GNU Emacs, icons for some of MH-E's functions are added to the tool
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6471 bar. In XEmacs, you have the opportunity to create a separate tool bar for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6472 the MH-E icons.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6473
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6474 @vindex mh-tool-bar-folder-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6475 @vindex mh-tool-bar-letter-buttons
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6476
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6477 In either case, you can select which of these functions you'd like to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6478 see by customizing the options @code{mh-tool-bar-folder-buttons} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6479 @code{mh-tool-bar-letter-buttons}. As you probably guessed, the former
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6480 customizes the tool bar in MH-Folder mode and the latter in MH-Letter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6481 mode. Both of these options present you with a list of functions;
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6482 check the functions whose icons you want to see and clear the check
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6483 boxes for those you don't.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6484
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6485 @findex mh-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6486 @vindex mh-tool-bar-search-function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6487
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6488 The function associated with the searching icon can be set via the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6489 option @code{mh-tool-bar-search-function}. By default, this is set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6490 @code{mh-search}. @xref{Searching}. You can also choose @samp{Other
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6491 Function} from the @samp{Value Menu} and enter a function of your own
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6492 choosing.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6493
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6494 @vindex mh-xemacs-use-tool-bar-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6495
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6496 XEmacs provides a couple of extra options. The first,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6497 @code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6498 icons at all. By default, this option is turned on if the window
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6499 system supports tool bars. If your system doesn't support tool bars,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6500 then you won't be able to turn on this option.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6501
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6502 @vindex mh-xemacs-tool-bar-position
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6503
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6504 The second extra option is @code{mh-xemacs-tool-bar-position} which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6505 controls the placement of the tool bar along the four edges of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6506 frame. You can choose from one of @samp{Same As Default Tool Bar},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6507 @samp{Top}, @samp{Bottom}, @samp{Left}, or @samp{Right}. If this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6508 variable is set to anything other than @samp{Same As Default Tool Bar}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6509 and the default tool bar is in a different location, then two tool
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6510 bars will be displayed: the MH-E tool bar and the default tool bar.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6511
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6512 @node Searching, Threading, Tool Bar, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6513 @chapter Searching Through Messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6514
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6515 @cindex @samp{Search} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6516 @cindex menu, @samp{Search}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6517 @cindex searching
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6518 @findex mh-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6519 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6520
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6521 Earlier, the command @kbd{F s} (@code{mh-search}) was introduced which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6522 helps you find messages that lie buried in your folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6523 (@pxref{Folders}). This chapter covers this command in more detail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6524 Several commands are used to compose the search criteria and to start
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6525 searching. A couple of them can be found in the @samp{Search} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6526
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6527 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6528 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6529 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6530 @item C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6531 Display cheat sheet for the MH-E commands (@code{mh-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6532 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6533 @cindex @samp{Search > Perform Search} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6534 @cindex menu item, @samp{Search > Perform Search}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6535 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6536 @findex mh-index-do-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6537 @item C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6538 Find messages using @code{mh-search-program}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6539 (@code{mh-index-do-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6540 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6541 @cindex @samp{Search > Search with pick} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6542 @cindex menu item, @samp{Search > Search with pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6543 @kindex C-c C-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6544 @findex mh-pick-do-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6545 @item C-c C-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6546 Find messages using @command{pick} (@code{mh-pick-do-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6547 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6548 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6549 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6550 @item C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6551 Display cheat sheet for the MH-E commands (@code{mh-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6552 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6553 @kindex C-c C-f C-a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6554 @kindex C-c C-f a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6555 @findex mh-to-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6556 @item C-c C-f a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6557 @itemx C-c C-f C-a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6558 Move to @samp{Mail-Reply-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6559 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6560 @kindex C-c C-f C-b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6561 @kindex C-c C-f b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6562 @item C-c C-f b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6563 @itemx C-c C-f C-b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6564 Move to @samp{Bcc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6565 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6566 @kindex C-c C-f C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6567 @kindex C-c C-f c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6568 @item C-c C-f c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6569 @itemx C-c C-f C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6570 Move to @samp{Cc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6571 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6572 @kindex C-c C-f C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6573 @kindex C-c C-f d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6574 @item C-c C-f d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6575 @itemx C-c C-f C-d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6576 Move to @samp{Dcc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6577 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6578 @kindex C-c C-f C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6579 @kindex C-c C-f f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6580 @item C-c C-f f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6581 @itemx C-c C-f C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6582 Move to @samp{Fcc:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6583 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6584 @kindex C-c C-f C-l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6585 @kindex C-c C-f l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6586 @item C-c C-f l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6587 @itemx C-c C-f C-l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6588 Move to @samp{Mail-Followup-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6589 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6590 @kindex C-c C-f C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6591 @kindex C-c C-f m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6592 @item C-c C-f m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6593 @itemx C-c C-f C-m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6594 Move to @samp{From:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6595 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6596 @kindex C-c C-f C-r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6597 @kindex C-c C-f r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6598 @item C-c C-f r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6599 @itemx C-c C-f C-r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6600 Move to @samp{Reply-To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6601 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6602 @kindex C-c C-f C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6603 @kindex C-c C-f s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6604 @item C-c C-f s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6605 @itemx C-c C-f C-s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6606 Move to @samp{Subject:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6607 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6608 @kindex C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6609 @kindex C-c C-f t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6610 @item C-c C-f t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6611 @itemx C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6612 Move to @samp{To:} header field (@code{mh-to-field}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6613 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6614
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6615 Another few commands are available in the MH-Folder buffer resulting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6616 from a search.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6617
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6618 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6619 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6620 @findex mh-index-next-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6621 @item @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6622 Jump to the next folder marker (@code{mh-index-next-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6623 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6624 @kindex S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6625 @findex mh-index-previous-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6626 @item S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6627 Jump to the previous folder marker (@code{mh-index-previous-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6628 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6629 @kindex v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6630 @findex mh-index-visit-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6631 @item v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6632 Visit original folder from where the message at point was found
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6633 (@code{mh-index-visit-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6634 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6635
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6636 @cindex @samp{mh-search} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6637 @cindex customization group, @samp{mh-search}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6638
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6639 There is one option from the @samp{mh-search} customization group used
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6640 in searching.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6641
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6642 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6643 @item mh-search-program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6644 Search program that MH-E shall use (default: @samp{Auto-detect}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6645 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6646
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6647 The following hook is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6648
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6649 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6650 @item mh-search-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6651 Hook run upon entry to @code{mh-search-mode} (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6652 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6653
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6654 The following face is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6655
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6656 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6657 @item mh-search-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6658 Folder heading face in MH-Folder buffers created by searches.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6659 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6660
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6661 @findex mh-search-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6662 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6663
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6664 The command @kbd{F s} (@code{mh-search-folder}) helps you find
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6665 messages in your entire corpus of mail. You can search for messages to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6666 or from a particular person or about a particular subject. In fact,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6667 you can also search for messages containing selected strings in any
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6668 arbitrary header field or any string found within the messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6669
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6670 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6671 @cindex MH commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6672
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6673 Out of the box, MH-E uses @command{pick} to find messages. With a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6674 little extra effort, you can set an indexing program which rewards you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6675 with extremely quick results. The drawback is that sometimes the index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6676 does not contain the words you're looking for. You can still use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6677 @command{pick} in these situations.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6678
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6679 You are prompted for the folder to search. This can be @samp{all} to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6680 search all folders. Note that the search works recursively on the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6681 listed folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6682
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6683 @cindex MH-Search mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6684 @cindex modes, MH-Search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6685
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6686 Next, an MH-Search buffer appears where you can enter search criteria.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6687
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6688 @cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6689 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6690 From:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6691 To:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6692 Cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6693 Date:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6694 Subject:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6695 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6696 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6697
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6698
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6699
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6700
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6701
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6702
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6703
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6704
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6705 --:** search-pattern All L7 (MH-Search)---------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6706 Type C-c C-c to search messages, C-c C-p to use pick, C-c ? for help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6707 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6708 @end cartouche
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6709 @i{Search window}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6710
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6711 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6712 @cindex MH commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6713
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6714 Edit this template by entering your search criteria in an appropriate
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6715 header field that is already there, or create a new field yourself. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6716 the string you're looking for could be anywhere in a message, then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6717 place the string underneath the row of dashes.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6718
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6719 As an example, let's say that we want to find messages from Ginnean
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6720 about horseback riding in the Kosciusko National Park (Australia)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6721 during January, 1994. Normally we would start with a broad search and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6722 narrow it down if necessary to produce a manageable amount of data,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6723 but we'll cut to the chase and create a fairly restrictive set of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6724 criteria as follows:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6725
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6726 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6727 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6728 From: ginnean
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6729 To:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6730 Cc:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6731 Date: Jan 1994
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6732 Subject:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6733 --------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6734 horse
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6735 kosciusko
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6736 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6737 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6738
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6739 @findex mh-to-field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6740 @kindex C-c C-f C-t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6741
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6742 As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6743 C-t} (@code{mh-to-field}) to help you fill in the blanks.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6744 @xref{Editing Message}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6745
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6746 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6747 @vindex mh-search-mode-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6748
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6749 If you find that you do the same thing over and over when editing the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6750 search template, you may wish to bind some shortcuts to keys. This can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6751 be done with the variable @code{mh-search-mode-hook}, which is called
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6752 when @kbd{F s} is run on a new pattern.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6753
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6754 @findex mh-index-do-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6755 @findex mh-pick-do-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6756 @kindex C-c C-c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6757 @kindex C-c C-p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6758
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6759 To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6760 Sometimes you're searching for text that is either not indexed, or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6761 hasn't been indexed yet. In this case you can override the default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6762 method with the pick method by running the command @kbd{C-c C-p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6763 (@code{mh-pick-do-search}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6764
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6765 @cindex folders, @samp{+mhe-index}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6766 @cindex @samp{+mhe-index}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6767 @findex mh-index-next-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6768 @findex mh-index-previous-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6769 @kindex @key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6770 @kindex S-@key{TAB}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6771 @vindex mh-search-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6772
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6773 The messages that are found are put in a temporary sub-folder of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6774 @samp{+mhe-index} and are displayed in an MH-Folder buffer. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6775 buffer is special because it displays messages from multiple folders;
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6776 each set of messages from a given folder has a heading with the folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6777 name. The appearance of the heading can be modified by customizing the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6778 face @code{mh-search-folder}. You can jump back and forth between the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6779 headings using the commands @kbd{@key{TAB}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6780 (@code{mh-index-next-folder}) and @kbd{S-@key{TAB}}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6781 (@code{mh-index-previous-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6782
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6783 @findex mh-index-visit-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6784 @findex mh-rescan-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6785 @kindex F r
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6786 @kindex v
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6787
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6788 In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6789 used to visit the folder of the message at point. Initially, only the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6790 messages that matched the search criteria are displayed in the folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6791 While the temporary buffer has its own set of message numbers, the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6792 actual messages numbers are shown in the visited folder. Thus, the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6793 command @kbd{v} is useful to find the actual message number of an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6794 interesting message, or to view surrounding messages with the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6795 @kbd{F r} @code{mh-rescan-folder}. @xref{Folders}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6796
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6797 @findex mh-kill-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6798 @kindex F k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6799
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6800 Because this folder is temporary, you'll probably get in the habit of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6801 killing it when you're done with @kbd{F k} (@code{mh-kill-folder}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6802 @xref{Folders}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6803
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6804 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6805
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6806 You can regenerate the results by running @kbd{F s} with a prefix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6807 argument.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6808
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6809 @cindex @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6810 @cindex Unix commands, @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6811 @cindex @samp{X-MHE-Checksum:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6812 @cindex header field, @samp{X-MHE-Checksum:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6813
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6814 Note: This command uses an @samp{X-MHE-Checksum:} header field to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6815 cache the MD5 checksum of a message. This means that if an incoming
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6816 message already contains an @samp{X-MHE-Checksum:} field, that message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6817 might not be found by this command. The following @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6818 recipe avoids this problem by renaming the existing header field:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6819
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6820 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6821 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6822 :0 wf
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6823 | formail -R "X-MHE-Checksum" "X-Old-MHE-Checksum"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6824 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6825 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6826
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6827 @xref{Limits}, for an alternative interface to searching.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6828
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6829 @section Configuring Indexed Searches
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6830
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6831 @cindex @command{grep}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6832 @cindex @command{mairix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6833 @cindex @command{namazu}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6834 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6835 @cindex @command{swish++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6836 @cindex @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6837 @cindex Unix commands, @command{grep}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6838 @cindex Unix commands, @command{mairix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6839 @cindex Unix commands, @command{namazu}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6840 @cindex Unix commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6841 @cindex Unix commands, @command{swish++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6842 @cindex Unix commands, @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6843 @findex mh-search
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6844 @kindex F s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6845 @vindex mh-search-program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6846
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6847 The command @kbd{F s} (@code{mh-search}) runs the command defined by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6848 the option @code{mh-search-program}. The default value is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6849 @samp{Auto-detect} which means that MH-E will automatically choose one
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6850 of @command{swish++}, @command{swish-e}, @command{mairix},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6851 @command{namazu}, @command{pick} and @command{grep} in that order. If,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6852 for example, you have both @command{swish++} and @command{mairix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6853 installed and you want to use @command{mairix}, then you can set this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6854 option to @samp{mairix}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6855
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6856 The following sub-sections describe how to set up the various indexing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6857 programs to use with MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6858
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6859 @subsection swish++
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6860
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6861 @cindex @command{swish++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6862 @cindex Unix commands, @command{swish++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6863
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6864 In the examples below, replace @file{/home/user/Mail} with the path to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6865 your MH directory.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6866
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6867 First create the directory @file{/home/user/Mail/.swish++}. Then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6868 create the file @file{/home/user/Mail/.swish++/swish++.conf} with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6869 following contents:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6870
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6871 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6872 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6873 IncludeMeta Bcc Cc Comments Content-Description From Keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6874 IncludeMeta Newsgroups Resent-To Subject To
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6875 IncludeMeta Message-Id References In-Reply-To
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6876 IncludeFile Mail *
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6877 IndexFile /home/user/Mail/.swish++/swish++.index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6878 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6879 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6880
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6881 Use the following command line to generate the swish index. Run this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6882 daily from cron:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6883
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6884 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6885 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6886 find /home/user/Mail -path /home/user/Mail/mhe-index -prune \
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6887 -o -path /home/user/Mail/.swish++ -prune \
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6888 -o -name "[0-9]*" -print \
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6889 | index -c /home/user/Mail/.swish++/swish++.conf -
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6890 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6891 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6892
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6893 This command does not index the folders that hold the results of your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6894 searches in @samp{+mhe-index} since they tend to be ephemeral and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6895 original messages are indexed anyway.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6896
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6897 @cindex @command{index}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6898 @cindex Unix commands, @command{index}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6899 @cindex @command{index++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6900 @cindex Unix commands, @command{index++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6901
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6902 On some systems (Debian GNU/Linux, for example), use @command{index++}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6903 instead of @command{index}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6904
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6905 @subsection swish
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6906
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6907 @cindex @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6908 @cindex Unix commands, @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6909
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6910 In the examples below, replace @file{/home/user/Mail} with the path to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6911 your MH directory.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6912
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6913 First create the directory @file{/home/user/Mail/.swish}. Then create
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6914 the file @file{/home/user/Mail/.swish/config} with the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6915 contents:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6916
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6917 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6918 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6919 DefaultContents TXT*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6920 IndexDir /home/user/Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6921 IndexFile /home/user/Mail/.swish/index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6922 IndexName "Mail Index"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6923 IndexDescription "Mail Index"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6924 IndexPointer "http://nowhere"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6925 IndexAdmin "nobody"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6926 #MetaNames automatic
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6927 IndexReport 3
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6928 FollowSymLinks no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6929 UseStemming no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6930 IgnoreTotalWordCountWhenRanking yes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6931 WordCharacters abcdefghijklmnopqrstuvwxyz0123456789-
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6932 BeginCharacters abcdefghijklmnopqrstuvwxyz
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6933 EndCharacters abcdefghijklmnopqrstuvwxyz0123456789
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6934 IgnoreLimit 50 1000
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6935 IndexComments 0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6936 FileRules filename contains \D
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6937 FileRules pathname contains /home/user/Mail/.swish
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6938 FileRules pathname contains /home/user/Mail/mhe-index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6939 FileRules filename is index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6940 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6941 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6942
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6943 This configuration does not index the folders that hold the results of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6944 your searches in @samp{+mhe-index} since they tend to be ephemeral and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6945 the original messages are indexed anyway.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6946
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6947 If there are any directories you would like to ignore, append lines
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6948 like the following to @file{config}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6949
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6950 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6951 FileRules pathname contains /home/user/Mail/scripts
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6952 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6953
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6954 @cindex @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6955 @cindex Unix commands, @command{swish-e}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6956
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6957 Use the following command line to generate the swish index. Run this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6958 daily from cron:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6959
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6960 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6961 swish-e -c /home/user/Mail/.swish/config
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6962 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6963
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6964 @subsection mairix
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6965
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6966 @cindex @command{mairix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6967 @cindex Unix commands, @command{mairix}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6968
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6969 In the examples below, replace @file{/home/user/Mail} with the path to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6970 your MH directory.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6971
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6972 First create the directory @file{/home/user/Mail/.mairix}. Then create
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6973 the file @file{/home/user/Mail/.mairix/config} with the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6974 contents:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6975
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6976 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6977 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6978 base=/home/user/Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6979
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6980 # List of folders that should be indexed. 3 dots at the end means there
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6981 # are subfolders within the folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6982 mh=archive...:inbox:drafts:news:sent:trash
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6983
106345
e3557e6d3c31 (Searching): Use mh vfolder_format and fix typo in database path for
Bill Wohler <wohler@newt.com>
parents: 103407
diff changeset
6984 vfolder_format=mh
e3557e6d3c31 (Searching): Use mh vfolder_format and fix typo in database path for
Bill Wohler <wohler@newt.com>
parents: 103407
diff changeset
6985 database=/home/user/Mail/.mairix/database
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6986 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6987 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6988
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6989 Use the following command line to generate the mairix index. Run this daily
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6990 from cron:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6991
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6992 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6993 mairix -f /home/user/Mail/.mairix/config
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6994 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6995
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6996 @subsection namazu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6997
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6998 @cindex @command{namazu}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6999 @cindex Unix commands, @command{namazu}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7000
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7001 In the examples below, replace @file{/home/user/Mail} with the path to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7002 your MH directory.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7003
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7004 First create the directory @file{/home/user/Mail/.namazu}. Then create
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7005 the file @file{/home/user/Mail/.namazu/mknmzrc} with the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7006 contents:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7007
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7008 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7009 @group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7010 package conf; # Don't remove this line!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7011 $ADDRESS = 'user@@localhost';
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7012 $ALLOW_FILE = "[0-9]*";
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7013 $EXCLUDE_PATH = "^/home/user/Mail/(mhe-index|spam)";
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7014 @end group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7015 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7016
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7017 This configuration does not index the folders that hold the results of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7018 your searches in @samp{+mhe-index} since they tend to be ephemeral and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7019 the original messages are indexed anyway.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7020
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7021 Use the following command line to generate the namazu index. Run this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7022 daily from cron:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7023
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7024 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7025 mknmz -f /home/user/Mail/.namazu/mknmzrc -O /home/user/Mail/.namazu \
106345
e3557e6d3c31 (Searching): Use mh vfolder_format and fix typo in database path for
Bill Wohler <wohler@newt.com>
parents: 103407
diff changeset
7026 -q /home/user/Mail
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7027 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7028
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7029 @subsection pick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7030
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7031 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7032 @cindex MH commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7033
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7034 This search method does not require any setup.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7035
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7036 Read @command{pick}(1) or the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7037 @uref{@value{MH-BOOK-HOME}/finpic.html, Finding Messages with pick} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7038 the MH book to find out more about how to enter the criteria.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7039
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7040 @subsection grep
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7041
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7042 @cindex @command{grep}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7043 @cindex Unix commands, @command{grep}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7044
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7045 This search method does not require any setup.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7046
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7047 Unlike the other search methods, this method does not use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7048 MH-Search buffer. Instead, you simply enter a regular expression in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7049 the minibuffer. For help in constructing regular expressions, see your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7050 man page for @command{grep}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7051
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7052 @node Threading, Limits, Searching, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7053 @chapter Viewing Message Threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7054
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7055 @cindex threading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7056
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7057 MH-E groups messages by @dfn{threads} which are messages that are part
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7058 of the same discussion and usually all have the same @samp{Subject:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7059 header field. Other ways to organize messages in a folder include
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7060 limiting (@pxref{Limits}) or using full-text indexed searches
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7061 (@pxref{Searching}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7062
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7063 @cindex root, in threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7064 @cindex siblings, in threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7065 @cindex ancestor, in threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7066
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7067 A thread begins with a single message called a @dfn{root}. All replies
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7068 to the same message are @dfn{siblings} of each other. Any message that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7069 has replies to it is an @dfn{ancestor} of those replies.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7070
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7071 There are several commands that you can use to navigate and operate on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7072 threads.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7073
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7074 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7075 @kindex T ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7076 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7077 @item T ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7078 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7079 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7080 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7081 @kindex T o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7082 @findex mh-thread-refile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7083 @item T o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7084 Refile (output) thread into folder (@code{mh-thread-refile}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7085 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7086 @kindex T d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7087 @findex mh-thread-delete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7088 @item T d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7089 Delete thread (@code{mh-thread-delete}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7090 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7091 @kindex T t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7092 @findex mh-toggle-threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7093 @item T t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7094 Toggle threaded view of folder (@code{mh-toggle-threads}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7095 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7096 @kindex T n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7097 @findex mh-thread-next-sibling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7098 @item T n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7099 Display next sibling (@code{mh-thread-next-sibling}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7100 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7101 @kindex T p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7102 @findex mh-thread-previous-sibling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7103 @item T p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7104 Display previous sibling (@code{mh-thread-previous-sibling}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7105 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7106 @kindex T u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7107 @findex mh-thread-ancestor
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7108 @item T u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7109 Display ancestor of current message (@code{mh-thread-ancestor}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7110 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7111
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7112 @cindex @samp{mh-thread} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7113 @cindex customization group, @samp{mh-thread}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7114
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7115 The @samp{mh-thread} customization group contains one option.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7116
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7117 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7118 @item mh-show-threads-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7119 On means new folders start in threaded mode (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7120 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7121
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7122 @findex mh-toggle-threads
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7123 @kindex T t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7124 @vindex mh-large-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7125 @vindex mh-show-threads-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7126
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7127 Threading large number of messages can be time consuming so the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7128 @code{mh-show-threads-flag} is turned off by default. If you turn on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7129 this option, then threading will be done only if the number of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7130 messages being threaded is less than @code{mh-large-folder}. In any
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7131 event, threading can be turned on (and off) with the command @kbd{T t}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7132 (@code{mh-toggle-threads}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7133
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7134 @findex mh-thread-ancestor
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7135 @findex mh-thread-next-sibling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7136 @findex mh-thread-previous-sibling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7137 @kindex T n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7138 @kindex T p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7139 @kindex T u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7140
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7141 There are a few commands to help you navigate threads. If you do not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7142 care for the way a particular thread has turned, you can move up the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7143 chain of messages with the command @kbd{T u}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7144 (@code{mh-thread-ancestor}. At any point you can use @kbd{T n}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7145 (@code{mh-thread-next-sibling} or @kbd{T p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7146 (@code{mh-thread-previous-sibling}) to jump to the next or previous
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7147 sibling, skipping the sub-threads. The command @kbd{T u} can also take
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7148 a prefix argument to jump to the message that started everything.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7149
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7150 @findex mh-delete-subject-or-thread
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7151 @findex mh-thread-delete
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7152 @findex mh-thread-refile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7153 @kindex k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7154 @kindex T d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7155 @kindex T o
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7156
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7157 There are threaded equivalents for the commands that delete and refile
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7158 messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7159 current message and all its children. Similarly, the command @kbd{T d}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7160 (@code{mh-thread-delete}) deletes the current message and all its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7161 children. These commands do not refile or delete sibling messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7162 @xref{Navigating}, for a description of the similar command @kbd{k}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7163 (@code{mh-delete-subject-or-thread}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7164
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7165 @vindex mh-large-folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7166
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7167 If you find that threading is too slow, it may be that you have
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7168 @code{mh-large-folder} set too high. Also, threading is one of the few
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7169 features of MH-E that really benefits from compiling. If you haven't
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7170 compiled MH-E, I encourage you to do so@footnote{If you're not sure if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7171 MH-E has been byte-compiled, you could try running @samp{locate
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7172 mh-thread.elc} or otherwise find MH-E on your system and ensure that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7173 @file{mh-thread.elc} exists. If you have multiple versions and you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7174 find that one is compiled but the other is not, then go into your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7175 @samp{*scratch*} buffer in Emacs, enter @kbd{load-path C-j}, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7176 ensure that the byte-compiled version appears first in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7177 @code{load-path}. If you find that MH-E is not compiled and you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7178 installed MH-E yourself, please refer to the installation directions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7179 in the file @file{README} in the distribution.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7180
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7181 @node Limits, Sequences, Threading, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7182 @chapter Limiting Display
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7183
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7184 @cindex limits
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7185 @cindex filters
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7186
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7187 Another way to organize messages in a folder besides threading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7188 (@pxref{Threading}) or using full-text indexed searches
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7189 (@pxref{Searching}) is by limiting the folder display to messages that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7190 are similar to the current message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7191
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7192 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7193 @kindex / ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7194 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7195 @item / ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7196 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7197 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7198 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7199 @cindex @samp{Sequence > Narrow to Tick Sequence} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7200 @cindex menu item, @samp{Sequence > Narrow to Tick Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7201 @kindex / '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7202 @findex mh-narrow-to-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7203 @item / '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7204 Limit to messages in the @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7205 (@code{mh-narrow-to-tick}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7206 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7207 @kindex / c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7208 @findex mh-narrow-to-cc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7209 @item / c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7210 Limit to messages with the same @samp{Cc:} field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7211 (@code{mh-narrow-to-cc}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7212 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7213 @kindex / m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7214 @findex mh-narrow-to-from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7215 @item / m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7216 Limit to messages with the same @samp{From:} field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7217 (@code{mh-narrow-to-from}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7218 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7219 @kindex / g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7220 @findex mh-narrow-to-range
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7221 @item / g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7222 Limit to range (@code{mh-narrow-to-range}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7223 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7224 @cindex @samp{Sequence > Narrow to Subject Sequence} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7225 @cindex menu item, @samp{Sequence > Narrow to Subject Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7226 @kindex / s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7227 @findex mh-narrow-to-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7228 @item / s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7229 Limit to messages with the same @samp{Subject:} field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7230 (@code{mh-narrow-to-subject}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7231 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7232 @kindex / t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7233 @findex mh-narrow-to-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7234 @item / t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7235 Limit to messages with the same @samp{To:} field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7236 (@code{mh-narrow-to-to}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7237 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7238 @cindex @samp{Sequence > Widen from Sequence} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7239 @cindex menu item, @samp{Sequence > Widen from Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7240 @kindex / w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7241 @findex mh-widen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7242 @item / w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7243 Remove last restriction (@code{mh-widen}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7244 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7245
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7246 All of the limiting commands above refine the display in some way.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7247
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7248 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7249 @cindex MH commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7250 @findex mh-narrow-to-cc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7251 @findex mh-narrow-to-from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7252 @findex mh-narrow-to-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7253 @findex mh-narrow-to-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7254 @kindex / c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7255 @kindex / m
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7256 @kindex / s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7257 @kindex / t
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7258
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7259 The commands @kbd{/ c} (@code{mh-narrow-to-cc}), @kbd{/ m}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7260 (@code{mh-narrow-to-from}), @kbd{/ s} (@code{mh-narrow-to-subject}),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7261 and @kbd{/ t} (@code{mh-narrow-to-to}) restrict the display to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7262 messages matching the content of the respective field in the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7263 message. However, you can give any of these a prefix argument to edit
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7264 the @command{pick} expression used to narrow the view@footnote{See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7265 @command{pick}(1) or the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7266 @uref{@value{MH-BOOK-HOME}/finpic.html, Finding Messages with pick} in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7267 the MH book.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7268
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7269 @cindex @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7270 @cindex sequence, @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7271 @cindex ticked messages, viewing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7272 @findex mh-narrow-to-range
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7273 @findex mh-narrow-to-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7274 @kindex / '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7275 @kindex / g
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7276
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7277 You can also limit the display to messages in the @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7278 with the command @kbd{/ '} (@code{mh-narrow-to-tick}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7279 @xref{Sequences}, for information on putting message into the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7280 @samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7281 command to limit the display to messages in a range (@pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7282
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7283 @findex mh-widen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7284 @kindex / w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7285
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7286 Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7287 command. Give this command a prefix argument to remove all limits.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7288
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7289 @node Sequences, Junk, Limits, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7290 @chapter Using Sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7291
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7292 @cindex @samp{Sequence} menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7293 @cindex menu, @samp{Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7294 @cindex sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7295
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7296 For the whole scoop on MH sequences, refer to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7297 @samp{mh-sequence}(5)@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7298 @uref{@value{MH-BOOK-HOME}/morseq.html, More About Sequences} in the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7299 book.}. As you've read, several of the MH-E commands can operate on a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7300 sequence, which is a shorthand for a range or group of messages. For
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7301 example, you might want to forward several messages to a friend or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7302 colleague. Here's how to manipulate sequences. These commands are also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7303 available in the @samp{Sequence} menu.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7304
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7305 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7306 @cindex @samp{Sequence > Toggle Tick Mark} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7307 @cindex menu item, @samp{Sequence > Toggle Tick Mark}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7308 @kindex '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7309 @findex mh-toggle-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7310 @item '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7311 Toggle tick mark of range (@code{mh-toggle-tick}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7312 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7313 @kindex S ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7314 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7315 @item S ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7316 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7317 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7318 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7319 @cindex @samp{Sequence > Narrow to Tick Sequence} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7320 @cindex menu item, @samp{Sequence > Narrow to Tick Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7321 @kindex S '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7322 @findex mh-narrow-to-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7323 @item S '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7324 Limit to ticked messages (@code{mh-narrow-to-tick}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7325 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7326 @cindex @samp{Sequence > Delete Message from Sequence...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7327 @cindex menu item, @samp{Sequence > Delete Message from Sequence...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7328 @kindex S d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7329 @findex mh-delete-msg-from-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7330 @item S d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7331 Delete range from sequence (@code{mh-delete-msg-from-seq}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7332 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7333 @cindex @samp{Sequence > Delete Sequence...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7334 @cindex menu item, @samp{Sequence > Delete Sequence...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7335 @kindex S k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7336 @findex mh-delete-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7337 @item S k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7338 Delete sequence (@code{mh-delete-seq}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7339 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7340 @cindex @samp{Sequence > List Sequences in Folder...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7341 @cindex menu item, @samp{Sequence > List Sequences in Folder...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7342 @kindex S l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7343 @findex mh-list-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7344 @item S l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7345 List all sequences in folder (@code{mh-list-sequences}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7346 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7347 @cindex @samp{Sequence > Narrow to Sequence...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7348 @cindex menu item, @samp{Sequence > Narrow to Sequence...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7349 @kindex S n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7350 @findex mh-narrow-to-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7351 @item S n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7352 Restrict display to messages in sequence (@code{mh-narrow-to-seq}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7353 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7354 @cindex @samp{Sequence > Add Message to Sequence...} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7355 @cindex menu item, @samp{Sequence > Add Message to Sequence...}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7356 @kindex S p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7357 @findex mh-put-msg-in-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7358 @item S p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7359 Add range to sequence (@code{mh-put-msg-in-seq}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7360 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7361 @cindex @samp{Sequence > List Sequences for Message} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7362 @cindex menu item, @samp{Sequence > List Sequences for Message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7363 @kindex S s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7364 @findex mh-msg-is-in-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7365 @item S s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7366 Display the sequences in which the current message appears
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7367 (@code{mh-msg-is-in-seq}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7368 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7369 @cindex @samp{Sequence > Widen from Sequence} menu item
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7370 @cindex menu item, @samp{Sequence > Widen from Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7371 @kindex S w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7372 @findex mh-widen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7373 @item S w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7374 Remove last restriction (@code{mh-widen}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7375 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7376 @findex mh-update-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7377 @item M-x mh-update-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7378 Flush MH-E's state out to MH@.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7379 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7380
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7381 @cindex @samp{mh-sequences} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7382 @cindex customization group, @samp{mh-sequences}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7383
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7384 The @samp{mh-sequences} customization group contains the options
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7385 associated with sequences.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7386
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7387 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7388 @item mh-refile-preserves-sequences-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7389 On means that sequences are preserved when messages are refiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7390 (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7391 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7392 @item mh-tick-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7393 The name of the MH sequence for ticked messages (default: @samp{'tick}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7394 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7395 @item mh-update-sequences-after-mh-show-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7396 On means flush MH sequences to disk after message is shown (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7397 @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7398 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7399
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7400 The following hook is available.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7401
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7402 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7403 @item mh-unseen-updated-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7404 Hook run after the unseen sequence has been updated (default: @code{nil}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7405 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7406
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7407 @cindex @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7408 @cindex MH commands, @command{pick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7409 @findex mh-put-msg-in-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7410 @kindex S p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7411
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7412 To place a message in a sequence, use @kbd{S p}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7413 (@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7414 the messages in a sequence to another sequence (for example, @kbd{C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7415 S p SourceSequence @key{RET} DestSequence @key{RET}}, @pxref{Ranges}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7416
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7417 @cindex @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7418 @cindex sequence, @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7419 @cindex ticking messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7420 @findex mh-index-ticked-messages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7421 @findex mh-toggle-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7422 @kindex '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7423 @kindex F '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7424 @kindex S p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7425
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7426 One specific use of the @kbd{S p} command is @kbd{'}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7427 (@code{mh-toggle-tick}) which adds messages to the @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7428 sequence. This sequence can be viewed later with the @kbd{F '}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7429 (@code{mh-index-ticked-messages}) command (@pxref{Folders}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7430
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7431 @vindex mh-tick-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7432
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7433 You can customize the option @code{mh-tick-seq} if you already use the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7434 @samp{tick} sequence for your own use. You can also disable all of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7435 ticking functions by choosing the @samp{Disable Ticking} item but
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7436 there isn't much advantage to that.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7437
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7438 @cindex MH-Folder mode
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7439 @cindex modes, MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7440 @findex mh-narrow-to-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7441 @findex mh-narrow-to-tick
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7442 @findex mh-widen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7443 @kindex S '
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7444 @kindex S n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7445 @kindex S w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7446
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7447 Once you've placed some messages in a sequence, you may wish to narrow
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7448 the field of view to just those messages in the sequence you've
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7449 created. To do this, use @kbd{S n} (@code{mh-narrow-to-seq}). You are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7450 prompted for the name of the sequence. What this does is show only
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7451 those messages that are in the selected sequence in the MH-Folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7452 buffer. In addition, it limits further MH-E searches to just those
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7453 messages. To narrow the view to the messages in the @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7454 sequence, use @kbd{S '} (@code{mh-narrow-to-tick}). When you want to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7455 widen the view to all your messages again, use @kbd{S w}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7456 (@code{mh-widen}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7457
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7458 @cindex buffers, @samp{*MH-E Sequences*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7459 @cindex @samp{*MH-E Sequences*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7460 @findex mh-list-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7461 @findex mh-msg-is-in-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7462 @kindex S l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7463 @kindex S s
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7464
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7465 You can see which sequences in which a message appears with the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7466 command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7467 display the sequences in which another message appears (as in @kbd{C-u
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7468 42 S s @key{RET}}). Or, you can list all sequences in a selected
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7469 folder (default is current folder) with @kbd{S l}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7470 (@code{mh-list-sequences}). The list appears in a buffer named
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7471 @samp{*MH-E Sequences*} (@pxref{Miscellaneous}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7472
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7473 @cindex MH profile component, @samp{Previous-Sequence:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7474 @cindex @samp{cur} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7475 @cindex @samp{Previous-Sequence:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7476 @cindex sequence, @samp{cur}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7477 @cindex sequence, @samp{Previous-Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7478 @vindex mh-refile-preserves-sequences-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7479
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7480 If a message is in any sequence (except
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7481 @samp{Previous-Sequence:}@footnote{See @samp{mh-profile}(5)).} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7482 @samp{cur}) when it is refiled, then it will still be in those
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7483 sequences in the destination folder. If this behavior is not desired,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7484 then turn off the option @code{mh-refile-preserves-sequences-flag}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7485
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7486 @findex mh-delete-msg-from-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7487 @findex mh-delete-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7488 @kindex d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7489 @kindex S d
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7490 @kindex S k
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7491
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7492 If you want to remove a message (or range, @pxref{Ranges}) from a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7493 sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7494 to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7495 the latter case you are prompted for the sequence to delete. Note that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7496 this deletes only the sequence, not the messages in the sequence. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7497 you want to delete the messages, use @kbd{C-u d} (@pxref{Reading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7498 Mail}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7499
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7500 @cindex @samp{Unseen-Sequence:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7501 @cindex @samp{cur} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7502 @cindex @samp{tick} sequence
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7503 @cindex MH profile component, @samp{Unseen-Sequence:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7504 @cindex sequence, @samp{Unseen-Sequence}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7505 @cindex sequence, @samp{cur}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7506 @cindex sequence, @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7507 @findex mh-update-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7508 @kindex M-x mh-update-sequences
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7509 @kindex q
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7510 @kindex x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7511 @vindex mh-tick-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7512 @vindex mh-update-sequences-after-mh-show-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7513
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7514 Three sequences are maintained internally by MH-E and pushed out to MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7515 when a message is shown. They include the sequence specified by your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7516 @samp{Unseen-Sequence:} profile component, @samp{cur}, and the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7517 sequence listed by the option @code{mh-tick-seq} which is @samp{tick}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7518 by default. If you do not like this behavior, turn off the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7519 @code{mh-update-sequences-after-mh-show-flag}. You can then update the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7520 state manually with the @kbd{x}, @kbd{q}, or @kbd{M-x
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7521 mh-update-sequences} commands.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7522
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7523 @vindex mh-seen-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7524 @vindex mh-unseen-updated-hook
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7525
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7526 The hook @code{mh-unseen-updated-hook} is run after the unseen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7527 sequence has been updated. The variable @code{mh-seen-list} can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7528 used by this hook to obtain the list of messages which were removed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7529 from the unseen sequence.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7530
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7531 @cindex @command{mark}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7532 @cindex MH commands, @command{mark}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7533 @kindex S n
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7534 @kindex S w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7535
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7536 With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7537 command dealing with sequences is @command{mark}@footnote{See the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7538 section @uref{@value{MH-BOOK-HOME}/mmbwm.html, Make Message Bookmarks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7539 with mark} in the MH book.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7540
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7541 @node Junk, Miscellaneous, Sequences, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7542 @chapter Dealing With Junk Mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7543
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7544 @cindex Marshall Rose
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7545 @cindex junk mail
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7546 @cindex spam
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7547
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7548 Marshall Rose once wrote a paper on MH entitled, @cite{How to process
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7549 200 messages a day and still get some real work done}. This chapter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7550 could be entitled, @cite{How to process 1000 spams a day and still get
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7551 some real work done}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7552
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7553 @cindex blacklisting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7554 @cindex ham
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7555 @cindex viruses
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7556 @cindex whitelisting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7557 @cindex worms
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7558
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7559 We use the terms @dfn{junk mail} and @dfn{spam} interchangeably for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7560 any unwanted message which includes spam, @dfn{viruses}, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7561 @dfn{worms}. The opposite of spam is @dfn{ham}. The act of classifying
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7562 a sender as one who sends junk mail is called @dfn{blacklisting}; the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7563 opposite is called @dfn{whitelisting}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7564
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7565 @table @kbd
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7566 @kindex J ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7567 @findex mh-prefix-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7568 @item J ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7569 Display cheat sheet for the commands of the current prefix in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7570 minibuffer (@code{mh-prefix-help}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7571 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7572 @kindex J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7573 @findex mh-junk-blacklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7574 @item J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7575 Blacklist range as spam (@code{mh-junk-blacklist}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7576 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7577 @kindex J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7578 @findex mh-junk-whitelist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7579 @item J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7580 Whitelist range as ham (@code{mh-junk-whitelist}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7581 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7582 @item @code{mh-spamassassin-identify-spammers}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7583 Identify spammers who are repeat offenders.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7584 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7585
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7586 @cindex @samp{mh-junk} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7587 @cindex customization group, @samp{mh-junk}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7588
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7589 The following table lists the options from the @samp{mh-junk}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7590 customization group.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7591
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7592 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7593 @item mh-junk-background
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7594 If on, spam programs are run in background (default: @samp{off}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7595 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7596 @item mh-junk-disposition
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7597 Disposition of junk mail (default: @samp{Delete Spam}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7598 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7599 @item mh-junk-program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7600 Spam program that MH-E should use (default: @samp{Auto-detect}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7601 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7602
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7603 @cindex SpamProbe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7604 @cindex Spamassassin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7605 @cindex bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7606 @cindex spam filters, SpamProbe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7607 @cindex spam filters, Spamassassin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7608 @cindex spam filters, bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7609
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7610 MH-E depends on @uref{http://spamassassin.apache.org/, SpamAssassin},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7611 @uref{http://bogofilter.sourceforge.net/, bogofilter}, or
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7612 @uref{http://spamprobe.sourceforge.net/, SpamProbe} to throw the dreck
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7613 away. This chapter describes briefly how to configure these programs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7614 to work well with MH-E and how to use MH-E's interface that provides
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7615 continuing education for these programs.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7616
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7617 @vindex mh-junk-program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7618
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7619 The default setting of the option @code{mh-junk-program} is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7620 @samp{Auto-detect} which means that MH-E will automatically choose one
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7621 of SpamAssassin, bogofilter, or SpamProbe in that order. If, for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7622 example, you have both SpamAssassin and bogofilter installed and you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7623 want to use bogofilter, then you can set this option to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7624 @samp{Bogofilter}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7625
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7626 @findex mh-junk-blacklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7627 @kindex J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7628 @vindex mh-junk-disposition
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7629
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7630 The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7631 program in use with the content of the range (@pxref{Ranges}) and then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7632 handles the message(s) as specified by the option
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7633 @code{mh-junk-disposition}. By default, this option is set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7634 @samp{Delete Spam} but you can also specify the name of the folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7635 which is useful for building a corpus of spam for training purposes.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7636
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7637 @findex mh-junk-whitelist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7638 @kindex J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7639
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7640 In contrast, the command @kbd{J w} (@code{mh-junk-whitelist})
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7641 reclassifies a range of messages (@pxref{Ranges}) as ham if it were
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7642 incorrectly classified as spam. It then refiles the message into the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7643 @file{+inbox} folder.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7644
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7645 @cindex @samp{*MH-E Log*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7646 @cindex buffers, @samp{*MH-E Log*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7647 @findex call-process
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7648 @vindex mh-junk-background
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7649
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7650 By default, the programs are run in the foreground, but this can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7651 slow when junking large numbers of messages. If you have enough memory
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7652 or don't junk that many messages at the same time, you might try
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7653 turning on the option @code{mh-junk-background}. @footnote{Note that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7654 the option @code{mh-junk-background} is used as the @code{display}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7655 argument in the call to @code{call-process}. Therefore, turning on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7656 this option means setting its value to @samp{0}. You can also set its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7657 value to @samp{t} to direct the programs' output to the @samp{*MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7658 Log*} buffer; this may be useful for debugging.}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7659
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7660 The following sections discuss the various counter-spam measures that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7661 MH-E can work with.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7662
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7663 @cindex @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7664 @cindex files, @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7666 @subheading SpamAssassin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7667
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7668 @cindex Spamassassin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7669 @cindex spam filters, Spamassassin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7670
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7671 SpamAssassin is one of the more popular spam filtering programs. Get
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7672 it from your local distribution or from the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7673 @uref{http://spamassassin.apache.org/, SpamAssassin web site}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7674
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7675 To use SpamAssassin, add the following recipes to @file{~/.procmailrc}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7676
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7677 @cindex @command{spamc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7678 @cindex @samp{X-Spam-Level:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7679 @cindex @samp{X-Spam-Status:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7680 @cindex header field, @samp{X-Spam-Level:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7681 @cindex header field, @samp{X-Spam-Status:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7682
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7683 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7684 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7685 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7686
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7687 # Fight spam with SpamAssassin.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7688 :0fw
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7689 | spamc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7690
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7691 # Anything with a spam level of 10 or more is junked immediately.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7692 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7693 * ^X-Spam-Level: ..........
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7694 /dev/null
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7695
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7696 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7697 * ^X-Spam-Status: Yes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7698 spam/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7699 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7700
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7701 If you don't use @command{spamc}, use @samp{spamassassin -P -a}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7702
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7703 Note that one of the recipes above throws away messages with a score
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7704 greater than or equal to 10. Here's how you can determine a value that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7705 works best for you.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7706
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7707 First, run @samp{spamassassin -t} on every mail message in your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7708 archive and use @command{gnumeric} to verify that the average plus the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7709 standard deviation of good mail is under 5, the SpamAssassin default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7710 for ``spam''.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7711
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7712 Using @command{gnumeric}, sort the messages by score and view the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7713 messages with the highest score. Determine the score which encompasses
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7714 all of your interesting messages and add a couple of points to be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7715 conservative. Add that many dots to the @samp{X-Spam-Level:} header
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7716 field above to send messages with that score down the drain.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7717
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7718 In the example above, messages with a score of 5-9 are set aside in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7719 the @samp{+spam} folder for later review. The major weakness of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7720 rules-based filters is a plethora of false positives so it is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7721 worthwhile to check.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7722
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7723 @findex mh-junk-blacklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7724 @findex mh-junk-whitelist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7725 @kindex J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7726 @kindex J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7727
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7728 If SpamAssassin classifies a message incorrectly, or is unsure, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7729 use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7730 @kbd{J w} (@code{mh-junk-whitelist}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7731
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7732 @cindex @command{sa-learn}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7733 @cindex @file{.spamassassin/user_prefs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7734 @cindex files, @file{.spamassassin/user_prefs}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7735
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7736 The command @kbd{J b} (@code{mh-junk-blacklist}) adds a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7737 @samp{blacklist_from} entry to @file{~/spamassassin/user_prefs},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7738 deletes the message, and sends the message to the Razor, so that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7739 others might not see this spam. If the @command{sa-learn} command is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7740 available, the message is also recategorized as spam.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7741
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7742 The command@kbd{J w} (@code{mh-junk-whitelist}) adds a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7743 @samp{whitelist_from} rule to @samp{~/.spamassassin/user_prefs}. If
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7744 the @command{sa-learn} command is available, the message is also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7745 recategorized as ham.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7746
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7747 Over time, you'll observe that the same host or domain occurs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7748 repeatedly in the @samp{blacklist_from} entries, so you might think
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7749 that you could avoid future spam by blacklisting all mail from a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7750 particular domain. The utility function
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7751 @code{mh-spamassassin-identify-spammers} helps you do precisely that.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7752 This function displays a frequency count of the hosts and domains in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7753 the @samp{blacklist_from} entries from the last blank line in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7754 @file{~/.spamassassin/user_prefs} to the end of the file. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7755 information can be used so that you can replace multiple
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7756 @samp{blacklist_from} entries with a single wildcard entry such as:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7757
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7758 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7759 blacklist_from *@@*amazingoffersdirect2u.com
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7760 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7761
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7762 In versions of SpamAssassin (2.50 and on) that support a Bayesian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7763 classifier, @kbd{J b} @code{(mh-junk-blacklist}) uses the program
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7764 @command{sa-learn} to recategorize the message as spam. Neither MH-E,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7765 nor SpamAssassin, rebuilds the database after adding words, so you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7766 will need to run @samp{sa-learn --rebuild} periodically. This can be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7767 done by adding the following to your @file{crontab}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7768
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7769 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7770 0 * * * * sa-learn --rebuild > /dev/null 2>&1
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7771 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7772
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7773 @subheading Bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7774
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7775 @cindex bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7776 @cindex spam filters, bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7777
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7778 Bogofilter is a Bayesian spam filtering program. Get it from your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7779 local distribution or from the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7780 @uref{http://bogofilter.sourceforge.net/, bogofilter web site}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7781
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7782 Bogofilter is taught by running:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7783
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7784 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7785 bogofilter -n < good-message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7786 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7787
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7788 on every good message, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7789
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7790 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7791 bogofilter -s < spam-message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7792 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7793
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7794 @cindex full training
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7795
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7796 on every spam message. This is called a @dfn{full training}; three
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7797 other training methods are described in the FAQ that is distributed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7798 with bogofilter. Note that most Bayesian filters need 1000 to 5000 of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7799 each type of message to start doing a good job.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7800
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7801 To use bogofilter, add the following recipes to @file{~/.procmailrc}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7802
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7803 @cindex @samp{X-Bogosity:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7804 @cindex header field, @samp{X-Bogosity:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7805
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7806 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7807 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7808 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7809
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7810 # Fight spam with Bogofilter.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7811 :0fw
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7812 | bogofilter -3 -e -p
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7813
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7814 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7815 * ^X-Bogosity: Yes, tests=bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7816 spam/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7817
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7818 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7819 * ^X-Bogosity: Unsure, tests=bogofilter
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7820 spam/unsure/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7821 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7822
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7823 @findex mh-junk-blacklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7824 @findex mh-junk-whitelist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7825 @kindex J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7826 @kindex J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7827
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7828 If bogofilter classifies a message incorrectly, or is unsure, you can
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7829 use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7830 w} (@code{mh-junk-whitelist}) to update bogofilter's training.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7831
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7832 The @cite{Bogofilter FAQ} suggests that you run the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7833 occasionally to shrink the database:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7834
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7835 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7836 bogoutil -d wordlist.db | bogoutil -l wordlist.db.new
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7837 mv wordlist.db wordlist.db.prv
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7838 mv wordlist.db.new wordlist.db
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7839 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7840
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7841 The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7842 bogofilter.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7843
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7844 @subheading SpamProbe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7845
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7846 @cindex SpamProbe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7847 @cindex spam filters, SpamProbe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7848
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7849 SpamProbe is a Bayesian spam filtering program. Get it from your local
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7850 distribution or from the @uref{http://spamprobe.sourceforge.net,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7851 SpamProbe web site}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7852
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7853 To use SpamProbe, add the following recipes to @file{~/.procmailrc}:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7854
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7855 @cindex @command{formail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7856 @cindex @samp{X-SpamProbe:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7857 @cindex header field, @samp{X-SpamProbe:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7858
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7859 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7860 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7861 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7862
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7863 # Fight spam with SpamProbe.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7864 :0
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7865 SCORE=| spamprobe receive
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7866
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7867 :0 wf
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7868 | formail -I "X-SpamProbe: $SCORE"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7869
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7870 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7871 *^X-SpamProbe: SPAM
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7872 spam/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7873 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7874
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7875 @findex mh-junk-blacklist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7876 @findex mh-junk-whitelist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7877 @kindex J b
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7878 @kindex J w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7879
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7880 If SpamProbe classifies a message incorrectly, you can use the MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7881 commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7882 (@code{mh-junk-whitelist}) to update SpamProbe's training.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7883
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7884 @subheading Other Things You Can Do
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7885
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7886 There are a couple of things that you can add to @file{~/.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7887 in order to filter out a lot of spam and viruses. The first is to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7888 eliminate any message with a Windows executable (which is most likely
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7889 a virus). The second is to eliminate mail in character sets that you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7890 can't read.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7891
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7892 @cindex @samp{Content-Transfer-Encoding:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7893 @cindex @samp{Content-Type:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7894 @cindex @samp{Subject:} header field
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7895 @cindex header field, @samp{Content-Transfer-Encoding:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7896 @cindex header field, @samp{Content-Type:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7897 @cindex header field, @samp{Subject:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7898
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7899 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7900 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7901 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7902
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7903 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7904 # Filter messages with win32 executables/virii.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7905 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7906 # These attachments are base64 and have a TVqQAAMAAAAEAAAA//8AALg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7907 # pattern. The string "this program cannot be run in MS-DOS mode"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7908 # encoded in base64 is 4fug4AtAnNIbg and helps to avoid false
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7909 # positives (Roland Smith via Pete from the bogofilter mailing list).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7910 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7911 :0 B:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7912 * ^Content-Transfer-Encoding:.*base64
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7913 * ^TVqQAAMAAAAEAAAA//8AALg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7914 * 4fug4AtAnNIbg
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7915 spam/exe/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7916
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7917 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7918 # Filter mail in unreadable character sets (from the Bogofilter FAQ).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7919 #
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7920 UNREADABLE='[^?"]*big5|iso-2022-jp|ISO-2022-KR|euc-kr|gb2312|ks_c_5601-1987'
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7921
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7922 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7923 * 1^0 $ ^Subject:.*=\?($UNREADABLE)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7924 * 1^0 $ ^Content-Type:.*charset="?($UNREADABLE)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7925 spam/unreadable/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7926
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7927 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7928 * ^Content-Type:.*multipart
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7929 * B ?? $ ^Content-Type:.*^?.*charset="?($UNREADABLE)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7930 spam/unreadable/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7931 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7932
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7933 @node Miscellaneous, Scan Line Formats, Junk, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7934 @chapter Miscellaneous Commands, Variables, and Buffers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7935
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7936 This chapter covers the following command and the various MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7937 buffers,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7938
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7939 @ftable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7940 @item mh-version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7941 Display version information about MH-E and the MH mail handling
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7942 system.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7943 @end ftable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7944
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7945 @cindex buffers, @samp{*MH-E Info*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7946 @cindex MH-E version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7947 @cindex @samp{*MH-E Info*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7948 @cindex version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7949 @kindex M-x mh-version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7950
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7951 One command worth noting is @kbd{M-x mh-version}. You can compare the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7952 version this command prints to the latest release (@pxref{Getting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7953 MH-E}). The output of @kbd{M-x mh-version}, found in a buffer named
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7954 @samp{*MH-E Info*}, should usually be included with any bug report you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7955 submit (@pxref{Bug Reports}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7956
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7957 @subheading MH-E Buffers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7958
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7959 Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7960 several other buffers. They are:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7961
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7962 @table @samp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7963 @cindex @samp{*MH-E Folders*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7964 @cindex buffers, @samp{*MH-E Folders*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7965 @findex mh-list-folders
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7966 @item *MH-E Folders*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7967 @kindex F l
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7968 This buffer contains the output of @kbd{F l} (@code{mh-list-folders}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7969 @xref{Folders}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7970 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7971 @cindex @samp{*MH-E Help*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7972 @cindex buffers, @samp{*MH-E Help*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7973 @findex mh-help
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7974 @item *MH-E Help*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7975 @kindex ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7976 @kindex C-c ?
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7977 This buffer contains the output of @kbd{?} (@code{mh-help}) and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7978 @kbd{C-c ?} in MH-Letter mode. @xref{Using This Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7979 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7980 @cindex @samp{*MH-E Info*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7981 @cindex buffers, @samp{*MH-E Info*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7982 @item *MH-E Info*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7983 This buffer contains the output of @kbd{M-x mh-version @key{RET}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7984 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7985 @cindex @samp{*MH-E Log*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7986 @cindex buffers, @samp{*MH-E Log*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7987 @item *MH-E Log*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7988 This buffer contains the last 100 lines of the output of the various
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7989 MH commands.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7990 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7991 @cindex @samp{*MH-E Mail Delivery*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7992 @cindex buffers, @samp{*MH-E Mail Delivery*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7993 @item *MH-E Mail Delivery*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7994 This buffer contains the transcript of a mail delivery. @xref{Sending
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7995 Message}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7996 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7997 @cindex @samp{*MH-E Recipients*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7998 @cindex buffers, @samp{*MH-E Recipients*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7999 @findex mh-check-whom
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8000 @item *MH-E Recipients*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8001 @kindex C-c C-w
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8002 This buffer contains the output of @kbd{C-c C-w}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8003 (@code{mh-check-whom}) and is killed when draft is sent.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8004 @xref{Checking Recipients}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8005 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8006 @cindex @samp{*MH-E Sequences*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8007 @cindex buffers, @samp{*MH-E Sequences*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8008 @item *MH-E Sequences*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8009 This buffer contains the output of @kbd{S l}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8010 (@code{mh-list-sequences}). @xref{Sequences}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8011 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8012 @cindex @samp{*mh-temp*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8013 @cindex buffers, @samp{*mh-temp*}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8014 @item *mh-temp*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8015 This is a scratch, ephemeral, buffer used by MH-E functions. Note that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8016 it is hidden because the first character in the name is a space.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8017 You'll generally not have any need for this buffer.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8018 @end table
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8019
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8020 @node Scan Line Formats, Procmail, Miscellaneous, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8021 @appendix Scan Line Formats
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8022
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8023 @cindex scan line formats
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8024
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8025 This appendix discusses how MH-E creates, parses, and manipulates scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8026 lines. If you have your own MH scan or inc format files, you
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8027 @strong{can} teach MH-E how to handle them, but it isn't easy as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8028 you'll see.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8029
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8030 @cindex @samp{mh-scan-line-formats} customization group
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8031 @cindex customization group, @samp{mh-scan-line-formats}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8032
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8033 This table lists the options in the @samp{mh-scan-line-formats}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8034 customization group.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8035
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8036 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8037 @item mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8038 On means that the message number width is determined dynamically
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8039 (default: @samp{on}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8040 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8041 @item mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8042 Specifies the format file to pass to the scan program (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8043 @samp{Use MH-E scan Format}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8044 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8045 @item mh-scan-prog
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8046 Program used to scan messages (default: @code{"scan"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8047 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8048
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8049 @vindex mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8050
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8051 There are a couple of caveats when creating your own scan format file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8052 First, MH-E will not work if your scan lines do not include message
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8053 numbers. It will work poorly if you don't dedicate a column for
100840
94e2c2dbfed1 (Scan Line Formats): Indicate that first column should be kept empty.
Bill Wohler <wohler@newt.com>
parents: 99709
diff changeset
8054 showing the current message and notations. It is also best to keep the
100842
3c1eec3da09d (Scan Line Formats): Keep first column empty also for the cursor.
Bill Wohler <wohler@newt.com>
parents: 100840
diff changeset
8055 first column empty to make room for the cursor and so that text isn't
3c1eec3da09d (Scan Line Formats): Keep first column empty also for the cursor.
Bill Wohler <wohler@newt.com>
parents: 100840
diff changeset
8056 obscured by the current message's overlay arrow when running in a
3c1eec3da09d (Scan Line Formats): Keep first column empty also for the cursor.
Bill Wohler <wohler@newt.com>
parents: 100840
diff changeset
8057 terminal. You won't be able to use the option
3c1eec3da09d (Scan Line Formats): Keep first column empty also for the cursor.
Bill Wohler <wohler@newt.com>
parents: 100840
diff changeset
8058 @code{mh-adaptive-cmd-note-flag} or the threading features
3c1eec3da09d (Scan Line Formats): Keep first column empty also for the cursor.
Bill Wohler <wohler@newt.com>
parents: 100840
diff changeset
8059 (@pxref{Threading}).
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8060
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8061 @cindex message numbers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8062 @findex mh-set-cmd-note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8063 @vindex mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8064 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8065
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8066 If you've created your own format to handle long message numbers,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8067 you'll be pleased to know you no longer need it since MH-E adapts its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8068 internal format based upon the largest message number if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8069 @code{mh-adaptive-cmd-note-flag} is on (the default). If you prefer
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8070 fixed-width message numbers, turn off @code{mh-adaptive-cmd-note-flag}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8071 and call @code{mh-set-cmd-note} with the width specified by your
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8072 format file (see @code{mh-scan-format-file}). For example, the default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8073 width is 4, so you would use @samp{(mh-set-cmd-note 4)}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8074
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8075 @vindex mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8076 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8077 @vindex mh-scan-format-mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8078 @vindex mh-scan-format-nmh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8079
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8080 The default setting for @code{mh-scan-format-file} is @samp{Use MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8081 scan Format}. This means that the format string will be taken from the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8082 either @code{mh-scan-format-mh} or @code{mh-scan-format-nmh} depending
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8083 on whether MH or nmh (or GNU mailutils MH) is in use. This setting
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8084 also enables you to turn on the option
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8085 @code{mh-adaptive-cmd-note-flag}. You can also set this option to
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8086 @samp{Use Default scan Format} to get the same output as you would get
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8087 if you ran @command{scan} from the shell. If you have a format file
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8088 that you want MH-E to use but not MH, you can set this option to
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8089 @samp{Specify a scan Format File} and enter the name of your format
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8090 file.
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8091
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8092 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8093 @vindex mh-scan-format-mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8094 @vindex mh-scan-format-nmh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8095
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8096 The scan format that MH-E uses when @code{mh-scan-format-file} is set
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8097 to its default of @samp{Use MH-E scan Format} is held in the variables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8098 @code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8099 whether you are using nmh (or GNU mailutils MH) or not. Typically, you
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8100 create your own format files rather than modifying these variables.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8101 The value of @code{mh-scan-format-nmh} is:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8102
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8103 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8104 (concat
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8105 "%4(msg)"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8106 "%<(cur)+%| %>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8107 "%<@{replied@}-"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8108 "%?(nonnull(comp@{to@}))%<(mymbox@{to@})t%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8109 "%?(nonnull(comp@{cc@}))%<(mymbox@{cc@})c%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8110 "%?(nonnull(comp@{bcc@}))%<(mymbox@{bcc@})b%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8111 "%?(nonnull(comp@{newsgroups@}))n%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8112 "%<(zero) %>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8113 "%02(mon@{date@})/%02(mday@{date@})%<@{date@} %|*%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8114 "%<(mymbox@{from@})%<@{to@}To:%14(decode(friendly@{to@}))%>%>"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8115 "%<(zero)%17(decode(friendly@{from@}))%> "
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8116 "%(decode@{subject@})%<@{body@}<<%@{body@}%>")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8117 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8118
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8119 @cindex decoding RFC 2047
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8120 @cindex RFC 2047, decoding
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8121 @vindex mh-scan-format-mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8122
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8123 The setting for @code{mh-scan-format-mh} is similar, except that MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8124 doesn't have the function @code{decode} (which is used to decode RFC
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8125 2047 encodings).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8126
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8127 @cindex notations, scan line
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8128 @cindex scan line notations
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8129
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8130 These strings are passed to the @command{scan} program via the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8131 @option{-format} argument. The formats are identical to the defaults
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8132 except that additional hints for fontification have been added to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8133 existing notations in the fifth column (remember that in Emacs, the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8134 columns start at 0). The values of the fifth column, in priority
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8135 order, are: @samp{-} if the message has been replied to, @samp{t} if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8136 an address in the @samp{To:} field matches one of the mailboxes of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8137 current user, @samp{c} if the @samp{Cc:} field matches, @samp{b} if
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8138 the @samp{Bcc:} field matches, and @samp{n} if a non-empty
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8139 @samp{Newsgroups:} field is present.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8140
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8141 @cindex @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8142 @cindex MH commands, @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8143 @vindex mh-progs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8144 @vindex mh-scan-prog
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8145
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8146 The name of the program that generates a listing of one line per
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8147 message is held in @code{mh-scan-prog} (default: @code{"scan"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8148 Unless this variable contains an absolute pathname, it is assumed to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8149 be in the @code{mh-progs} directory (@pxref{Getting Started}). You may
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8150 link another program to @command{scan} (see @samp{mh-profile}(5)) to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8151 produce a different type of listing@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8152 @uref{@value{MH-BOOK-HOME}/faswsprs.html, Find and Specify with scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8153 pick Ranges Sequences} in the MH book.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8154
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8155 @cindex regular expressions, scan line formats
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8156 @findex mh-set-cmd-note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8157 @findex setq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8158
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8159 If you change the format of the scan lines you'll need to tell MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8160 how to parse the new format. As you will see, quite a lot of variables
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8161 are involved to do that. Use @kbd{M-x apropos @key{RET}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8162 mh-scan.*regexp @key{RET}} to obtain a list of these variables. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8163 will also have to call @code{mh-set-cmd-note} if your notations are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8164 not in column 4 (columns in Emacs start with 0). Note that unlike most
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8165 of the user options described in this manual, these are variables and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8166 must be set with @code{setq} instead of in a customization buffer. For
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8167 help with regular expressions, see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8168 @ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8169 @ref{Regexps, , Syntax of Regular Expressions, emacs, The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8170 GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8171 @end ifnothtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8172 @ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8173 section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8174 @uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8175 Syntax of Regular Expressions} in @cite{The GNU Emacs Manual}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8176 @end ifhtml
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8177
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8178 The first variable has to do with pruning out garbage.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8179
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8180 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8181 @cindex @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8182 @cindex MH commands, @command{inc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8183 @cindex @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8184 @cindex MH commands, @command{scan}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8185 @item mh-scan-valid-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8186 This regular expression describes a valid scan line. This is used to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8187 eliminate error messages that are occasionally produced by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8188 @command{inc}@footnote{See the section
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8189 @uref{@value{MH-BOOK-HOME}/reapre.html, Reading Mail: inc show next
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8190 prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8191 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8192
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8193 Next, many variables control how the scan lines are parsed.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8194
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8195 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8196 @vindex mh-folder-body
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8197 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8198 @item mh-scan-body-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8199 This regular expression matches the message body fragment. Note that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8200 the default setting of @code{mh-folder-font-lock-keywords} expects
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8201 this expression to contain at least one parenthesized expression which
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8202 matches the body text as in the default of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8203 @code{"\\(<<\\([^\n]+\\)?\\)"}. If this regular expression is not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8204 correct, the body fragment will not be highlighted with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8205 @code{mh-folder-body}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8206 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8207 @vindex mh-folder-cur-msg-number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8208 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8209 @vindex mh-note-cur
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8210 @item mh-scan-cur-msg-number-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8211 This regular expression matches the current message. It must match
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8212 from the beginning of the line. Note that the default setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8213 @code{mh-folder-font-lock-keywords} expects this expression to contain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8214 at least one parenthesized expression which matches the message number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8215 as in the default of @w{@code{"^\\( *[0-9]+\\+\\).*"}}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8216 expression includes the leading space and current message marker
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8217 @samp{+} within the parenthesis since it looks better to highlight
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8218 these items as well. The highlighting is done with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8219 @code{mh-folder-cur-msg-number}. This regular expression should be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8220 correct as it is needed by non-fontification functions. See also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8221 @code{mh-note-cur}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8222 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8223 @vindex mh-folder-date
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8224 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8225 @vindex mh-scan-sent-to-me-sender-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8226 @item mh-scan-date-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8227 This regular expression matches a valid date. It must @strong{not} be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8228 anchored to the beginning or the end of the line. Note that the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8229 default setting of @code{mh-folder-font-lock-keywords} expects this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8230 expression to contain only one parenthesized expression which matches
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8231 the date field as in the default of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8232 @code{"\\([0-9][0-9]/[0-9][0-9]\\)"}. If this regular expression is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8233 not correct, the date will not be highlighted with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8234 @code{mh-folder-date}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8235 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8236 @vindex mh-folder-deleted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8237 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8238 @vindex mh-note-deleted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8239 @item mh-scan-deleted-msg-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8240 This regular expression matches deleted messages. It must match from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8241 the beginning of the line. Note that the default setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8242 @code{mh-folder-font-lock-keywords} expects this expression to contain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8243 at least one parenthesized expression which matches the message number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8244 as in the default of @code{"^\\( *[0-9]+\\)D"}. This expression
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8245 includes the leading space within the parenthesis since it looks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8246 better to highlight it as well. The highlighting is done with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8247 @code{mh-folder-deleted}. This regular expression should be correct as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8248 it is needed by non-fontification functions. See also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8249 @code{mh-note-deleted}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8250 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8251 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8252 @vindex mh-folder-msg-number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8253 @item mh-scan-good-msg-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8254 This regular expression matches ``good'' messages. It must match from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8255 the beginning of the line. Note that the default setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8256 @code{mh-folder-font-lock-keywords} expects this expression to contain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8257 at least one parenthesized expression which matches the message number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8258 as in the default of @w{@code{"^\\( *[0-9]+\\)[^D^0-9]"}}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8259 expression includes the leading space within the parenthesis since it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8260 looks better to highlight it as well. The highlighting is done with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8261 the face @code{mh-folder-msg-number}. This regular expression should
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8262 be correct as it is needed by non-fontification functions.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8263 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8264 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8265 @item mh-scan-msg-format-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8266 This regular expression finds the message number width in a scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8267 format. Note that the message number must be placed in a parenthesized
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8268 expression as in the default of @code{"%\\([0-9]*\\)(msg)"}. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8269 variable is only consulted if @code{mh-scan-format-file} is set to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8270 @samp{Use MH-E scan Format}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8271 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8272 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8273 @item mh-scan-msg-format-string
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8274 This is a format string for the width of the message number in a scan
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8275 format. Use @samp{0%d} for zero-filled message numbers. This variable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8276 is only consulted if @code{mh-scan-format-file} is set to @samp{Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8277 MH-E scan Format} (default: @code{"%d"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8278 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8279 @item mh-scan-msg-number-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8280 This regular expression extracts the message number. It must match
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8281 from the beginning of the line. Note that the message number must be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8282 placed in a parenthesized expression as in the default of @w{@code{"^
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8283 *\\([0-9]+\\)"}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8284 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8285 @item mh-scan-msg-overflow-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8286 This regular expression matches overflowed message numbers (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8287 @code{"^[?0-9][0-9]"}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8288 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8289 @item mh-scan-msg-search-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8290 This regular expression matches a particular message. It is a format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8291 string; use @samp{%d} to represent the location of the message number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8292 within the expression as in the default of @code{"^[^0-9]*%d[^0-9]"}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8293 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8294 @vindex mh-folder-address
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8295 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8296 @vindex mh-folder-to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8297 @item mh-scan-rcpt-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8298 This regular expression specifies the recipient in messages you sent.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8299 Note that the default setting of @code{mh-folder-font-lock-keywords}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8300 expects this expression to contain two parenthesized expressions. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8301 first is expected to match the @samp{To:} that the default scan format
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8302 file generates. The second is expected to match the recipient's name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8303 as in the default of @code{"\\(To:\\)\\(..............\\)"}. If this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8304 regular expression is not correct, the @samp{To:} string will not be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8305 highlighted with the face @code{mh-folder-to} and the recipient will not be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8306 highlighted with the face @code{mh-folder-address}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8307 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8308 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8309 @vindex mh-folder-refiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8310 @vindex mh-note-refiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8311 @item mh-scan-refiled-msg-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8312 This regular expression matches refiled messages. It must match from
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8313 the beginning of the line. Note that the default setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8314 @code{mh-folder-font-lock-keywords} expects this expression to contain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8315 at least one parenthesized expression which matches the message number
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8316 as in the default of @w{@code{"^\\( *[0-9]+\\)\\^"}}. This expression
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8317 includes the leading space within the parenthesis since it looks
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8318 better to highlight it as well. The highlighting is done with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8319 @code{mh-folder-refiled}. This regular expression should be correct as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8320 it is needed by non-fontification functions. See also
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8321 @code{mh-note-refiled}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8322 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8323 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8324 @vindex mh-folder-sent-to-me-sender
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8325 @vindex mh-mh-folder-sent-to-me-hint
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8326 @vindex mh-scan-format-nmh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8327 @item mh-scan-sent-to-me-sender-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8328 This regular expression matches messages sent to us. Note that the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8329 default setting of @code{mh-folder-font-lock-keywords} expects this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8330 expression to contain at least two parenthesized expressions. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8331 first should match the fontification hint (see
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8332 @code{mh-scan-format-nmh}) and the second should match the user name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8333 as in the default of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8334 @w{@code{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8335 If this regular expression is not correct, the notation hints will not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8336 be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8337 the sender will not be highlighted with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8338 @code{mh-folder-sent-to-me-sender}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8339 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8340 @vindex mh-folder-followup
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8341 @vindex mh-folder-font-lock-keywords
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8342 @vindex mh-folder-subject
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8343 @item mh-scan-subject-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8344 This regular expression matches the subject. It must match from the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8345 beginning of the line. Note that the default setting of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8346 @samp{mh-folder-font-lock-keywords} expects this expression to contain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8347 at least three parenthesized expressions. The first is expected to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8348 match the @samp{Re:} string, if any, and is highlighted with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8349 @code{mh-folder-followup}. The second matches an optional bracketed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8350 number after @samp{Re:}, such as in @samp{Re[2]:} (and is thus a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8351 sub-expression of the first expression). The third is expected to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8352 match the subject line itself which is highlighted with the face
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8353 @code{mh-folder-subject}. For example, the default is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8354 @w{@code{"^ *[0-9]+........[ ]*...................}}@*
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8355 @w{@code{\\([Rr][Ee]\\(\\[[0-9]+\\]\\)?:\\s-*\\)*\\([^<\n]*\\)"}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8356 This regular expression should be correct as it is needed by
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8357 non-fontification functions. Note that this example is broken up on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8358 two lines for readability, but is actually a single string.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8359 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8360
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8361 Finally, there are a slew of variables that control how MH-E annotates
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8362 the scan lines.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8363
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8364 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8365 @findex mh-set-cmd-note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8366 @vindex mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8367 @item mh-cmd-note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8368 Column for notations (default: 4). This variable should be set with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8369 the function @code{mh-set-cmd-note}. This variable may be updated
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8370 dynamically if @code{mh-adaptive-cmd-note-flag} is on. The following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8371 variables contain the notational characters. Note that columns in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8372 Emacs start with 0.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8373 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8374 @item mh-note-copied
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8375 Messages that have been copied are marked by this character (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8376 @code{?C}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8377 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8378 @vindex mh-scan-cur-msg-number-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8379 @item mh-note-cur
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8380 The current message (in MH, not in MH-E) is marked by this character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8381 (default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8382 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8383 @vindex mh-scan-deleted-msg-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8384 @item mh-note-deleted
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8385 Messages that have been deleted are marked by this character (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8386 @code{?D}). See also @code{mh-scan-deleted-msg-regexp}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8387 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8388 @item mh-note-dist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8389 Messages that have been redistributed are marked by this character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8390 (default: @code{?R}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8391 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8392 @item mh-note-forw
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8393 Messages that have been forwarded are marked by this character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8394 (default: @code{?F}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8395 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8396 @item mh-note-printed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8397 Messages that have been printed are marked by this character (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8398 @code{?P}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8399 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8400 @vindex mh-scan-refiled-msg-regexp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8401 @item mh-note-refiled
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8402 Messages that have been refiled are marked by this character (default:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8403 @code{?^}). See also @code{mh-scan-refiled-msg-regexp}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8404 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8405 @item mh-note-repl
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8406 Messages that have been replied to are marked by this character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8407 (default: @code{?-}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8408 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8409 @item mh-note-seq
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8410 Messages in a user-defined sequence are marked by this character
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8411 (default: @code{?%}). Messages in the @samp{search} sequence are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8412 marked by this character as well.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8413 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8414
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8415 For example, let's say I have the following in @file{scan.format}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8416 which displays the sender, the subject, and the message number. This
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8417 format places a @samp{+} after the message number for the current
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8418 message according to MH; it also uses that column for notations.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8419
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8420 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8421 %20(decode(friendly@{from@})) %50(decode@{subject@}) %4(msg)%<(cur)+%| %>
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8422 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8423
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8424 @vindex mh-adaptive-cmd-note-flag
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8425 @vindex mh-scan-format-file
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8426 @vindex mh-scan-format-file, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8427
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8428 The first thing you have to do is tell MH-E to use this file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8429 Customize @code{mh-scan-format-file} and set its value to @samp{Use
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8430 Default scan Format}. If you didn't get already turn off
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8431 @code{mh-adaptive-cmd-note-flag}, you'll need to do that first.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8432
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8433 Next, tell MH-E what a valid scan line looks like so that you can at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8434 least display the output of scan in your MH-Folder buffer.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8435
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8436 @vindex mh-scan-valid-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8437
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8438 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8439 (setq mh-scan-valid-regexp "[0-9]+[+D^ ]$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8440 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8441
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8442 Now, in order to get rid of the @samp{Cursor not pointing to message}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8443 message, you need to tell MH-E how to access the message number. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8444 should also see why MH-E requires that you include a message number in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8445 the first place.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8446
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8447 @vindex mh-scan-msg-number-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8448 @vindex mh-scan-msg-search-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8449
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8450 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8451 (setq mh-scan-msg-number-regexp "^.* \\([0-9]+\\)[+D^ ]$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8452 (setq mh-scan-msg-search-regexp " %d[+D^ ]$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8453 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8454
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8455 In order to get the next and previous commands working, add this.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8456
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8457 @vindex mh-scan-good-msg-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8458
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8459 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8460 (setq mh-scan-good-msg-regexp "^.* \\([0-9]+\\)[+D^ ]$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8461 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8462
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8463 Note that the current message isn't marked with a @samp{+} when moving
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8464 between the next and previous messages. Here is the code required to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8465 get this working.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8466
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8467 @vindex set-mh-cmd-note, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8468 @vindex mh-scan-cur-msg-number-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8469
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8470 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8471 (set-mh-cmd-note 76)
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8472 (setq mh-scan-cur-msg-number-regexp "^.* \\([0-9]+\\)\\+$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8473 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8474
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8475 Finally, add the following to delete and refile messages.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8476
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8477 @vindex mh-scan-deleted-msg-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8478 @vindex mh-scan-refiled-msg-regexp, example
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8479
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8480 @smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8481 (setq mh-scan-deleted-msg-regexp "^.* \\([0-9]+\\)D$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8482 (setq mh-scan-refiled-msg-regexp "^.* \\([0-9]+\\)\\^$")
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8483 @end smalllisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8484
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8485 This is just a bare minimum; it's best to adjust all of the regular
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8486 expressions to ensure that MH-E and highlighting perform well.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8487
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8488 @node Procmail, Odds and Ends, Scan Line Formats, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8489 @appendix Reading Mailing Lists Effectively
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8490
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8491 @cindex @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8492 @cindex @command{slocal}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8493 @cindex Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8494 @cindex MH commands, @command{slocal}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8495 @cindex Unix commands, @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8496 @cindex mailing lists, reading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8497
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8498 This appendix explains how to use @uref{http://www.procmail.org/,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8499 procmail} to file mail from mailing lists into folders which can then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8500 be read easily with MH-E@footnote{The MH equivalent, @command{slocal},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8501 can be used as well, but procmail is more flexible and more packages
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8502 exist for procmail than for slocal.}. Some mailing lists have such
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8503 high traffic that Gnus must be used and I discuss how to use Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8504 side-by-side with MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8505
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8506 @cindex @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8507 @cindex files, @file{.procmailrc}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8508
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8509 First, I'll describe how to put mail from your mailing lists directly
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8510 into an MH folder using @command{procmail}. First, add the following
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8511 to @file{~/.procmailrc}. While the logging variables aren't strictly
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8512 necessary, they are extremely useful.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8513
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8514 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8515 [1] # Update PATH so procmail can find myrcvstore, rcvstore and mhparam.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8516 [2] PATH=$PATH:/usr/lib/mh:/usr/bin/mh:$HOME/bin
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8517 [3]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8518 [4] # Point LOGFILE at the actual log file.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8519 [5] LOGFILE=$HOME/.procmail.log
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8520 [6]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8521 [7] # This setting provides just the right amount of information.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8522 [8] LOGABSTRACT=all
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8523 [9]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8524 [10] # Uncomment the following line to see how your patterns match.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8525 [11] #VERBOSE=yes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8526 [12]
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8527 [13] # Place mail sent to any MH-E mailing list in +mh-e.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8528 [14] :0 w: mh-e$LOCKEXT
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8529 [15] * ^TO.*mh-e-.*@.*sourceforge.net
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8530 [16] | myrcvstore -create +mh-e
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8531 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8532
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8533 @cindex @command{rcvstore}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8534 @cindex MH commands, @command{rcvstore}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8535
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8536 Line 14 creates a lock file in your mail directory based upon the name
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8537 of the folder. This is done because @command{rcvstore} does not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8538 perform locking. While this lock file will prevent @command{procmail}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8539 from writing to a folder concurrently, there is a slight chance that
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8540 you might lose a message if you're performing operations on a folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8541 at the same time @command{rcvstore} is placing a message there. You
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8542 have been warned. Now that that disclaimer is out of the way, note
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8543 that I've been using this set-up for over a decade and haven't lost
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8544 anything to my knowledge@footnote{See
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8545 @uref{https://savannah.nongnu.org/bugs/?func=detailbug&bug_id=4361&group_id=2166,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8546 Savannah issue #4361} to see if @command{rcvstore} locking is still an
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8547 issue.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8548
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8549 @cindex @samp{Unseen-Sequence:} MH profile component
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8550 @cindex MH profile component, @samp{Unseen-Sequence:}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8551
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8552 Line 16 uses the following script, @code{myrcvstore}, to massage the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8553 message as described in the comment and file the message in the given
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8554 folder@footnote{The @samp{-create} argument wasn't always the default
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8555 to @command{rcvstore}.}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8556
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8557 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8558 #! /bin/sh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8559
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8560 # Accepts a message on standard input and passes it through rcvstore
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8561 # after first passing it through any filters. All arguments are passed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8562 # on to rcvstore.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8563
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8564 # Force the "From user date" to become part of header. One reason this
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8565 # is done is because the presence of the From field confuses dist so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8566 # that dist adds a new header, rather than using the existing header.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8567 # Note that this should not be done for any message that goes into a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8568 # Gnus incoming file (Gnus will thrown an error) nor should it be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8569 # applied to any message that goes to the system mailbox because the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8570 # entire mailbox will be incorporated as a single message.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8571 formail -c -z -R 'From ' X-Envelope-From: |
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8572 rcvstore $@@
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8573 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8574
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8575 If your version of @command{rcvstore} doesn't add messages to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8576 @samp{unseen} sequence by default, add the following line to your MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8577 profile:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8578
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8579 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8580 Unseen-Sequence: unseen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8581 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8582
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8583 Now view your new messages with the speedbar (@pxref{Speedbar}) or with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8584 @kbd{F n} (@code{mh-index-new-messages}). @xref{Folders}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8585
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8586 If you're on a mailing list that is so voluminous that it is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8587 impossible to read every message, it usually better to read the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8588 mailing list like a newsgroup in a news reader. Emacs has a built-in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8589 newsreader called Gnus. The remainder of this appendix talks about how
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8590 to use Gnus with an MH message store. The version of Gnus that was
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8591 used to prepare this manual was 5.10. Versions 5.8 through 5.10 should
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8592 work but versions prior to 5.8 use different options.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8593
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8594 This table contains a list of Gnus options that you will have to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8595 modify. Note that for them to become accessible, you'll have to load
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8596 @file{nnml.el} first. This can be done with @kbd{M-x load-library
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8597 @key{RET} nnml @key{RET}}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8598
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8599 @vtable @code
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8600 @item gnus-secondary-select-methods
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8601 Select the @samp{nnml} value. This select method uses directories for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8602 folders and individual files for messages, just like MH. You do not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8603 have to set an address.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8604 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8605 @item mail-sources
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8606 Select the @samp{Several files in a directory} value, check the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8607 @samp{Path} box and enter @file{~/Mail} to tell Gnus where to find
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8608 your mail.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8609 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8610 @vindex mail-user-agent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8611 @item message-mail-user-agent
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8612 In order to send mail within Gnus using MH-E, set this option to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8613 @samp{mail-user-agent} and set the @code{mail-user-agent} option to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8614 @samp{Emacs interface to MH}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8615 @c -------------------------
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8616 @item nnmail-keep-last-article
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8617 Since Gnus keeps track of which messages you have read, it would be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8618 bad if Gnus expired the last message, for example, message 100, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8619 @command{rcvstore} gave the next new message number 1. Gnus would then
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8620 ignore it since it thinks that you've read messages 1-100. Turning on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8621 this option ensures that the last message is never removed thereby
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8622 eliminating this problem.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8623 @end vtable
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8624
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8625 Next add the following to @file{~/.procmailrc}. If you don't subscribe
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8626 to the GnuCash mailing list, substitute one to which you are
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8627 subscribed.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8628
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8629 @smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8630 PATH=$PATH:/usr/bin/mh
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8631 MAILDIR=$HOME/`mhparam Path`
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8632 # Place mail sent to the GnuCash mailing list in gnucash.spool, where
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8633 # Gnus will pick it up.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8634 :0:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8635 * ^TO.*gnucash.*@.*gnucash.org
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8636 gnucash.spool
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8637 @end smallexample
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8638
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8639 Wait for some messages to appear in @file{gnucash.spool} and run Gnus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8640 with @kbd{M-x gnus @key{RET}}. To view the folder created in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8641 example above, you would tell Gnus about it the first time only with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8642 @kbd{G m gnucash @key{RET} nnml @key{RET}}. In MH-E, this folder is
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8643 known as @samp{+gnucash}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8644
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8645 @node Odds and Ends, History, Procmail, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8646 @appendix Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8647
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8648 This appendix covers a few topics that don't fit elsewhere. Here I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8649 tell you how to report bugs and how to get on the MH-E mailing lists.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8650 I also point out some additional sources of information.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8651
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8652 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8653 * Bug Reports::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8654 * Mailing Lists::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8655 * MH FAQ and Support::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8656 * Getting MH-E::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8657 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8658
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8659 @node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8660 @appendixsec Bug Reports
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8661
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8662 @cindex bugs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8663 @cindex SourceForge
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8664 @kindex M-x mh-version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8665
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8666 Bug reports should be filed at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8667 @uref{https://sourceforge.net/tracker/?group_id=13357&atid=113357,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8668 SourceForge}. You need to be a SourceForge user to submit bug reports,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8669 but this is easy enough to do that it shouldn't be a restriction for
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8670 you. Please include the output of @kbd{M-x mh-version}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8671 (@pxref{Miscellaneous}) in any bug report you send unless you're 110%
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8672 positive we won't ask for it.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8673
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8674 @node Mailing Lists, MH FAQ and Support, Bug Reports, Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8675 @appendixsec MH-E Mailing Lists
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8676
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8677 @cindex SourceForge
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8678 @cindex mailing lists
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8679
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8680 There are several mailing lists for MH-E. They are @i{mh-e-users at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8681 lists.sourceforge.net}, @i{mh-e-announce at lists.sourceforge.net},
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8682 and @i{mh-e-devel at lists.sourceforge.net}. You can subscribe or view
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8683 the archives at @uref{https://sourceforge.net/mail/?group_id=13357,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8684 SourceForge}. Do not report bugs on these lists; please submit them
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8685 via SourceForge (@pxref{Bug Reports}).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8686
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8687 @node MH FAQ and Support, Getting MH-E, Mailing Lists, Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8688 @appendixsec MH FAQ and Support
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8689
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8690 @cindex FAQ
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8691 @cindex MH FAQ
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8692
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8693 The article @uref{http://www.newt.com/faq/mh.html, @cite{MH Frequently
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8694 Asked Questions (FAQ) with Answers}} appears monthly in the newsgroup
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8695 @samp{comp.mail.mh}. While very little is there that deals with MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8696 specifically, there is an incredible wealth of material about MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8697 itself which you will find useful.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8698
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8699 @cindex support
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8700
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8701 You can find FAQs on MH-E at the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8702 @uref{https://sourceforge.net/tracker/?group_id=13357&atid=213357,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8703 Support Requests} page on SourceForge. If you don't find the answer to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8704 your question, file a support request and your question will become a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8705 new FAQ!
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8706
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8707 @node Getting MH-E, , MH FAQ and Support, Odds and Ends
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8708 @appendixsec Getting MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8709
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8710 @cindex MH-E, obtaining
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8711 @cindex getting MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8712 @cindex obtaining MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8713
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8714 Because MH-E is undergoing a phase of sustained growth, the version of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8715 MH-E in your Emacs is likely to be out of date although it is most
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8716 likely to be more up to date than the copy that comes with the MH
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8717 distribution in @file{miscellany/mh-e}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8718
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8719 @cindex change log
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8720 @cindex release notes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8721
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8722 New MH-E releases are always available for downloading at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8723 @uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8724 SourceForge} before they appear in an Emacs release. You can read the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8725 release notes on that page to determine if the given release of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8726 is already installed in your version of Emacs. You can also read the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8727 change log to see if you are interested in what the given release of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8728 MH-E has to offer (although we have no doubt that you will be
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8729 extremely interested in all new releases).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8730
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8731 @cindex Debian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8732
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8733 If you use Debian, you can install the Debian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8734 @uref{http://packages.debian.org/unstable/mail/mh-e, mh-e package}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8735 instead.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8736
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8737 @cindex files, @samp{MH-E-NEWS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8738 @cindex files, @samp{README}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8739 @cindex news
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8740 @cindex @samp{MH-E-NEWS}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8741 @cindex @samp{README}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8742 @kindex M-x mh-version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8743
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8744 After you download and extract the MH-E tarball, read the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8745 @file{README} file and @file{MH-E-NEWS}. These correspond to the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8746 release notes and change log mentioned above. The file @file{README}
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8747 contains instructions on installing MH-E. If you're already running
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8748 Emacs, please quit that session and start again to load in the new
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8749 MH-E. Check that you're running the new version with the command
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8750 @kbd{M-x mh-version}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8751
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8752 @cindex contributed software
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8753 @cindex manual
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8754 @cindex documentation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8755
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8756 In addition to the mh-e package, the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8757 @uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8758 SourceForge} site also contains doc and contrib packages. The former
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8759 is the latest release of this manual, and the latter contains a few
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8760 contributed packages you might find useful.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8761
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8762 @node History, GFDL, Odds and Ends, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8763 @appendix History of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8764
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8765 @cindex Bill Wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8766 @cindex Brian Reid
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8767 @cindex Gildea, Stephen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8768 @cindex Jim Larus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8769 @cindex Larus, Jim
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8770 @cindex MH-E, versions
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8771 @cindex Reid, Brian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8772 @cindex SourceForge
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8773 @cindex Stephen Gildea
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8774 @cindex Wohler, Bill
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8775 @cindex history of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8776 @cindex versions of MH-E
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8777
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8778 MH-E was originally written by Brian Reid in 1983 and has changed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8779 hands several times since then. Jim Larus wanted to do something
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8780 similar for GNU Emacs, and ended up completely rewriting it that same
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8781 year. In 1989, Stephen Gildea picked it up and added many
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8782 improvements. Bill Wohler then took over in 2000 and moved its
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8783 development to @uref{http://sourceforge.net/, SourceForge} where it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8784 lives today.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8785
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8786 @menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8787 * From Brian Reid::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8788 * From Jim Larus::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8789 * From Stephen Gildea::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8790 * From Bill Wohler::
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8791 @end menu
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8792
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8793 @node From Brian Reid, From Jim Larus, History, History
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8794 @appendixsec From Brian Reid
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8795
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8796 @cindex Brian Reid
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8797 @cindex Reid, Brian
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8798
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8799 One day in 1983 I got the flu and had to stay home from work for three
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8800 days with nothing to do. I used that time to write MHE@. The
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8801 fundamental idea behind MHE was that it was a ``puppeteer'' driving
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8802 the MH programs underneath it. MH had a model that the editor was
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8803 supposed to run as a sub-process of the mailer, which seemed to me at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8804 the time to be the tail wagging the dog. So I turned it around and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8805 made the editor drive the MH programs. I made sure that the UCI people
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8806 (who were maintaining MH at the time) took in my changes and made them
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8807 stick.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8808
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8809 Today, I still use my own version of MHE because I don't at all like
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8810 the way that GNU MH-E works and I've never gotten to be good enough at
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8811 hacking Emacs Lisp to make GNU MH-E do what I want. The Gosling-emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8812 version of MHE and the GNU Emacs version of MH-E have almost nothing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8813 in common except similar names. They work differently, have different
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8814 conceptual models, and have different key bindings@footnote{After
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8815 reading this article, I questioned Brian about his version of MHE, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8816 received some great ideas for improving MH-E such as a dired-like
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8817 method of selecting folders; and removing the prompting when sending
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8818 mail, filling in the blanks in the draft buffer instead. I passed them
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8819 on to Stephen Gildea, the current maintainer, and he was excited about
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8820 the ideas as well. Perhaps one day, MH-E will again resemble MHE
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8821 (draft form editing was introduced in version 7.4).}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8822
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8823 Brian Reid, June 1994
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8824
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8825 @node From Jim Larus, From Stephen Gildea, From Brian Reid, History
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8826 @appendixsec From Jim Larus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8827
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8828 @cindex Jim Larus
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8829 @cindex Larus, Jim
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8830
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8831 Brian Reid, while at CMU or shortly after going to Stanford wrote a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8832 mail reading program called MHE for Gosling Emacs. It had much the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8833 same structure as MH-E (i.e., invoked MH programs), though it was
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8834 simpler and the commands were slightly different. Unfortunately, I no
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8835 longer have a copy so the differences are lost in the mists of time.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8836
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8837 In '82-83, I was working at BBN and wrote a lot of mlisp code in
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8838 Gosling Emacs to make it look more like Tennex Emacs. One of the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8839 packages that I picked up and improved was Reid's mail system. In '83,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8840 I went back to Berkeley. About that time, Stallman's first version of
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8841 GNU Emacs came out and people started to move to it from Gosling Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8842 (as I recall, the transition took a year or two). I decided to port
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8843 Reid's MHE and used the mlisp to Emacs Lisp translator that came with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8844 GNU Emacs. It did a lousy job and the resulting code didn't work, so I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8845 bit the bullet and rewrote the code by hand (it was a lot smaller and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8846 simpler then, so it took only a day or two).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8847
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8848 Soon after that, MH-E became part of the standard Emacs distribution
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8849 and suggestions kept dribbling in for improvements. MH-E soon reached
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8850 sufficient functionality to keep me happy, but I kept on improving it
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8851 because I was a graduate student with plenty of time on my hands and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8852 it was more fun than my dissertation. In retrospect, the one thing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8853 that I regret is not writing any documentation, which seriously
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8854 limited the use and appeal of the package.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8855
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8856 @cindex @command{xmh}, in MH-E history
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8857
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8858 In '89, I came to Wisconsin as a professor and decided not to work on
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8859 MH-E. It was stable, except for minor bugs, and had enough
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8860 functionality, so I let it be for a few years. Stephen Gildea of BBN
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8861 began to pester me about the bugs, but I ignored them. In 1990, he
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8862 went off to the X Consortium, said good bye, and said that he would
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8863 now be using @command{xmh}. A few months later, he came back and said
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8864 that he couldn't stand @command{xmh} and could I put a few more bug fixes
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8865 into MH-E. At that point, I had no interest in fixing MH-E, so I gave
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8866 the responsibility of maintenance to him and he has done a fine job
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8867 since then.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8868
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8869 Jim Larus, June 1994
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8870
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8871 @node From Stephen Gildea, From Bill Wohler, From Jim Larus, History
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8872 @appendixsec From Stephen Gildea
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8873
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8874 @cindex Gildea, Stephen
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8875 @cindex Stephen Gildea
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8876
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8877 In 1987 I went to work for Bolt Beranek and Newman, as Jim had before
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8878 me. In my previous job, I had been using RMAIL, but as my folders tend
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8879 to run large, I was frustrated with the speed of RMAIL@. However, I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8880 stuck with it because I wanted the GNU Emacs interface. I am very
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8881 familiar and comfortable with the Emacs interface (with just a few
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8882 modifications of my own) and dislike having to use applications with
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8883 embedded editors; they never live up to Emacs.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8884
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8885 MH is the mail reader of choice at BBN, so I converted to it. Since I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8886 didn't want to give up using an Emacs interface, I started using MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8887 As is my wont, I started hacking on it almost immediately. I first
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8888 used version 3.4m. One of the first features I added was to treat the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8889 folder buffer as a file-visiting buffer: you could lock it, save it,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8890 and be warned of unsaved changes when killing it. I also worked to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8891 bring its functionality a little closer to RMAIL@. Jim Larus was very
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8892 cooperative about merging in my changes, and my efforts first appeared
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8893 in version 3.6, distributed with Emacs 18.52 in 1988. Next I decided
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8894 MH-E was too slow and optimized it a lot. Version, 3.7, distributed
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8895 with Emacs 18.56 in 1990, was noticeably faster.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8896
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8897 When I moved to the X Consortium I became the first person there to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8898 not use xmh. (There is now one other engineer there using MH-E.) About
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8899 this point I took over maintenance of MH-E from Jim and was finally
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8900 able to add some features Jim hadn't accepted, such as the backward
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8901 searching undo. My first release was 3.8 (Emacs 18.58) in 1992.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8902
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8903 Now, in 1994, we see a flurry of releases, with both 4.0 and 5.0.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8904 Version 4.0 added many new features, including background folder
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8905 collection and support for composing @sc{mime} messages. (Reading
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8906 @sc{mime} messages remains to be done, alas.) While writing this book,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8907 Bill Wohler gave MH-E its closest examination ever, uncovering bugs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8908 and inconsistencies that required a new major version to fix, and so
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8909 version 5 was released.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8910
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8911 Stephen Gildea, June 1994
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8912
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8913 @node From Bill Wohler, , From Stephen Gildea, History
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8914 @appendixsec From Bill Wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8915
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8916 @cindex Wohler, Bill
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8917 @cindex Bill Wohler
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8918
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8919 The preface originally included the following text which I use to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8920 begin my story:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8921
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8922 @quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8923 But it's important to note a brief history of MH-E.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8924
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8925 @w{Version 3} was prevalent through the @w{Emacs 18} and early
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8926 @w{Emacs 19} years. Then @w{Version 4} came out (@w{Emacs 19.23}),
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8927 which introduced several new and changed commands. Next, @w{Version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8928 5.0} was released, which fixed some bugs and incompatibilities, and
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8929 was incorporated into @w{Emacs 19.29}.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8930 @end quotation
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8931
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8932 After a long break, Stephen handed the reins over to me in 2000. I
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8933 moved the project to a new site called SourceForge and organized a
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8934 great team of developers. Our first release in late 2001 was version
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8935 6. It appeared around the time of Emacs 21.2 and had menus and tool
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8936 bar buttons.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8937
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8938 Then, indexed searches, improved MIME handling, a speedbar, multiple
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8939 identities, alias completion, an index view of unseen messages, spam
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8940 software support, Face and X-Image-URL header field support, Fcc
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8941 completion, arbitrary range handling, and draft form editing were
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8942 introduced in the version 7 series around the time of Emacs 21.4
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8943 (2004). Still, Emacs itself contained version 5 of MH-E released back
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8944 in 1994.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8945
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8946 Version 8 development was mostly driven by the rewrite of the manual.
97414
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8947 It also brought GNU mailutils MH support, S/MIME support, picon
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8948 support, and an improved interface for hiding header fields. The CVS
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8949 repository was migrated from SourceForge to Savannah (only for those
d38d8feaaa82 (Getting Started): Rename variant mu-mh to gnu-mh and be explicit
Bill Wohler <wohler@newt.com>
parents: 97192
diff changeset
8950 files that were already part of Emacs) and the software was completely
97555
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8951 reorganized to push back two decades of entropy. Version 8 appeared in
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8952 Emacs 22.1 in 2006.
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8953
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8954 Development was then quiet for a couple of years. Emacs 23.1, which is
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8955 due out in 2009, will contain version 8.1. This version includes a few
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8956 new features and several bug fixes.
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8957
12c8fcc4c171 Update for release 8.1.
Bill Wohler <wohler@newt.com>
parents: 97414
diff changeset
8958 Bill Wohler, August 2008
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8959
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8960 @node GFDL, GPL, History, Top
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8961 @appendix GNU Free Documentation License
95925
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
8962 @include doclicense.texi
6e1d885ba36a Remove option of licensing under GPL.
Glenn Morris <rgm@gnu.org>
parents: 95032
diff changeset
8963
98287
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8964 @node GPL, Key Index, GFDL, Top
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8965 @appendix GNU General Public License
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8966 @include gpl.texi
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8967
ddacedfb951c Retain dual license as agreed to by the FSF.
Bill Wohler <wohler@newt.com>
parents: 97555
diff changeset
8968 @node Key Index, Command Index, GPL, Top
84306
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8969 @unnumbered Key (Character) Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8970 @printindex ky
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8971
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8972 @node Command Index, Option Index, Key Index, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8973 @unnumbered Command Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8974 @printindex fn
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8975
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8976 @node Option Index, Concept Index, Command Index, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8977 @unnumbered Option (Variable) Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8978 @printindex vr
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8979
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8980 @node Concept Index, , Option Index, Top
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8981 @unnumbered Concept Index
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8982 @printindex cp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8983
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8984 @bye
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8985
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8986 @c Ispell Helpers
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8987 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8988 @c The following are words that ispell should ignore that would not
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8989 @c normally be in a dictionary (global or personal). Be careful not to
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8990 @c include words here that could potentially be typos of other words
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8991 @c (such as url, elisp, or MHE).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8992 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8993 @c LocalWords: CTRL ESC SPC f's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8994 @c LocalWords: addr Aliasfile alist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8995 @c LocalWords: Baushke Bcc BBN Beranek bogofilter bogofilter's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8996 @c LocalWords: cmd CMU contrib cron
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8997 @c LocalWords: DesBrisay Dcc devel dir dired docstring filll forw
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8998 @c LocalWords: GECOS Gildea Gildea's Ginnean GnuCash goto gnuserv htm
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8999 @c LocalWords: ImageMagick inbox ispell keychain
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9000 @c LocalWords: Larus licensor LocalWords lookup lpr
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9001 @c LocalWords: makeinfo mairix mbox mh mhbuild mhl mhpath mlisp
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9002 @c LocalWords: MML msg multipart
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9003 @c LocalWords: Namazu NIS nenscript nnml num
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9004 @c LocalWords: packmbox passphrase pathname prev procmail prog repl
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9005 @c LocalWords: slocal sortm SpamAssassin spammers SpamProbe SpamProbe's
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9006 @c LocalWords: sublicense supercite speedbar
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9007 @c LocalWords: Tennex texi texinfo Thelen thelenm
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9008 @c LocalWords: UCI undeleted whatnow wohler xmh ypcat
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9009 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9010 @c See http://www.oreilly.com/oreilly/author/stylesheet.html.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9011 @c See http://en.wikipedia.org/.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9012 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9013 @c Note the lowercase mh which is needed to avoid hits in the
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9014 @c functions and variables. Occasionally, check for accidental
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9015 @c inclusion of mh in text by uncommenting the following and executing
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9016 @c it with C-x C-e. You want to see "Search failed"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9017 @c (let ((case-fold-search nil))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9018 @c (goto-char (point-min))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9019 @c (search-forward-regexp "^mh\\( \\|$\\)"))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9020 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9021 @c An extremely useful setting for texinfo-mode-hook is:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9022 @c (add-to-list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9023 @c 'ispell-skip-region-alist
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9024 @c (list
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9025 @c (concat "\\(@\\(small\\)?\\(example\\|lisp\\)"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9026 @c "\\(@\\([irw]\\|code\\|var\\){[^}]+}\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9027 @c "@[@{}.]\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9028 @c "[^@]\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9029 @c "@\\(end \\)?group\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9030 @c "@\\(end \\)?cartouche\\)+"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9031 @c "@end \\(small\\)?\\(example\\|lisp\\)\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9032 @c "@\\(code\\|command\\|file\\|kbd\\|sc\\){[^}]+}\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9033 @c "^@end [a-z]+$\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9034 @c "^@\\([fv]\\|print\\)index .*$\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9035 @c "@uref{[^,]+,\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9036 @c "@[a-z]+\\|"
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9037 @c "/[a-z.]+[/}]\\)")))))
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9038 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9039 @c Cross References
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9040 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9041 @c See existing cross-references to the Emacs manual and the Emacs
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9042 @c Lisp manual (search for ``GNU Emacs Manual'' and ``GNU
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9043 @c Emacs Lisp Reference Manual'' respectively).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9044
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9045 @c @ftable Sorting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9046 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9047 @c As per index (sort of): Punctuation, keyboard characters (such as
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9048 @c RET and BS) upper and lowercase mixed (lower comes before
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9049 @c uppercase), control characters go with uppercase C, meta characters
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9050 @c go with uppercase M.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9051 @c In some cases, the sort isn't strictly ASCII.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9052 @c For example, SPC (mh-page-msg) reads better before BS
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9053 @c (mh-previous-page) and . (mh-show) is better before ,
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9054 @c (mh-header-display).
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9055
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9056 @c @vtable Sorting
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9057 @c
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9058 @c Alphabetical, pull hooks into their own table.
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9059
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9060 @c Local Variables:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9061 @c sentence-end-double-space: nil
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9062 @c End:
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9063
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9064 @ignore
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9065 arch-tag: b778477d-1a10-4a99-84de-f877a2ea6bef
8e4bd303e91e Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9066 @end ignore