aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBill Wohler2006-03-12 01:06:59 +0000
committerBill Wohler2006-03-12 01:06:59 +0000
commit83c7a27bc0184b0eb63eb79b5a4edb40c74fd7a5 (patch)
tree202c6812dbd424e780c10074b5a70823e2e3de49
parentf0c947b5a090d8a6af3077a91a26a3a98787925d (diff)
downloademacs-83c7a27bc0184b0eb63eb79b5a4edb40c74fd7a5.tar.gz
emacs-83c7a27bc0184b0eb63eb79b5a4edb40c74fd7a5.zip
(Preface, More About MH-E, Options, HTML, Folders)
(Composing, Scan Line Formats): Fix @refs. (Getting Started): Define MH profile and MH profile components. (Incorporating Mail, Reading Mail, Viewing, Printing) (Sending Mail, Forwarding, Editing Drafts, Inserting Letter) (Signature, Aliases, Scan Line Formats): Use @code instead of @samp for string constants. (Tool Bar): Remove spurious quote. (Junk): Use ``...'' instead of "...".
-rw-r--r--man/ChangeLog12
-rw-r--r--man/mh-e.texi215
2 files changed, 127 insertions, 100 deletions
diff --git a/man/ChangeLog b/man/ChangeLog
index 385a8c81ea0..f06eaa09360 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,15 @@
12006-03-11 Bill Wohler <wohler@newt.com>
2
3 * mh-e.texi (Preface, More About MH-E, Options, HTML, Folders)
4 (Composing, Scan Line Formats): Fix @refs.
5 (Getting Started): Define MH profile and MH profile components.
6 (Incorporating Mail, Reading Mail, Viewing, Printing)
7 (Sending Mail, Forwarding, Editing Drafts, Inserting Letter)
8 (Signature, Aliases, Scan Line Formats): Use @code instead of @samp
9 for string constants.
10 (Tool Bar): Remove spurious quote.
11 (Junk): Use ``...'' instead of "...".
12
12006-03-11 Luc Teirlinck <teirllm@auburn.edu> 132006-03-11 Luc Teirlinck <teirllm@auburn.edu>
2 14
3 * search.texi (Regexps): Use @samp for regexp that is not in Lisp 15 * search.texi (Regexps): Use @samp for regexp that is not in Lisp
diff --git a/man/mh-e.texi b/man/mh-e.texi
index df0595a5c70..7c5b6767f2a 100644
--- a/man/mh-e.texi
+++ b/man/mh-e.texi
@@ -8,11 +8,11 @@
8@c %**end of header 8@c %**end of header
9 9
10@c Version of the software and manual. 10@c Version of the software and manual.
11@set VERSION 7.93 11@set VERSION 7.93+cvs
12@c EDITION of the manual. It is either empty for the first edition or 12@c EDITION of the manual. It is either empty for the first edition or
13@c has the form ", nth Edition" (without the quotes). 13@c has the form ", nth Edition" (without the quotes).
14@set EDITION 14@set EDITION
15@set UPDATED 2006-03-05 15@set UPDATED 2006-03-11
16@set UPDATE-MONTH March, 2006 16@set UPDATE-MONTH March, 2006
17 17
18@c Other variables. 18@c Other variables.
@@ -218,8 +218,8 @@ in GNU Emacs 21, as well as XEmacs 21 (except for versions
21821.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, 21821.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher,
219all versions of nmh, and GNU mailutils 0.4 and higher.}, so you 219all versions of nmh, and GNU mailutils 0.4 and higher.}, so you
220shouldn't have to do anything special to use it. This manual covers 220shouldn't have to do anything special to use it. This manual covers
221MH-E version @value{VERSION}. @ref{Getting Started} will help you 221MH-E version @value{VERSION}. To help you decide which version you
222decide which version you have. 222have, see @ref{Getting Started}.
223 223
224If you don't already use GNU Emacs but want to learn more, you can 224If you don't already use GNU Emacs but want to learn more, you can
225read an online tutorial by starting GNU Emacs and typing @kbd{C-h t} 225read an online tutorial by starting GNU Emacs and typing @kbd{C-h t}
@@ -554,6 +554,17 @@ environment@footnote{See the section
554If you don't, you'll be greeted with the error message: @samp{Install 554If you don't, you'll be greeted with the error message: @samp{Install
555MH and run install-mh before running MH-E}. 555MH and run install-mh before running MH-E}.
556 556
557@cindex @samp{Path:} MH profile component
558@cindex MH profile
559@cindex MH profile component
560@cindex MH profile component, @samp{Path:}
561
562Your MH environment includes your @dfn{MH profile} which is found in
563the file @file{~/.mh_profile}. This file contains a number of @dfn{MH
564profile components}. For example, the @samp{Path:} MH profile
565component contains the path to your mail directory, which is
566@file{~/Mail} by default.
567
557@cindex @samp{Draft-Folder:} MH profile component 568@cindex @samp{Draft-Folder:} MH profile component
558@cindex @samp{Path:} MH profile component 569@cindex @samp{Path:} MH profile component
559@cindex @samp{Previous-Sequence:} MH profile component 570@cindex @samp{Previous-Sequence:} MH profile component
@@ -886,57 +897,58 @@ to find out how you can:
886 897
887@itemize @bullet 898@itemize @bullet
888@item 899@item
889Print your messages (@ref{Printing}). 900Print your messages (@pxref{Printing}).
890@c ------------------------- 901@c -------------------------
891@item 902@item
892Edit messages and include your signature (@ref{Editing Drafts}). 903Edit messages and include your signature (@pxref{Editing Drafts}).
893@c ------------------------- 904@c -------------------------
894@item 905@item
895Forward messages (@ref{Forwarding}). 906Forward messages (@pxref{Forwarding}).
896@c ------------------------- 907@c -------------------------
897@item 908@item
898Read digests (@ref{Digests}). 909Read digests (@pxref{Digests}).
899@c ------------------------- 910@c -------------------------
900@item 911@item
901Edit bounced messages (@ref{Editing Again}). 912Edit bounced messages (@pxref{Editing Again}).
902@c ------------------------- 913@c -------------------------
903@item 914@item
904Send multimedia messages (@ref{Adding Attachments}). 915Send multimedia messages (@pxref{Adding Attachments}).
905@c ------------------------- 916@c -------------------------
906@item 917@item
907Read HTML messages (@ref{HTML}). 918Read HTML messages (@pxref{HTML}).
908@c ------------------------- 919@c -------------------------
909@item 920@item
910Use @ref{Aliases} and @ref{Identities}. 921Use aliases and identities (see @ref{Aliases}, @pxref{Identities}).
911@c ------------------------- 922@c -------------------------
912@item 923@item
913Create different views of your mail (@ref{Threading} and @ref{Limits}). 924Create different views of your mail (see @ref{Threading}, @pxref{Limits}).
914@c ------------------------- 925@c -------------------------
915@item 926@item
916Deal with junk mail (@ref{Junk}). 927Deal with junk mail (@pxref{Junk}).
917@c ------------------------- 928@c -------------------------
918@item 929@item
919Handle signed and encrypted messages (@ref{Reading PGP} and 930Handle signed and encrypted messages (see @ref{Reading PGP},
920@ref{Sending PGP}). 931@pxref{Sending PGP}).
921@c ------------------------- 932@c -------------------------
922@item 933@item
923Process mail that was sent with @command{shar} or @command{uuencode} 934Process mail that was sent with @command{shar} or @command{uuencode}
924(@ref{Files and Pipes}). 935(@pxref{Files and Pipes}).
925@c ------------------------- 936@c -------------------------
926@item 937@item
927Use sequences conveniently (@ref{Sequences}). 938Use sequences conveniently (@pxref{Sequences}).
928@c ------------------------- 939@c -------------------------
929@item 940@item
930Use the @ref{Speedbar}, @ref{Tool Bar}, and @ref{Menu Bar}. 941Use the speedbar, tool bar, and menu bar (see @ref{Speedbar}, see @ref{Tool
942Bar}, @pxref{Menu Bar}).
931@c ------------------------- 943@c -------------------------
932@item 944@item
933Show header fields in different fonts (@ref{Reading Mail}). 945Show header fields in different fonts (@pxref{Reading Mail}).
934@c ------------------------- 946@c -------------------------
935@item 947@item
936Find previously refiled messages (@ref{Searching}). 948Find previously refiled messages (@pxref{Searching}).
937@c ------------------------- 949@c -------------------------
938@item 950@item
939Place messages in a file (@ref{Files and Pipes}). 951Place messages in a file (@pxref{Files and Pipes}).
940@end itemize 952@end itemize
941 953
942Remember that you can also use MH commands when you're not running 954Remember that you can also use MH commands when you're not running
@@ -1065,7 +1077,8 @@ mh-lpr-command-format @key{RET}}. In the buffer that appears, modify
1065the string to the right of the variable. For example, you may change 1077the string to the right of the variable. For example, you may change
1066the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then 1078the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then
1067use the @samp{State} combo box and select @samp{Save for Future 1079use the @samp{State} combo box and select @samp{Save for Future
1068Sessions}. @ref{Printing} talks more about this option. 1080Sessions}. To read more about @code{mh-lpr-command-format}, see
1081@ref{Printing}.
1069 1082
1070@vindex mh-bury-show-buffer-flag, example 1083@vindex mh-bury-show-buffer-flag, example
1071 1084
@@ -1084,9 +1097,9 @@ stack.
1084 1097
1085The text usually says to turn on an option by setting it to a 1098The text usually says to turn on an option by setting it to a
1086@emph{non-@code{nil}} value, because sometimes values other than 1099@emph{non-@code{nil}} value, because sometimes values other than
1087@samp{on} are meaningful (for example, see @code{mh-mhl-format-file}, 1100@samp{on} are meaningful. An example of this is the variable
1088described in @ref{Viewing}). Other options, such as hooks, involve a 1101@code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as
1089little more Emacs Lisp programming expertise. 1102hooks, involve a little more Emacs Lisp programming expertise.
1090 1103
1091@cindex @samp{mh} customization group 1104@cindex @samp{mh} customization group
1092@cindex customization group, @samp{mh} 1105@cindex customization group, @samp{mh}
@@ -1262,7 +1275,7 @@ used.
1262 1275
1263@vtable @code 1276@vtable @code
1264@item mh-inc-prog 1277@item mh-inc-prog
1265Program to incorporate mail (default: @samp{"inc"}). 1278Program to incorporate mail (default: @code{"inc"}).
1266@c ------------------------- 1279@c -------------------------
1267@item mh-inc-spool-list 1280@item mh-inc-spool-list
1268Alternate spool files (default: @code{nil}). 1281Alternate spool files (default: @code{nil}).
@@ -1306,7 +1319,7 @@ mode line besides, add the following to @file{~/.emacs}:
1306@vindex mh-progs 1319@vindex mh-progs
1307 1320
1308The name of the program that incorporates new mail is stored in 1321The name of the program that incorporates new mail is stored in
1309@code{mh-inc-prog}; it is @samp{"inc"} by default. This program 1322@code{mh-inc-prog}; it is @code{"inc"} by default. This program
1310generates a one-line summary for each of the new messages. Unless it 1323generates a one-line summary for each of the new messages. Unless it
1311is an absolute pathname, the file is assumed to be in the 1324is an absolute pathname, the file is assumed to be in the
1312@code{mh-progs} directory (@pxref{Getting Started}). You may also link 1325@code{mh-progs} directory (@pxref{Getting Started}). You may also link
@@ -1714,7 +1727,7 @@ On means non-reversible commands do not prompt for confirmation
1714@c ------------------------- 1727@c -------------------------
1715@item mh-fetch-x-image-url 1728@item mh-fetch-x-image-url
1716Control fetching of @samp{X-Image-URL:} header field image (default: 1729Control fetching of @samp{X-Image-URL:} header field image (default:
1717@code{Never Fetch}). 1730@samp{Never Fetch}).
1718@c ------------------------- 1731@c -------------------------
1719@item mh-graphical-smileys-flag 1732@item mh-graphical-smileys-flag
1720On means graphical smileys are displayed (default: @samp{on}). 1733On means graphical smileys are displayed (default: @samp{on}).
@@ -1733,14 +1746,14 @@ here).
1733Additional header fields to hide (default: @code{nil}). 1746Additional header fields to hide (default: @code{nil}).
1734@c ------------------------- 1747@c -------------------------
1735@item mh-lpr-command-format 1748@item mh-lpr-command-format
1736Command used to print (default: @samp{"lpr -J '%s'"}). 1749Command used to print (default: @code{"lpr -J '%s'"}).
1737@c ------------------------- 1750@c -------------------------
1738@item mh-max-inline-image-height 1751@item mh-max-inline-image-height
1739Maximum inline image height if \"Content-Disposition:\" is not 1752Maximum inline image height if @samp{Content-Disposition:} is not
1740present (default: 0). 1753present (default: 0).
1741@c ------------------------- 1754@c -------------------------
1742@item mh-max-inline-image-width 1755@item mh-max-inline-image-width
1743Maximum inline image width if \"Content-Disposition:\" is not 1756Maximum inline image width if @samp{Content-Disposition:} is not
1744present(default: 0). 1757present(default: 0).
1745@c ------------------------- 1758@c -------------------------
1746@item mh-mhl-format-file 1759@item mh-mhl-format-file
@@ -1754,12 +1767,16 @@ Default directory to use for @kbd{K a}.
1754On means messages should be printed in the background (default: 1767On means messages should be printed in the background (default:
1755@samp{off}). 1768@samp{off}).
1756@c ------------------------- 1769@c -------------------------
1770@item mh-show-buffer-mode-line-buffer-id
1771Format string to produce @code{mode-line-buffer-identification} for
1772show buffers (default: @code{" @{show-%s@} %d"}).
1773@c -------------------------
1757@item mh-show-maximum-size 1774@item mh-show-maximum-size
1758Maximum size of message (in bytes) to display automatically (default: 1775Maximum size of message (in bytes) to display automatically (default:
17590). 17760).
1760@c ------------------------- 1777@c -------------------------
1761@item mh-show-use-xface-flag 1778@item mh-show-use-xface-flag
1762On means display face images in MH-Show buffers (default: @code{on}). 1779On means display face images in MH-Show buffers (default: @samp{on}).
1763@c ------------------------- 1780@c -------------------------
1764@item mh-store-default-directory 1781@item mh-store-default-directory
1765Default directory for @kbd{X s} (default: @samp{Current}). 1782Default directory for @kbd{X s} (default: @samp{Current}).
@@ -2074,7 +2091,7 @@ list. Both of these options are disabled if the option
2074 2091
2075MH-E normally renders signatures and vCards in italics so that the 2092MH-E normally renders signatures and vCards in italics so that the
2076body of the message stands out more. MH-E depends on the presence of 2093body of the message stands out more. MH-E depends on the presence of
2077the @dfn{signature separator} (@samp{"-- "}) to do this. You can also 2094the @dfn{signature separator} (@code{"-- "}) to do this. You can also
2078customize the face @code{mh-show-signature} so the appearance of the 2095customize the face @code{mh-show-signature} so the appearance of the
2079signature block is more to your liking. 2096signature block is more to your liking.
2080 2097
@@ -2098,7 +2115,7 @@ For those who like to modify their mode lines, use
2098the MH-Show buffers. Place the two escape strings @samp{%s} and 2115the MH-Show buffers. Place the two escape strings @samp{%s} and
2099@samp{%d}, which will display the folder name and the message number, 2116@samp{%d}, which will display the folder name and the message number,
2100respectively, somewhere in the string in that order. The default value 2117respectively, somewhere in the string in that order. The default value
2101of @samp{"@{show-%s@} %d"} yields a mode line of 2118of @code{"@{show-%s@} %d"} yields a mode line of
2102 2119
2103@smallexample 2120@smallexample
2104-----@{show-+inbox@} 4 (MH-Show)--Bot-------------------------------- 2121-----@{show-+inbox@} 4 (MH-Show)--Bot--------------------------------
@@ -2344,8 +2361,8 @@ then you'll see a button like this:
2344[1. text/html; foo.html]... 2361[1. text/html; foo.html]...
2345@end example 2362@end example
2346 2363
2347See @ref{Viewing Attachments} to see how to read the contents of this 2364To see how to read the contents of this body part, see @ref{Viewing
2348body part. 2365Attachments}.
2349 2366
2350The browser that MH-E uses is determined by the option 2367The browser that MH-E uses is determined by the option
2351@code{mm-text-html-renderer}. The default setting is set automatically 2368@code{mm-text-html-renderer}. The default setting is set automatically
@@ -2685,7 +2702,7 @@ The command @kbd{P l} uses two options. The option
2685performs the actual printing. The string can contain one escape, 2702performs the actual printing. The string can contain one escape,
2686@samp{%s}, which is replaced by the name of the folder and the message 2703@samp{%s}, which is replaced by the name of the folder and the message
2687number and is useful for print job names. The default setting is 2704number and is useful for print job names. The default setting is
2688@samp{"lpr -J '%s'"}. I use @samp{"mpage -h'%s' -b Letter -H1of -mlrtb 2705@code{"lpr -J '%s'"}. I use @code{"mpage -h'%s' -b Letter -H1of -mlrtb
2689-P"} which produces a nice header and adds a bit of margin so the text 2706-P"} which produces a nice header and adds a bit of margin so the text
2690fits within my printer's margins. Normally messages are printed in the 2707fits within my printer's margins. Normally messages are printed in the
2691foreground. If this is slow on your system, you may elect to turn on 2708foreground. If this is slow on your system, you may elect to turn on
@@ -3270,8 +3287,8 @@ after a message is marked to be refiled.
3270 3287
3271If you are refiling several messages into the same folder, you can use 3288If you are refiling several messages into the same folder, you can use
3272the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the 3289the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the
3273last refile or write (see the description of @kbd{>} 3290last refile or write (for the description of @kbd{>}
3274(@code{mh-write-msg-to-file} in @ref{Files and Pipes}). You can use a 3291(@code{mh-write-msg-to-file}), @pxref{Files and Pipes}). You can use a
3275range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob 3292range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob
3276@key{RET}}, @pxref{Ranges}). 3293@key{RET}}, @pxref{Ranges}).
3277 3294
@@ -3616,7 +3633,7 @@ On means prompt for header fields when composing a new draft (default:
3616@samp{off}). 3633@samp{off}).
3617@c ------------------------- 3634@c -------------------------
3618@item mh-forward-subject-format 3635@item mh-forward-subject-format
3619Format string for forwarded message subject (default: @samp{"%s: 3636Format string for forwarded message subject (default: @code{"%s:
3620%s"}). 3637%s"}).
3621@c ------------------------- 3638@c -------------------------
3622@item mh-insert-x-mailer-flag 3639@item mh-insert-x-mailer-flag
@@ -3692,17 +3709,16 @@ following key bindings to @file{~/.emacs} useful:
3692 3709
3693From within a MH-Folder buffer, you can simply use the command @kbd{m} 3710From within a MH-Folder buffer, you can simply use the command @kbd{m}
3694(@code{mh-send}). However you invoke @code{mh-send}, your letter 3711(@code{mh-send}). However you invoke @code{mh-send}, your letter
3695appears in an Emacs buffer whose mode is MH-Letter (see the Figure in 3712appears in an Emacs buffer whose mode is MH-Letter (to see what the
3696@ref{Sending Mail Tour} to see what the buffer looks like). MH-Letter 3713buffer looks like, @pxref{Sending Mail Tour}). MH-Letter mode allows
3697mode allows you to edit your message, to check the validity of the 3714you to edit your message, to check the validity of the recipients, to
3698recipients, to insert attachments and other messages into your 3715insert attachments and other messages into your message, and to send
3699message, and to send the message. We'll go more into depth about 3716the message. We'll go more into depth about editing a
3700editing a @dfn{draft}@footnote{I highly recommend that you use a 3717@dfn{draft}@footnote{I highly recommend that you use a @dfn{draft
3701@dfn{draft folder} so that you can edit several drafts in parallel. To 3718folder} so that you can edit several drafts in parallel. To do so,
3702do so, create a folder named @samp{+drafts} for example, and add the 3719create a folder named @samp{+drafts} for example, and add the profile
3703profile component @samp{Draft-Folder: drafts} (see 3720component @samp{Draft-Folder: drafts} (see @code{mh-profile}(5)).} (a
3704@code{mh-profile}(5)).} (a message you're composing) in just a moment 3721message you're composing) in just a moment (@pxref{Editing Drafts}).
3705(@pxref{Editing Drafts}).
3706 3722
3707@vindex mh-compose-prompt-flag 3723@vindex mh-compose-prompt-flag
3708 3724
@@ -3912,7 +3928,7 @@ is controlled by the option @code{mh-forward-subject-format}. This
3912option is a string which includes two escapes (@samp{%s}). The first 3928option is a string which includes two escapes (@samp{%s}). The first
3913@samp{%s} is replaced with the sender of the original message, and the 3929@samp{%s} is replaced with the sender of the original message, and the
3914second one is replaced with the original @samp{Subject:}. The default 3930second one is replaced with the original @samp{Subject:}. The default
3915value of @samp{"%s: %s"} takes a message with the header: 3931value of @code{"%s: %s"} takes a message with the header:
3916 3932
3917@smallexample 3933@smallexample
3918@group 3934@group
@@ -4310,11 +4326,11 @@ On means delete any window displaying the message (default: @samp{off}).
4310@c ------------------------- 4326@c -------------------------
4311@item mh-extract-from-attribution-verb 4327@item mh-extract-from-attribution-verb
4312Verb to use for attribution when a message is yanked by @kbd{C-c C-y} 4328Verb to use for attribution when a message is yanked by @kbd{C-c C-y}
4313(default: @samp{"wrote:"}). 4329(default: @code{"wrote:"}).
4314@c ------------------------- 4330@c -------------------------
4315@item mh-ins-buf-prefix 4331@item mh-ins-buf-prefix
4316String to put before each line of a yanked or inserted message 4332String to put before each line of a yanked or inserted message
4317(default: @samp{"> "}). 4333(default: @code{"> "}).
4318@c ------------------------- 4334@c -------------------------
4319@item mh-letter-complete-function 4335@item mh-letter-complete-function
4320Function to call when completing outside of address or folder fields 4336Function to call when completing outside of address or folder fields
@@ -4328,7 +4344,7 @@ Default method to use in security tags (default: @samp{PGP (MIME)} if
4328support for it is available; otherwise @samp{None}). 4344support for it is available; otherwise @samp{None}).
4329@c ------------------------- 4345@c -------------------------
4330@item mh-signature-file-name 4346@item mh-signature-file-name
4331Source of user's signature (default: @samp{"~/.signature"}). 4347Source of user's signature (default: @code{"~/.signature"}).
4332@c ------------------------- 4348@c -------------------------
4333@item mh-signature-separator-flag 4349@item mh-signature-separator-flag
4334On means a signature separator should be inserted (default: 4350On means a signature separator should be inserted (default:
@@ -4336,7 +4352,7 @@ On means a signature separator should be inserted (default:
4336@c ------------------------- 4352@c -------------------------
4337@item mh-x-face-file 4353@item mh-x-face-file
4338File containing X-Face or Face header field to insert in outgoing mail. 4354File containing X-Face or Face header field to insert in outgoing mail.
4339(default: @samp{"~/.face"}). 4355(default: @code{"~/.face"}).
4340@c ------------------------- 4356@c -------------------------
4341@item mh-yank-behavior 4357@item mh-yank-behavior
4342Controls which part of a message is yanked by @kbd{C-c C-y} (default: 4358Controls which part of a message is yanked by @kbd{C-c C-y} (default:
@@ -4594,7 +4610,7 @@ the @samp{Custom String} menu item to enter your own verb.
4594 4610
4595@vindex mh-ins-buf-prefix 4611@vindex mh-ins-buf-prefix
4596 4612
4597The prefix @samp{"> "} is the default setting for the option 4613The prefix @code{"> "} is the default setting for the option
4598@code{mh-ins-buf-prefix}. I suggest that you not modify this option 4614@code{mh-ins-buf-prefix}. I suggest that you not modify this option
4599since it is used by many mailers and news readers: messages are far 4615since it is used by many mailers and news readers: messages are far
4600easier to read if several included messages have all been indented by 4616easier to read if several included messages have all been indented by
@@ -4727,7 +4743,7 @@ if the buffer contains a separator, may be useful as well.
4727@cindex signature separator 4743@cindex signature separator
4728@vindex mh-signature-separator-flag 4744@vindex mh-signature-separator-flag
4729 4745
4730A signature separator (@samp{"-- "}) will be added if the signature 4746A signature separator (@code{"-- "}) will be added if the signature
4731block does not contain one and @code{mh-signature-separator-flag} is 4747block does not contain one and @code{mh-signature-separator-flag} is
4732on. It is not recommended that you change this option since various 4748on. It is not recommended that you change this option since various
4733mail user agents, including MH-E, use the separator to present the 4749mail user agents, including MH-E, use the separator to present the
@@ -5350,7 +5366,7 @@ If @samp{on}, local users are added to alias completion (default:
5350@c ------------------------- 5366@c -------------------------
5351@item mh-alias-local-users-prefix 5367@item mh-alias-local-users-prefix
5352String prefixed to the real names of users from the password file 5368String prefixed to the real names of users from the password file
5353(default: @samp{"local."}. 5369(default: @code{"local."}.
5354@c ------------------------- 5370@c -------------------------
5355@item mh-alias-passwd-gecos-comma-separator-flag 5371@item mh-alias-passwd-gecos-comma-separator-flag
5356On means the GECOS field in the password file uses a comma separator 5372On means the GECOS field in the password file uses a comma separator
@@ -5991,7 +6007,7 @@ frame. You can choose from one of @samp{Same As Default Tool Bar},
5991@samp{Top}, @samp{Bottom}, @samp{Left}, or @samp{Right}. If this 6007@samp{Top}, @samp{Bottom}, @samp{Left}, or @samp{Right}. If this
5992variable is set to anything other than @samp{Same As Default Tool Bar} 6008variable is set to anything other than @samp{Same As Default Tool Bar}
5993and the default tool bar is in a different location, then two tool 6009and the default tool bar is in a different location, then two tool
5994bars will be displayed: the MH-E tool bar and the default tool bar." 6010bars will be displayed: the MH-E tool bar and the default tool bar.
5995 6011
5996@node Searching, Threading, Tool Bar, Top 6012@node Searching, Threading, Tool Bar, Top
5997@chapter Searching Through Messages 6013@chapter Searching Through Messages
@@ -7059,7 +7075,7 @@ works best for you.
7059First, run @samp{spamassassin -t} on every mail message in your 7075First, run @samp{spamassassin -t} on every mail message in your
7060archive and use @command{gnumeric} to verify that the average plus the 7076archive and use @command{gnumeric} to verify that the average plus the
7061standard deviation of good mail is under 5, the SpamAssassin default 7077standard deviation of good mail is under 5, the SpamAssassin default
7062for "spam". 7078for ``spam''.
7063 7079
7064Using @command{gnumeric}, sort the messages by score and view the 7080Using @command{gnumeric}, sort the messages by score and view the
7065messages with the highest score. Determine the score which encompasses 7081messages with the highest score. Determine the score which encompasses
@@ -7370,7 +7386,7 @@ Specifies the format file to pass to the scan program (default:
7370@samp{Use MH-E scan Format}). 7386@samp{Use MH-E scan Format}).
7371@c ------------------------- 7387@c -------------------------
7372@item mh-scan-prog 7388@item mh-scan-prog
7373Program used to scan messages (default: @samp{"scan"}). 7389Program used to scan messages (default: @code{"scan"}).
7374@end vtable 7390@end vtable
7375 7391
7376@findex mh-set-cmd-note 7392@findex mh-set-cmd-note
@@ -7459,7 +7475,7 @@ the @samp{Bcc:} field matches, and @samp{n} if a non-empty
7459@vindex mh-scan-prog 7475@vindex mh-scan-prog
7460 7476
7461The name of the program that generates a listing of one line per 7477The name of the program that generates a listing of one line per
7462message is held in @code{mh-scan-prog} (default: @samp{"scan"}). 7478message is held in @code{mh-scan-prog} (default: @code{"scan"}).
7463Unless this variable contains an absolute pathname, it is assumed to 7479Unless this variable contains an absolute pathname, it is assumed to
7464be in the @code{mh-progs} directory (@pxref{Getting Started}). You may 7480be in the @code{mh-progs} directory (@pxref{Getting Started}). You may
7465link another program to @command{scan} (see @samp{mh-profile}(5)) to 7481link another program to @command{scan} (see @samp{mh-profile}(5)) to
@@ -7471,22 +7487,21 @@ pick Ranges Sequences} in the MH book.}.
7471 7487
7472If you change the format of the scan lines you'll need to tell MH-E 7488If you change the format of the scan lines you'll need to tell MH-E
7473how to parse the new format. As you will see, quite a lot of variables 7489how to parse the new format. As you will see, quite a lot of variables
7474are involved to do that. Use @samp{M-x apropos @key{RET} mh-scan.*regexp'} 7490are involved to do that. Use @samp{M-x apropos @key{RET}
7475to obtain a list of these variables. You will also have to call 7491mh-scan.*regexp @key{RET}} to obtain a list of these variables. You
7476@code{mh-set-cmd-note} if your notations are not in column 4 (columns 7492will also have to call @code{mh-set-cmd-note} if your notations are
7477in Emacs start with 0). Note that unlike most of the user options 7493not in column 4 (columns in Emacs start with 0). Note that unlike most
7478described in this manual, these are variables and must be set with 7494of the user options described in this manual, these are variables and
7479@code{setq} instead of in a customization buffer. For help with 7495must be set with @code{setq} instead of in a customization buffer. For
7480regular expressions, see 7496help with regular expressions, see
7481@ifnothtml 7497@ifnothtml
7482@ref{Regexps, , Syntax of Regular Expressions, emacs, The 7498@ref{Regexps, , Syntax of Regular Expressions, emacs, The
7483GNU Emacs Manual} 7499GNU Emacs Manual}.
7484@end ifnothtml 7500@end ifnothtml
7485@ifhtml 7501@ifhtml
7486the section 7502section
7487@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html, 7503@uref{http://www.gnu.org/software/emacs/manual/html_node/Regexps.html,
7488Syntax of Regular Expressions} in 7504Syntax of Regular Expressions} in @cite{The GNU Emacs Manual}.
7489@cite{The GNU Emacs Manual}).
7490@end ifhtml 7505@end ifhtml
7491 7506
7492The first variable has to do with pruning out garbage. 7507The first variable has to do with pruning out garbage.
@@ -7501,7 +7516,7 @@ This regular expression describes a valid scan line. This is used to
7501eliminate error messages that are occasionally produced by 7516eliminate error messages that are occasionally produced by
7502@command{inc}@footnote{See the section 7517@command{inc}@footnote{See the section
7503@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next 7518@uref{@value{MH-BOOK-HOME}/reapre.htm, Reading Mail: inc show next
7504prev} in the MH book.} or @command{scan} (default: @samp{"^ *[0-9]"}). 7519prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}).
7505@end vtable 7520@end vtable
7506 7521
7507Next, many variables control how the scan lines are parsed. 7522Next, many variables control how the scan lines are parsed.
@@ -7516,7 +7531,7 @@ This regular expression matches the message body fragment. Note that
7516the default setting of @code{mh-folder-font-lock-keywords} expects 7531the default setting of @code{mh-folder-font-lock-keywords} expects
7517this expression to contain at least one parenthesized expression which 7532this expression to contain at least one parenthesized expression which
7518matches the body text as in the default of 7533matches the body text as in the default of
7519@samp{"\\(<<\\([^\n]+\\)?\\)"}. If this regular expression is not 7534@code{"\\(<<\\([^\n]+\\)?\\)"}. If this regular expression is not
7520correct, the body fragment will not be highlighted with the face 7535correct, the body fragment will not be highlighted with the face
7521@code{mh-folder-body}. 7536@code{mh-folder-body}.
7522@c ------------------------- 7537@c -------------------------
@@ -7528,7 +7543,7 @@ This regular expression matches the current message. It must match
7528from the beginning of the line. Note that the default setting of 7543from the beginning of the line. Note that the default setting of
7529@code{mh-folder-font-lock-keywords} expects this expression to contain 7544@code{mh-folder-font-lock-keywords} expects this expression to contain
7530at least one parenthesized expression which matches the message number 7545at least one parenthesized expression which matches the message number
7531as in the default of @w{@samp{"^\\( *[0-9]+\\+\\).*"}}. This 7546as in the default of @w{@code{"^\\( *[0-9]+\\+\\).*"}}. This
7532expression includes the leading space and current message marker 7547expression includes the leading space and current message marker
7533@samp{+} within the parenthesis since it looks better to highlight 7548@samp{+} within the parenthesis since it looks better to highlight
7534these items as well. The highlighting is done with the face 7549these items as well. The highlighting is done with the face
@@ -7545,7 +7560,7 @@ anchored to the beginning or the end of the line. Note that the
7545default setting of @code{mh-folder-font-lock-keywords} expects this 7560default setting of @code{mh-folder-font-lock-keywords} expects this
7546expression to contain only one parenthesized expression which matches 7561expression to contain only one parenthesized expression which matches
7547the date field as in the default of 7562the date field as in the default of
7548@samp{"\\([0-9][0-9]/[0-9][0-9]\\)"}. If this regular expression is 7563@code{"\\([0-9][0-9]/[0-9][0-9]\\)"}. If this regular expression is
7549not correct, the date will not be highlighted with the face 7564not correct, the date will not be highlighted with the face
7550@code{mh-folder-date}. 7565@code{mh-folder-date}.
7551@c ------------------------- 7566@c -------------------------
@@ -7557,7 +7572,7 @@ This regular expression matches deleted messages. It must match from
7557the beginning of the line. Note that the default setting of 7572the beginning of the line. Note that the default setting of
7558@code{mh-folder-font-lock-keywords} expects this expression to contain 7573@code{mh-folder-font-lock-keywords} expects this expression to contain
7559at least one parenthesized expression which matches the message number 7574at least one parenthesized expression which matches the message number
7560as in the default of @samp{"^\\( *[0-9]+\\)D"}. This expression 7575as in the default of @code{"^\\( *[0-9]+\\)D"}. This expression
7561includes the leading space within the parenthesis since it looks 7576includes the leading space within the parenthesis since it looks
7562better to highlight it as well. The highlighting is done with the face 7577better to highlight it as well. The highlighting is done with the face
7563@code{mh-folder-deleted}. This regular expression should be correct as 7578@code{mh-folder-deleted}. This regular expression should be correct as
@@ -7571,7 +7586,7 @@ This regular expression matches ``good'' messages. It must match from
7571the beginning of the line. Note that the default setting of 7586the beginning of the line. Note that the default setting of
7572@code{mh-folder-font-lock-keywords} expects this expression to contain 7587@code{mh-folder-font-lock-keywords} expects this expression to contain
7573at least one parenthesized expression which matches the message number 7588at least one parenthesized expression which matches the message number
7574as in the default of @w{@samp{"^\\( *[0-9]+\\)[^D^0-9]"}}. This 7589as in the default of @w{@code{"^\\( *[0-9]+\\)[^D^0-9]"}}. This
7575expression includes the leading space within the parenthesis since it 7590expression includes the leading space within the parenthesis since it
7576looks better to highlight it as well. The highlighting is done with 7591looks better to highlight it as well. The highlighting is done with
7577the face @code{mh-folder-msg-number}. This regular expression should 7592the face @code{mh-folder-msg-number}. This regular expression should
@@ -7581,7 +7596,7 @@ be correct as it is needed by non-fontification functions.
7581@item mh-scan-msg-format-regexp 7596@item mh-scan-msg-format-regexp
7582This regular expression finds the message number width in a scan 7597This regular expression finds the message number width in a scan
7583format. Note that the message number must be placed in a parenthesized 7598format. Note that the message number must be placed in a parenthesized
7584expression as in the default of @samp{"%\\([0-9]*\\)(msg)"}. This 7599expression as in the default of @code{"%\\([0-9]*\\)(msg)"}. This
7585variable is only consulted if @code{mh-scan-format-file} is set to 7600variable is only consulted if @code{mh-scan-format-file} is set to
7586@samp{Use MH-E scan Format}. 7601@samp{Use MH-E scan Format}.
7587@c ------------------------- 7602@c -------------------------
@@ -7590,22 +7605,22 @@ variable is only consulted if @code{mh-scan-format-file} is set to
7590This is a format string for the width of the message number in a scan 7605This is a format string for the width of the message number in a scan
7591format. Use @samp{0%d} for zero-filled message numbers. This variable 7606format. Use @samp{0%d} for zero-filled message numbers. This variable
7592is only consulted if @code{mh-scan-format-file} is set to @samp{Use 7607is only consulted if @code{mh-scan-format-file} is set to @samp{Use
7593MH-E scan Format} (default: @samp{"%d"}). 7608MH-E scan Format} (default: @code{"%d"}).
7594@c ------------------------- 7609@c -------------------------
7595@item mh-scan-msg-number-regexp 7610@item mh-scan-msg-number-regexp
7596This regular expression extracts the message number. It must match 7611This regular expression extracts the message number. It must match
7597from the beginning of the line. Note that the message number must be 7612from the beginning of the line. Note that the message number must be
7598placed in a parenthesized expression as in the default of @w{@samp{"^ 7613placed in a parenthesized expression as in the default of @w{@code{"^
7599*\\([0-9]+\\)"}}. 7614*\\([0-9]+\\)"}}.
7600@c ------------------------- 7615@c -------------------------
7601@item mh-scan-msg-overflow-regexp 7616@item mh-scan-msg-overflow-regexp
7602This regular expression matches overflowed message numbers (default: 7617This regular expression matches overflowed message numbers (default:
7603@samp{"^[?0-9][0-9]"}). 7618@code{"^[?0-9][0-9]"}).
7604@c ------------------------- 7619@c -------------------------
7605@item mh-scan-msg-search-regexp 7620@item mh-scan-msg-search-regexp
7606This regular expression matches a particular message. It is a format 7621This regular expression matches a particular message. It is a format
7607string; use @samp{%d} to represent the location of the message number 7622string; use @samp{%d} to represent the location of the message number
7608within the expression as in the default of @samp{"^[^0-9]*%d[^0-9]"}. 7623within the expression as in the default of @code{"^[^0-9]*%d[^0-9]"}.
7609@c ------------------------- 7624@c -------------------------
7610@vindex mh-folder-address 7625@vindex mh-folder-address
7611@vindex mh-folder-font-lock-keywords 7626@vindex mh-folder-font-lock-keywords
@@ -7616,7 +7631,7 @@ Note that the default setting of @code{mh-folder-font-lock-keywords}
7616expects this expression to contain two parenthesized expressions. The 7631expects this expression to contain two parenthesized expressions. The
7617first is expected to match the @samp{To:} that the default scan format 7632first is expected to match the @samp{To:} that the default scan format
7618file generates. The second is expected to match the recipient's name 7633file generates. The second is expected to match the recipient's name
7619as in the default of @samp{"\\(To:\\)\\(..............\\)"}. If this 7634as in the default of @code{"\\(To:\\)\\(..............\\)"}. If this
7620regular expression is not correct, the @samp{To:} string will not be 7635regular expression is not correct, the @samp{To:} string will not be
7621highlighted with the face @code{mh-folder-to} and the recipient will not be 7636highlighted with the face @code{mh-folder-to} and the recipient will not be
7622highlighted with the face @code{mh-folder-address}. 7637highlighted with the face @code{mh-folder-address}.
@@ -7629,7 +7644,7 @@ This regular expression matches refiled messages. It must match from
7629the beginning of the line. Note that the default setting of 7644the beginning of the line. Note that the default setting of
7630@code{mh-folder-font-lock-keywords} expects this expression to contain 7645@code{mh-folder-font-lock-keywords} expects this expression to contain
7631at least one parenthesized expression which matches the message number 7646at least one parenthesized expression which matches the message number
7632as in the default of @w{@samp{"^\\( *[0-9]+\\)\\^"}}. This expression 7647as in the default of @w{@code{"^\\( *[0-9]+\\)\\^"}}. This expression
7633includes the leading space within the parenthesis since it looks 7648includes the leading space within the parenthesis since it looks
7634better to highlight it as well. The highlighting is done with the face 7649better to highlight it as well. The highlighting is done with the face
7635@code{mh-folder-refiled}. This regular expression should be correct as 7650@code{mh-folder-refiled}. This regular expression should be correct as
@@ -7647,7 +7662,7 @@ expression to contain at least two parenthesized expressions. The
7647first should match the fontification hint (see 7662first should match the fontification hint (see
7648@code{mh-scan-format-nmh}) and the second should match the user name 7663@code{mh-scan-format-nmh}) and the second should match the user name
7649as in the default of 7664as in the default of
7650@w{@samp{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}. 7665@w{@code{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}.
7651If this regular expression is not correct, the notation hints will not 7666If this regular expression is not correct, the notation hints will not
7652be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and 7667be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and
7653the sender will not be highlighted with the face 7668the sender will not be highlighted with the face
@@ -7667,8 +7682,8 @@ number after @samp{Re:}, such as in @samp{Re[2]:} (and is thus a
7667sub-expression of the first expression). The third is expected to 7682sub-expression of the first expression). The third is expected to
7668match the subject line itself which is highlighted with the face 7683match the subject line itself which is highlighted with the face
7669@code{mh-folder-subject}. For example, the default is 7684@code{mh-folder-subject}. For example, the default is
7670@w{@samp{"^ *[0-9]+........[ ]*...................}}@* 7685@w{@code{"^ *[0-9]+........[ ]*...................}}@*
7671@w{@samp{\\([Rr][Ee]\\(\\[[0-9]+\\]\\)?:\\s-*\\)*\\([^<\n]*\\)"}}. 7686@w{@code{\\([Rr][Ee]\\(\\[[0-9]+\\]\\)?:\\s-*\\)*\\([^<\n]*\\)"}}.
7672This regular expression should be correct as it is needed by 7687This regular expression should be correct as it is needed by
7673non-fontification functions. Note that this example is broken up on 7688non-fontification functions. Note that this example is broken up on
7674two lines for readability, but is actually a single string. 7689two lines for readability, but is actually a single string.
@@ -7687,39 +7702,39 @@ Emacs start with 0.
7687@c ------------------------- 7702@c -------------------------
7688@item mh-note-copied 7703@item mh-note-copied
7689Messages that have been copied are marked by this character (default: 7704Messages that have been copied are marked by this character (default:
7690@samp{?C}). 7705@code{?C}).
7691@c ------------------------- 7706@c -------------------------
7692@item mh-note-cur 7707@item mh-note-cur
7693The current message (in MH, not in MH-E) is marked by this character 7708The current message (in MH, not in MH-E) is marked by this character
7694(default: @samp{?+}). See also @code{mh-scan-cur-msg-number-regexp}. 7709(default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}.
7695@c ------------------------- 7710@c -------------------------
7696@item mh-note-deleted 7711@item mh-note-deleted
7697Messages that have been deleted are marked by this character (default: 7712Messages that have been deleted are marked by this character (default:
7698@samp{?D}). See also @code{mh-scan-deleted-msg-regexp}. 7713@code{?D}). See also @code{mh-scan-deleted-msg-regexp}.
7699@c ------------------------- 7714@c -------------------------
7700@item mh-note-dist 7715@item mh-note-dist
7701Messages that have been redistributed are marked by this character 7716Messages that have been redistributed are marked by this character
7702(default: @samp{?R}). 7717(default: @code{?R}).
7703@c ------------------------- 7718@c -------------------------
7704@item mh-note-forw 7719@item mh-note-forw
7705Messages that have been forwarded are marked by this character 7720Messages that have been forwarded are marked by this character
7706(default: @samp{?F}). 7721(default: @code{?F}).
7707@c ------------------------- 7722@c -------------------------
7708@item mh-note-printed 7723@item mh-note-printed
7709Messages that have been printed are marked by this character (default: 7724Messages that have been printed are marked by this character (default:
7710@samp{?P}). 7725@code{?P}).
7711@c ------------------------- 7726@c -------------------------
7712@item mh-note-refiled 7727@item mh-note-refiled
7713Messages that have been refiled are marked by this character (default: 7728Messages that have been refiled are marked by this character (default:
7714@samp{?^}). See also @code{mh-scan-refiled-msg-regexp}. 7729@code{?^}). See also @code{mh-scan-refiled-msg-regexp}.
7715@c ------------------------- 7730@c -------------------------
7716@item mh-note-repl 7731@item mh-note-repl
7717Messages that have been replied to are marked by this character 7732Messages that have been replied to are marked by this character
7718(default: @samp{?-}). 7733(default: @code{?-}).
7719@c ------------------------- 7734@c -------------------------
7720@item mh-note-seq 7735@item mh-note-seq
7721Messages in a user-defined sequence are marked by this character 7736Messages in a user-defined sequence are marked by this character
7722(default: @samp{?%}). Messages in the @samp{search} sequence are 7737(default: @code{?%}). Messages in the @samp{search} sequence are
7723marked by this character as well. 7738marked by this character as well.
7724@end vtable 7739@end vtable
7725 7740