Mercurial > emacs
comparison man/mh-e.texi @ 69427:656079a407fa
(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 "...".
author | Bill Wohler <wohler@newt.com> |
---|---|
date | Sun, 12 Mar 2006 01:06:59 +0000 |
parents | abc374b7aa85 |
children | 1a3742d0d1cf |
comparison
equal
deleted
inserted
replaced
69426:46a8c3e0161d | 69427:656079a407fa |
---|---|
6 @setfilename ../info/mh-e | 6 @setfilename ../info/mh-e |
7 @settitle The MH-E Manual | 7 @settitle The MH-E Manual |
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. |
19 @set MH-BOOK-HOME http://www.ics.uci.edu/~mh/book/mh | 19 @set MH-BOOK-HOME http://www.ics.uci.edu/~mh/book/mh |
20 @set MH-E-HOME http://mh-e.sourceforge.net/ | 20 @set MH-E-HOME http://mh-e.sourceforge.net/ |
216 @value{VERSION} of MH-E will appear in GNU Emacs 22.1. It is supported | 216 @value{VERSION} of MH-E will appear in GNU Emacs 22.1. It is supported |
217 in GNU Emacs 21, as well as XEmacs 21 (except for versions | 217 in GNU Emacs 21, as well as XEmacs 21 (except for versions |
218 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, | 218 21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher, |
219 all versions of nmh, and GNU mailutils 0.4 and higher.}, so you | 219 all versions of nmh, and GNU mailutils 0.4 and higher.}, so you |
220 shouldn't have to do anything special to use it. This manual covers | 220 shouldn't have to do anything special to use it. This manual covers |
221 MH-E version @value{VERSION}. @ref{Getting Started} will help you | 221 MH-E version @value{VERSION}. To help you decide which version you |
222 decide which version you have. | 222 have, see @ref{Getting Started}. |
223 | 223 |
224 If you don't already use GNU Emacs but want to learn more, you can | 224 If you don't already use GNU Emacs but want to learn more, you can |
225 read an online tutorial by starting GNU Emacs and typing @kbd{C-h t} | 225 read an online tutorial by starting GNU Emacs and typing @kbd{C-h t} |
226 (@code{help-with-tutorial}). (To learn about this notation, see | 226 (@code{help-with-tutorial}). (To learn about this notation, see |
227 @ref{Conventions}.) If you want to take the plunge, consult the | 227 @ref{Conventions}.) If you want to take the plunge, consult the |
552 environment@footnote{See the section | 552 environment@footnote{See the section |
553 @uref{@value{MH-BOOK-HOME}/setup.htm, Setting Up MH} in the MH book.}. | 553 @uref{@value{MH-BOOK-HOME}/setup.htm, Setting Up MH} in the MH book.}. |
554 If you don't, you'll be greeted with the error message: @samp{Install | 554 If you don't, you'll be greeted with the error message: @samp{Install |
555 MH and run install-mh before running MH-E}. | 555 MH 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 | |
562 Your MH environment includes your @dfn{MH profile} which is found in | |
563 the file @file{~/.mh_profile}. This file contains a number of @dfn{MH | |
564 profile components}. For example, the @samp{Path:} MH profile | |
565 component 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 |
560 @cindex @samp{Unseen-Sequence:} MH profile component | 571 @cindex @samp{Unseen-Sequence:} MH profile component |
561 @cindex MH profile component, @samp{Draft-Folder:} | 572 @cindex MH profile component, @samp{Draft-Folder:} |
884 more. If you think that MH-E is for you, read the rest of the manual | 895 more. If you think that MH-E is for you, read the rest of the manual |
885 to find out how you can: | 896 to find out how you can: |
886 | 897 |
887 @itemize @bullet | 898 @itemize @bullet |
888 @item | 899 @item |
889 Print your messages (@ref{Printing}). | 900 Print your messages (@pxref{Printing}). |
890 @c ------------------------- | 901 @c ------------------------- |
891 @item | 902 @item |
892 Edit messages and include your signature (@ref{Editing Drafts}). | 903 Edit messages and include your signature (@pxref{Editing Drafts}). |
893 @c ------------------------- | 904 @c ------------------------- |
894 @item | 905 @item |
895 Forward messages (@ref{Forwarding}). | 906 Forward messages (@pxref{Forwarding}). |
896 @c ------------------------- | 907 @c ------------------------- |
897 @item | 908 @item |
898 Read digests (@ref{Digests}). | 909 Read digests (@pxref{Digests}). |
899 @c ------------------------- | 910 @c ------------------------- |
900 @item | 911 @item |
901 Edit bounced messages (@ref{Editing Again}). | 912 Edit bounced messages (@pxref{Editing Again}). |
902 @c ------------------------- | 913 @c ------------------------- |
903 @item | 914 @item |
904 Send multimedia messages (@ref{Adding Attachments}). | 915 Send multimedia messages (@pxref{Adding Attachments}). |
905 @c ------------------------- | 916 @c ------------------------- |
906 @item | 917 @item |
907 Read HTML messages (@ref{HTML}). | 918 Read HTML messages (@pxref{HTML}). |
908 @c ------------------------- | 919 @c ------------------------- |
909 @item | 920 @item |
910 Use @ref{Aliases} and @ref{Identities}. | 921 Use aliases and identities (see @ref{Aliases}, @pxref{Identities}). |
911 @c ------------------------- | 922 @c ------------------------- |
912 @item | 923 @item |
913 Create different views of your mail (@ref{Threading} and @ref{Limits}). | 924 Create different views of your mail (see @ref{Threading}, @pxref{Limits}). |
914 @c ------------------------- | 925 @c ------------------------- |
915 @item | 926 @item |
916 Deal with junk mail (@ref{Junk}). | 927 Deal with junk mail (@pxref{Junk}). |
917 @c ------------------------- | 928 @c ------------------------- |
918 @item | 929 @item |
919 Handle signed and encrypted messages (@ref{Reading PGP} and | 930 Handle signed and encrypted messages (see @ref{Reading PGP}, |
920 @ref{Sending PGP}). | 931 @pxref{Sending PGP}). |
921 @c ------------------------- | 932 @c ------------------------- |
922 @item | 933 @item |
923 Process mail that was sent with @command{shar} or @command{uuencode} | 934 Process 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 |
927 Use sequences conveniently (@ref{Sequences}). | 938 Use sequences conveniently (@pxref{Sequences}). |
928 @c ------------------------- | 939 @c ------------------------- |
929 @item | 940 @item |
930 Use the @ref{Speedbar}, @ref{Tool Bar}, and @ref{Menu Bar}. | 941 Use the speedbar, tool bar, and menu bar (see @ref{Speedbar}, see @ref{Tool |
942 Bar}, @pxref{Menu Bar}). | |
931 @c ------------------------- | 943 @c ------------------------- |
932 @item | 944 @item |
933 Show header fields in different fonts (@ref{Reading Mail}). | 945 Show header fields in different fonts (@pxref{Reading Mail}). |
934 @c ------------------------- | 946 @c ------------------------- |
935 @item | 947 @item |
936 Find previously refiled messages (@ref{Searching}). | 948 Find previously refiled messages (@pxref{Searching}). |
937 @c ------------------------- | 949 @c ------------------------- |
938 @item | 950 @item |
939 Place messages in a file (@ref{Files and Pipes}). | 951 Place messages in a file (@pxref{Files and Pipes}). |
940 @end itemize | 952 @end itemize |
941 | 953 |
942 Remember that you can also use MH commands when you're not running | 954 Remember that you can also use MH commands when you're not running |
943 MH-E (and when you are!). | 955 MH-E (and when you are!). |
944 | 956 |
1063 printing, you would run @kbd{M-x customize-option @key{RET} | 1075 printing, you would run @kbd{M-x customize-option @key{RET} |
1064 mh-lpr-command-format @key{RET}}. In the buffer that appears, modify | 1076 mh-lpr-command-format @key{RET}}. In the buffer that appears, modify |
1065 the string to the right of the variable. For example, you may change | 1077 the string to the right of the variable. For example, you may change |
1066 the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then | 1078 the @command{lpr} command with @samp{nenscript -G -r -2 -i'%s'}. Then |
1067 use the @samp{State} combo box and select @samp{Save for Future | 1079 use the @samp{State} combo box and select @samp{Save for Future |
1068 Sessions}. @ref{Printing} talks more about this option. | 1080 Sessions}. 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 |
1072 Options can also hold boolean values. In Emacs Lisp, the boolean | 1085 Options can also hold boolean values. In Emacs Lisp, the boolean |
1073 values are @code{nil}, which means false, and @code{t}, which means | 1086 values are @code{nil}, which means false, and @code{t}, which means |
1082 default, which places the MH-Show buffer at the bottom of the buffer | 1095 default, which places the MH-Show buffer at the bottom of the buffer |
1083 stack. | 1096 stack. |
1084 | 1097 |
1085 The text usually says to turn on an option by setting it to a | 1098 The 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 |
1088 described in @ref{Viewing}). Other options, such as hooks, involve a | 1101 @code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as |
1089 little more Emacs Lisp programming expertise. | 1102 hooks, 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} |
1093 @findex customize-group | 1106 @findex customize-group |
1094 @findex mh-customize | 1107 @findex mh-customize |
1260 The following options in the @samp{mh-inc} customization group are | 1273 The following options in the @samp{mh-inc} customization group are |
1261 used. | 1274 used. |
1262 | 1275 |
1263 @vtable @code | 1276 @vtable @code |
1264 @item mh-inc-prog | 1277 @item mh-inc-prog |
1265 Program to incorporate mail (default: @samp{"inc"}). | 1278 Program to incorporate mail (default: @code{"inc"}). |
1266 @c ------------------------- | 1279 @c ------------------------- |
1267 @item mh-inc-spool-list | 1280 @item mh-inc-spool-list |
1268 Alternate spool files (default: @code{nil}). | 1281 Alternate spool files (default: @code{nil}). |
1269 @end vtable | 1282 @end vtable |
1270 | 1283 |
1304 @cindex MH commands, @command{inc} | 1317 @cindex MH commands, @command{inc} |
1305 @cindex incorporating | 1318 @cindex incorporating |
1306 @vindex mh-progs | 1319 @vindex mh-progs |
1307 | 1320 |
1308 The name of the program that incorporates new mail is stored in | 1321 The 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 |
1310 generates a one-line summary for each of the new messages. Unless it | 1323 generates a one-line summary for each of the new messages. Unless it |
1311 is an absolute pathname, the file is assumed to be in the | 1324 is 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 |
1313 a file to @command{inc} that uses a different format (see | 1326 a file to @command{inc} that uses a different format (see |
1314 @samp{mh-profile}(5), and sections | 1327 @samp{mh-profile}(5), and sections |
1712 On means non-reversible commands do not prompt for confirmation | 1725 On means non-reversible commands do not prompt for confirmation |
1713 (default: @samp{off}). | 1726 (default: @samp{off}). |
1714 @c ------------------------- | 1727 @c ------------------------- |
1715 @item mh-fetch-x-image-url | 1728 @item mh-fetch-x-image-url |
1716 Control fetching of @samp{X-Image-URL:} header field image (default: | 1729 Control 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 |
1720 On means graphical smileys are displayed (default: @samp{on}). | 1733 On means graphical smileys are displayed (default: @samp{on}). |
1721 @c ------------------------- | 1734 @c ------------------------- |
1722 @item mh-graphical-emphasis-flag | 1735 @item mh-graphical-emphasis-flag |
1731 @c ------------------------- | 1744 @c ------------------------- |
1732 @item mh-invisible-header-fields | 1745 @item mh-invisible-header-fields |
1733 Additional header fields to hide (default: @code{nil}). | 1746 Additional header fields to hide (default: @code{nil}). |
1734 @c ------------------------- | 1747 @c ------------------------- |
1735 @item mh-lpr-command-format | 1748 @item mh-lpr-command-format |
1736 Command used to print (default: @samp{"lpr -J '%s'"}). | 1749 Command 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 |
1739 Maximum inline image height if \"Content-Disposition:\" is not | 1752 Maximum inline image height if @samp{Content-Disposition:} is not |
1740 present (default: 0). | 1753 present (default: 0). |
1741 @c ------------------------- | 1754 @c ------------------------- |
1742 @item mh-max-inline-image-width | 1755 @item mh-max-inline-image-width |
1743 Maximum inline image width if \"Content-Disposition:\" is not | 1756 Maximum inline image width if @samp{Content-Disposition:} is not |
1744 present(default: 0). | 1757 present(default: 0). |
1745 @c ------------------------- | 1758 @c ------------------------- |
1746 @item mh-mhl-format-file | 1759 @item mh-mhl-format-file |
1747 Specifies the format file to pass to the @command{mhl} program | 1760 Specifies the format file to pass to the @command{mhl} program |
1748 (default: @samp{Use Default mhl Format (Printing Only)}). | 1761 (default: @samp{Use Default mhl Format (Printing Only)}). |
1752 @c ------------------------- | 1765 @c ------------------------- |
1753 @item mh-print-background-flag | 1766 @item mh-print-background-flag |
1754 On means messages should be printed in the background (default: | 1767 On 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 | |
1771 Format string to produce @code{mode-line-buffer-identification} for | |
1772 show buffers (default: @code{" @{show-%s@} %d"}). | |
1773 @c ------------------------- | |
1757 @item mh-show-maximum-size | 1774 @item mh-show-maximum-size |
1758 Maximum size of message (in bytes) to display automatically (default: | 1775 Maximum size of message (in bytes) to display automatically (default: |
1759 0). | 1776 0). |
1760 @c ------------------------- | 1777 @c ------------------------- |
1761 @item mh-show-use-xface-flag | 1778 @item mh-show-use-xface-flag |
1762 On means display face images in MH-Show buffers (default: @code{on}). | 1779 On 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 |
1765 Default directory for @kbd{X s} (default: @samp{Current}). | 1782 Default directory for @kbd{X s} (default: @samp{Current}). |
1766 @c ------------------------- | 1783 @c ------------------------- |
1767 @item mh-summary-height | 1784 @item mh-summary-height |
2072 @cindex vCard | 2089 @cindex vCard |
2073 @vindex mh-show-signature | 2090 @vindex mh-show-signature |
2074 | 2091 |
2075 MH-E normally renders signatures and vCards in italics so that the | 2092 MH-E normally renders signatures and vCards in italics so that the |
2076 body of the message stands out more. MH-E depends on the presence of | 2093 body of the message stands out more. MH-E depends on the presence of |
2077 the @dfn{signature separator} (@samp{"-- "}) to do this. You can also | 2094 the @dfn{signature separator} (@code{"-- "}) to do this. You can also |
2078 customize the face @code{mh-show-signature} so the appearance of the | 2095 customize the face @code{mh-show-signature} so the appearance of the |
2079 signature block is more to your liking. | 2096 signature block is more to your liking. |
2080 | 2097 |
2081 @vindex mh-show-hook | 2098 @vindex mh-show-hook |
2082 @vindex mh-show-mode-hook | 2099 @vindex mh-show-mode-hook |
2096 For those who like to modify their mode lines, use | 2113 For those who like to modify their mode lines, use |
2097 @code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in | 2114 @code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in |
2098 the MH-Show buffers. Place the two escape strings @samp{%s} and | 2115 the 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, |
2100 respectively, somewhere in the string in that order. The default value | 2117 respectively, somewhere in the string in that order. The default value |
2101 of @samp{"@{show-%s@} %d"} yields a mode line of | 2118 of @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-------------------------------- |
2105 @end smallexample | 2122 @end smallexample |
2106 | 2123 |
2342 | 2359 |
2343 @example | 2360 @example |
2344 [1. text/html; foo.html]... | 2361 [1. text/html; foo.html]... |
2345 @end example | 2362 @end example |
2346 | 2363 |
2347 See @ref{Viewing Attachments} to see how to read the contents of this | 2364 To see how to read the contents of this body part, see @ref{Viewing |
2348 body part. | 2365 Attachments}. |
2349 | 2366 |
2350 The browser that MH-E uses is determined by the option | 2367 The 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 |
2352 based upon the presence of a known browser on your system. If you wish | 2369 based upon the presence of a known browser on your system. If you wish |
2353 to use a different browser, then set this option accordingly. See the | 2370 to use a different browser, then set this option accordingly. See the |
2683 The command @kbd{P l} uses two options. The option | 2700 The command @kbd{P l} uses two options. The option |
2684 @code{mh-lpr-command-format} contains the Unix command line which | 2701 @code{mh-lpr-command-format} contains the Unix command line which |
2685 performs the actual printing. The string can contain one escape, | 2702 performs 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 |
2687 number and is useful for print job names. The default setting is | 2704 number 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 |
2690 fits within my printer's margins. Normally messages are printed in the | 2707 fits within my printer's margins. Normally messages are printed in the |
2691 foreground. If this is slow on your system, you may elect to turn on | 2708 foreground. If this is slow on your system, you may elect to turn on |
2692 the option @code{mh-print-background-flag} to print in the background. | 2709 the option @code{mh-print-background-flag} to print in the background. |
2693 If you do this, do not delete the message until it is printed or else | 2710 If you do this, do not delete the message until it is printed or else |
3268 be prompted to create it. The hook @code{mh-refile-msg-hook} is called | 3285 be prompted to create it. The hook @code{mh-refile-msg-hook} is called |
3269 after a message is marked to be refiled. | 3286 after a message is marked to be refiled. |
3270 | 3287 |
3271 If you are refiling several messages into the same folder, you can use | 3288 If you are refiling several messages into the same folder, you can use |
3272 the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the | 3289 the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the |
3273 last refile or write (see the description of @kbd{>} | 3290 last 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 |
3275 range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob | 3292 range 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 |
3278 @cindex expunging refiles and deletes | 3295 @cindex expunging refiles and deletes |
3279 @cindex undoing refiles and deletes | 3296 @cindex undoing refiles and deletes |
3614 @item mh-compose-prompt-flag | 3631 @item mh-compose-prompt-flag |
3615 On means prompt for header fields when composing a new draft (default: | 3632 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 |
3619 Format string for forwarded message subject (default: @samp{"%s: | 3636 Format 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 |
3623 On means append an @samp{X-Mailer:} header field to the header | 3640 On means append an @samp{X-Mailer:} header field to the header |
3624 (default: @samp{on}). | 3641 (default: @samp{on}). |
3690 @findex mh-send | 3707 @findex mh-send |
3691 @kindex m | 3708 @kindex m |
3692 | 3709 |
3693 From within a MH-Folder buffer, you can simply use the command @kbd{m} | 3710 From 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 |
3695 appears in an Emacs buffer whose mode is MH-Letter (see the Figure in | 3712 appears 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 | 3713 buffer looks like, @pxref{Sending Mail Tour}). MH-Letter mode allows |
3697 mode allows you to edit your message, to check the validity of the | 3714 you to edit your message, to check the validity of the recipients, to |
3698 recipients, to insert attachments and other messages into your | 3715 insert attachments and other messages into your message, and to send |
3699 message, and to send the message. We'll go more into depth about | 3716 the message. We'll go more into depth about editing a |
3700 editing 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 | 3718 folder} so that you can edit several drafts in parallel. To do so, |
3702 do so, create a folder named @samp{+drafts} for example, and add the | 3719 create a folder named @samp{+drafts} for example, and add the profile |
3703 profile component @samp{Draft-Folder: drafts} (see | 3720 component @samp{Draft-Folder: drafts} (see @code{mh-profile}(5)).} (a |
3704 @code{mh-profile}(5)).} (a message you're composing) in just a moment | 3721 message 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 |
3709 If you prefer to be prompted for the recipient and subject fields | 3725 If you prefer to be prompted for the recipient and subject fields |
3710 before the MH-Letter buffer appears, turn on the option | 3726 before the MH-Letter buffer appears, turn on the option |
3910 The format of the @samp{Subject:} header field for forwarded messages | 3926 The format of the @samp{Subject:} header field for forwarded messages |
3911 is controlled by the option @code{mh-forward-subject-format}. This | 3927 is controlled by the option @code{mh-forward-subject-format}. This |
3912 option is a string which includes two escapes (@samp{%s}). The first | 3928 option 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 |
3914 second one is replaced with the original @samp{Subject:}. The default | 3930 second one is replaced with the original @samp{Subject:}. The default |
3915 value of @samp{"%s: %s"} takes a message with the header: | 3931 value of @code{"%s: %s"} takes a message with the header: |
3916 | 3932 |
3917 @smallexample | 3933 @smallexample |
3918 @group | 3934 @group |
3919 To: Bill Wohler <wohler@@stop.mail-abuse.org> | 3935 To: Bill Wohler <wohler@@stop.mail-abuse.org> |
3920 Subject: Re: 49er football | 3936 Subject: Re: 49er football |
4308 @item mh-delete-yanked-msg-window-flag | 4324 @item mh-delete-yanked-msg-window-flag |
4309 On means delete any window displaying the message (default: @samp{off}). | 4325 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 |
4312 Verb to use for attribution when a message is yanked by @kbd{C-c C-y} | 4328 Verb 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 |
4316 String to put before each line of a yanked or inserted message | 4332 String 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 |
4320 Function to call when completing outside of address or folder fields | 4336 Function to call when completing outside of address or folder fields |
4321 (default: @code{ispell-complete-word}). | 4337 (default: @code{ispell-complete-word}). |
4322 @c ------------------------- | 4338 @c ------------------------- |
4326 @item mh-mml-method-default | 4342 @item mh-mml-method-default |
4327 Default method to use in security tags (default: @samp{PGP (MIME)} if | 4343 Default method to use in security tags (default: @samp{PGP (MIME)} if |
4328 support for it is available; otherwise @samp{None}). | 4344 support for it is available; otherwise @samp{None}). |
4329 @c ------------------------- | 4345 @c ------------------------- |
4330 @item mh-signature-file-name | 4346 @item mh-signature-file-name |
4331 Source of user's signature (default: @samp{"~/.signature"}). | 4347 Source of user's signature (default: @code{"~/.signature"}). |
4332 @c ------------------------- | 4348 @c ------------------------- |
4333 @item mh-signature-separator-flag | 4349 @item mh-signature-separator-flag |
4334 On means a signature separator should be inserted (default: | 4350 On means a signature separator should be inserted (default: |
4335 @samp{on}). | 4351 @samp{on}). |
4336 @c ------------------------- | 4352 @c ------------------------- |
4337 @item mh-x-face-file | 4353 @item mh-x-face-file |
4338 File containing X-Face or Face header field to insert in outgoing mail. | 4354 File 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 |
4342 Controls which part of a message is yanked by @kbd{C-c C-y} (default: | 4358 Controls which part of a message is yanked by @kbd{C-c C-y} (default: |
4343 @samp{Body With Attribution}). | 4359 @samp{Body With Attribution}). |
4344 @end vtable | 4360 @end vtable |
4592 @samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use | 4608 @samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use |
4593 the @samp{Custom String} menu item to enter your own verb. | 4609 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 |
4597 The prefix @samp{"> "} is the default setting for the option | 4613 The 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 |
4599 since it is used by many mailers and news readers: messages are far | 4615 since it is used by many mailers and news readers: messages are far |
4600 easier to read if several included messages have all been indented by | 4616 easier to read if several included messages have all been indented by |
4601 the same string. This prefix is not inserted if you use one of the | 4617 the same string. This prefix is not inserted if you use one of the |
4602 supercite flavors of @code{mh-yank-behavior} or you have added a | 4618 supercite flavors of @code{mh-yank-behavior} or you have added a |
4725 if the buffer contains a separator, may be useful as well. | 4741 if the buffer contains a separator, may be useful as well. |
4726 | 4742 |
4727 @cindex signature separator | 4743 @cindex signature separator |
4728 @vindex mh-signature-separator-flag | 4744 @vindex mh-signature-separator-flag |
4729 | 4745 |
4730 A signature separator (@samp{"-- "}) will be added if the signature | 4746 A signature separator (@code{"-- "}) will be added if the signature |
4731 block does not contain one and @code{mh-signature-separator-flag} is | 4747 block does not contain one and @code{mh-signature-separator-flag} is |
4732 on. It is not recommended that you change this option since various | 4748 on. It is not recommended that you change this option since various |
4733 mail user agents, including MH-E, use the separator to present the | 4749 mail user agents, including MH-E, use the separator to present the |
4734 signature differently, and to suppress the signature when replying or | 4750 signature differently, and to suppress the signature when replying or |
4735 yanking a letter into a draft. | 4751 yanking a letter into a draft. |
5348 If @samp{on}, local users are added to alias completion (default: | 5364 If @samp{on}, local users are added to alias completion (default: |
5349 @samp{on}). | 5365 @samp{on}). |
5350 @c ------------------------- | 5366 @c ------------------------- |
5351 @item mh-alias-local-users-prefix | 5367 @item mh-alias-local-users-prefix |
5352 String prefixed to the real names of users from the password file | 5368 String 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 |
5356 On means the GECOS field in the password file uses a comma separator | 5372 On means the GECOS field in the password file uses a comma separator |
5357 (default: @samp{on}). | 5373 (default: @samp{on}). |
5358 @end vtable | 5374 @end vtable |
5989 controls the placement of the tool bar along the four edges of the | 6005 controls the placement of the tool bar along the four edges of the |
5990 frame. You can choose from one of @samp{Same As Default Tool Bar}, | 6006 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 |
5992 variable is set to anything other than @samp{Same As Default Tool Bar} | 6008 variable is set to anything other than @samp{Same As Default Tool Bar} |
5993 and the default tool bar is in a different location, then two tool | 6009 and the default tool bar is in a different location, then two tool |
5994 bars will be displayed: the MH-E tool bar and the default tool bar." | 6010 bars 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 |
5998 | 6014 |
5999 @cindex searching | 6015 @cindex searching |
7057 works best for you. | 7073 works best for you. |
7058 | 7074 |
7059 First, run @samp{spamassassin -t} on every mail message in your | 7075 First, run @samp{spamassassin -t} on every mail message in your |
7060 archive and use @command{gnumeric} to verify that the average plus the | 7076 archive and use @command{gnumeric} to verify that the average plus the |
7061 standard deviation of good mail is under 5, the SpamAssassin default | 7077 standard deviation of good mail is under 5, the SpamAssassin default |
7062 for "spam". | 7078 for ``spam''. |
7063 | 7079 |
7064 Using @command{gnumeric}, sort the messages by score and view the | 7080 Using @command{gnumeric}, sort the messages by score and view the |
7065 messages with the highest score. Determine the score which encompasses | 7081 messages with the highest score. Determine the score which encompasses |
7066 all of your interesting messages and add a couple of points to be | 7082 all of your interesting messages and add a couple of points to be |
7067 conservative. Add that many dots to the @samp{X-Spam-Level:} header | 7083 conservative. Add that many dots to the @samp{X-Spam-Level:} header |
7368 @item mh-scan-format-file | 7384 @item mh-scan-format-file |
7369 Specifies the format file to pass to the scan program (default: | 7385 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 |
7373 Program used to scan messages (default: @samp{"scan"}). | 7389 Program 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 |
7377 @vindex mh-adaptive-cmd-note-flag | 7393 @vindex mh-adaptive-cmd-note-flag |
7378 @vindex mh-scan-format-file | 7394 @vindex mh-scan-format-file |
7457 @cindex MH commands, @command{scan} | 7473 @cindex MH commands, @command{scan} |
7458 @vindex mh-progs | 7474 @vindex mh-progs |
7459 @vindex mh-scan-prog | 7475 @vindex mh-scan-prog |
7460 | 7476 |
7461 The name of the program that generates a listing of one line per | 7477 The name of the program that generates a listing of one line per |
7462 message is held in @code{mh-scan-prog} (default: @samp{"scan"}). | 7478 message is held in @code{mh-scan-prog} (default: @code{"scan"}). |
7463 Unless this variable contains an absolute pathname, it is assumed to | 7479 Unless this variable contains an absolute pathname, it is assumed to |
7464 be in the @code{mh-progs} directory (@pxref{Getting Started}). You may | 7480 be in the @code{mh-progs} directory (@pxref{Getting Started}). You may |
7465 link another program to @command{scan} (see @samp{mh-profile}(5)) to | 7481 link another program to @command{scan} (see @samp{mh-profile}(5)) to |
7466 produce a different type of listing@footnote{See the section | 7482 produce a different type of listing@footnote{See the section |
7467 @uref{@value{MH-BOOK-HOME}/faswsprs.htm, Find and Specify with scan | 7483 @uref{@value{MH-BOOK-HOME}/faswsprs.htm, Find and Specify with scan |
7469 | 7485 |
7470 @cindex regular expressions, scan line formats | 7486 @cindex regular expressions, scan line formats |
7471 | 7487 |
7472 If you change the format of the scan lines you'll need to tell MH-E | 7488 If you change the format of the scan lines you'll need to tell MH-E |
7473 how to parse the new format. As you will see, quite a lot of variables | 7489 how to parse the new format. As you will see, quite a lot of variables |
7474 are involved to do that. Use @samp{M-x apropos @key{RET} mh-scan.*regexp'} | 7490 are involved to do that. Use @samp{M-x apropos @key{RET} |
7475 to obtain a list of these variables. You will also have to call | 7491 mh-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 | 7492 will also have to call @code{mh-set-cmd-note} if your notations are |
7477 in Emacs start with 0). Note that unlike most of the user options | 7493 not in column 4 (columns in Emacs start with 0). Note that unlike most |
7478 described in this manual, these are variables and must be set with | 7494 of the user options described in this manual, these are variables and |
7479 @code{setq} instead of in a customization buffer. For help with | 7495 must be set with @code{setq} instead of in a customization buffer. For |
7480 regular expressions, see | 7496 help 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 |
7483 GNU Emacs Manual} | 7499 GNU Emacs Manual}. |
7484 @end ifnothtml | 7500 @end ifnothtml |
7485 @ifhtml | 7501 @ifhtml |
7486 the section | 7502 section |
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, |
7488 Syntax of Regular Expressions} in | 7504 Syntax of Regular Expressions} in @cite{The GNU Emacs Manual}. |
7489 @cite{The GNU Emacs Manual}). | |
7490 @end ifhtml | 7505 @end ifhtml |
7491 | 7506 |
7492 The first variable has to do with pruning out garbage. | 7507 The first variable has to do with pruning out garbage. |
7493 | 7508 |
7494 @vtable @code | 7509 @vtable @code |
7499 @item mh-scan-valid-regexp | 7514 @item mh-scan-valid-regexp |
7500 This regular expression describes a valid scan line. This is used to | 7515 This regular expression describes a valid scan line. This is used to |
7501 eliminate error messages that are occasionally produced by | 7516 eliminate 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 |
7504 prev} in the MH book.} or @command{scan} (default: @samp{"^ *[0-9]"}). | 7519 prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}). |
7505 @end vtable | 7520 @end vtable |
7506 | 7521 |
7507 Next, many variables control how the scan lines are parsed. | 7522 Next, many variables control how the scan lines are parsed. |
7508 | 7523 |
7509 @vindex mh-folder-font-lock-keywords | 7524 @vindex mh-folder-font-lock-keywords |
7514 @item mh-scan-body-regexp | 7529 @item mh-scan-body-regexp |
7515 This regular expression matches the message body fragment. Note that | 7530 This regular expression matches the message body fragment. Note that |
7516 the default setting of @code{mh-folder-font-lock-keywords} expects | 7531 the default setting of @code{mh-folder-font-lock-keywords} expects |
7517 this expression to contain at least one parenthesized expression which | 7532 this expression to contain at least one parenthesized expression which |
7518 matches the body text as in the default of | 7533 matches 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 |
7520 correct, the body fragment will not be highlighted with the face | 7535 correct, the body fragment will not be highlighted with the face |
7521 @code{mh-folder-body}. | 7536 @code{mh-folder-body}. |
7522 @c ------------------------- | 7537 @c ------------------------- |
7523 @vindex mh-folder-cur-msg-number | 7538 @vindex mh-folder-cur-msg-number |
7524 @vindex mh-folder-font-lock-keywords | 7539 @vindex mh-folder-font-lock-keywords |
7526 @item mh-scan-cur-msg-number-regexp | 7541 @item mh-scan-cur-msg-number-regexp |
7527 This regular expression matches the current message. It must match | 7542 This regular expression matches the current message. It must match |
7528 from the beginning of the line. Note that the default setting of | 7543 from 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 |
7530 at least one parenthesized expression which matches the message number | 7545 at least one parenthesized expression which matches the message number |
7531 as in the default of @w{@samp{"^\\( *[0-9]+\\+\\).*"}}. This | 7546 as in the default of @w{@code{"^\\( *[0-9]+\\+\\).*"}}. This |
7532 expression includes the leading space and current message marker | 7547 expression 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 |
7534 these items as well. The highlighting is done with the face | 7549 these items as well. The highlighting is done with the face |
7535 @code{mh-folder-cur-msg-number}. This regular expression should be | 7550 @code{mh-folder-cur-msg-number}. This regular expression should be |
7536 correct as it is needed by non-fontification functions. See also | 7551 correct as it is needed by non-fontification functions. See also |
7543 This regular expression matches a valid date. It must @strong{not} be | 7558 This regular expression matches a valid date. It must @strong{not} be |
7544 anchored to the beginning or the end of the line. Note that the | 7559 anchored to the beginning or the end of the line. Note that the |
7545 default setting of @code{mh-folder-font-lock-keywords} expects this | 7560 default setting of @code{mh-folder-font-lock-keywords} expects this |
7546 expression to contain only one parenthesized expression which matches | 7561 expression to contain only one parenthesized expression which matches |
7547 the date field as in the default of | 7562 the 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 |
7549 not correct, the date will not be highlighted with the face | 7564 not correct, the date will not be highlighted with the face |
7550 @code{mh-folder-date}. | 7565 @code{mh-folder-date}. |
7551 @c ------------------------- | 7566 @c ------------------------- |
7552 @vindex mh-folder-deleted | 7567 @vindex mh-folder-deleted |
7553 @vindex mh-folder-font-lock-keywords | 7568 @vindex mh-folder-font-lock-keywords |
7555 @item mh-scan-deleted-msg-regexp | 7570 @item mh-scan-deleted-msg-regexp |
7556 This regular expression matches deleted messages. It must match from | 7571 This regular expression matches deleted messages. It must match from |
7557 the beginning of the line. Note that the default setting of | 7572 the 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 |
7559 at least one parenthesized expression which matches the message number | 7574 at least one parenthesized expression which matches the message number |
7560 as in the default of @samp{"^\\( *[0-9]+\\)D"}. This expression | 7575 as in the default of @code{"^\\( *[0-9]+\\)D"}. This expression |
7561 includes the leading space within the parenthesis since it looks | 7576 includes the leading space within the parenthesis since it looks |
7562 better to highlight it as well. The highlighting is done with the face | 7577 better 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 |
7564 it is needed by non-fontification functions. See also | 7579 it is needed by non-fontification functions. See also |
7565 @code{mh-note-deleted}. | 7580 @code{mh-note-deleted}. |
7569 @item mh-scan-good-msg-regexp | 7584 @item mh-scan-good-msg-regexp |
7570 This regular expression matches ``good'' messages. It must match from | 7585 This regular expression matches ``good'' messages. It must match from |
7571 the beginning of the line. Note that the default setting of | 7586 the 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 |
7573 at least one parenthesized expression which matches the message number | 7588 at least one parenthesized expression which matches the message number |
7574 as in the default of @w{@samp{"^\\( *[0-9]+\\)[^D^0-9]"}}. This | 7589 as in the default of @w{@code{"^\\( *[0-9]+\\)[^D^0-9]"}}. This |
7575 expression includes the leading space within the parenthesis since it | 7590 expression includes the leading space within the parenthesis since it |
7576 looks better to highlight it as well. The highlighting is done with | 7591 looks better to highlight it as well. The highlighting is done with |
7577 the face @code{mh-folder-msg-number}. This regular expression should | 7592 the face @code{mh-folder-msg-number}. This regular expression should |
7578 be correct as it is needed by non-fontification functions. | 7593 be correct as it is needed by non-fontification functions. |
7579 @c ------------------------- | 7594 @c ------------------------- |
7580 @vindex mh-scan-format-file | 7595 @vindex mh-scan-format-file |
7581 @item mh-scan-msg-format-regexp | 7596 @item mh-scan-msg-format-regexp |
7582 This regular expression finds the message number width in a scan | 7597 This regular expression finds the message number width in a scan |
7583 format. Note that the message number must be placed in a parenthesized | 7598 format. Note that the message number must be placed in a parenthesized |
7584 expression as in the default of @samp{"%\\([0-9]*\\)(msg)"}. This | 7599 expression as in the default of @code{"%\\([0-9]*\\)(msg)"}. This |
7585 variable is only consulted if @code{mh-scan-format-file} is set to | 7600 variable 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 ------------------------- |
7588 @vindex mh-scan-format-file | 7603 @vindex mh-scan-format-file |
7589 @item mh-scan-msg-format-string | 7604 @item mh-scan-msg-format-string |
7590 This is a format string for the width of the message number in a scan | 7605 This is a format string for the width of the message number in a scan |
7591 format. Use @samp{0%d} for zero-filled message numbers. This variable | 7606 format. Use @samp{0%d} for zero-filled message numbers. This variable |
7592 is only consulted if @code{mh-scan-format-file} is set to @samp{Use | 7607 is only consulted if @code{mh-scan-format-file} is set to @samp{Use |
7593 MH-E scan Format} (default: @samp{"%d"}). | 7608 MH-E scan Format} (default: @code{"%d"}). |
7594 @c ------------------------- | 7609 @c ------------------------- |
7595 @item mh-scan-msg-number-regexp | 7610 @item mh-scan-msg-number-regexp |
7596 This regular expression extracts the message number. It must match | 7611 This regular expression extracts the message number. It must match |
7597 from the beginning of the line. Note that the message number must be | 7612 from the beginning of the line. Note that the message number must be |
7598 placed in a parenthesized expression as in the default of @w{@samp{"^ | 7613 placed 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 |
7602 This regular expression matches overflowed message numbers (default: | 7617 This 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 |
7606 This regular expression matches a particular message. It is a format | 7621 This regular expression matches a particular message. It is a format |
7607 string; use @samp{%d} to represent the location of the message number | 7622 string; use @samp{%d} to represent the location of the message number |
7608 within the expression as in the default of @samp{"^[^0-9]*%d[^0-9]"}. | 7623 within 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 |
7612 @vindex mh-folder-to | 7627 @vindex mh-folder-to |
7613 @item mh-scan-rcpt-regexp | 7628 @item mh-scan-rcpt-regexp |
7614 This regular expression specifies the recipient in messages you sent. | 7629 This regular expression specifies the recipient in messages you sent. |
7615 Note that the default setting of @code{mh-folder-font-lock-keywords} | 7630 Note that the default setting of @code{mh-folder-font-lock-keywords} |
7616 expects this expression to contain two parenthesized expressions. The | 7631 expects this expression to contain two parenthesized expressions. The |
7617 first is expected to match the @samp{To:} that the default scan format | 7632 first is expected to match the @samp{To:} that the default scan format |
7618 file generates. The second is expected to match the recipient's name | 7633 file generates. The second is expected to match the recipient's name |
7619 as in the default of @samp{"\\(To:\\)\\(..............\\)"}. If this | 7634 as in the default of @code{"\\(To:\\)\\(..............\\)"}. If this |
7620 regular expression is not correct, the @samp{To:} string will not be | 7635 regular expression is not correct, the @samp{To:} string will not be |
7621 highlighted with the face @code{mh-folder-to} and the recipient will not be | 7636 highlighted with the face @code{mh-folder-to} and the recipient will not be |
7622 highlighted with the face @code{mh-folder-address}. | 7637 highlighted with the face @code{mh-folder-address}. |
7623 @c ------------------------- | 7638 @c ------------------------- |
7624 @vindex mh-folder-font-lock-keywords | 7639 @vindex mh-folder-font-lock-keywords |
7627 @item mh-scan-refiled-msg-regexp | 7642 @item mh-scan-refiled-msg-regexp |
7628 This regular expression matches refiled messages. It must match from | 7643 This regular expression matches refiled messages. It must match from |
7629 the beginning of the line. Note that the default setting of | 7644 the 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 |
7631 at least one parenthesized expression which matches the message number | 7646 at least one parenthesized expression which matches the message number |
7632 as in the default of @w{@samp{"^\\( *[0-9]+\\)\\^"}}. This expression | 7647 as in the default of @w{@code{"^\\( *[0-9]+\\)\\^"}}. This expression |
7633 includes the leading space within the parenthesis since it looks | 7648 includes the leading space within the parenthesis since it looks |
7634 better to highlight it as well. The highlighting is done with the face | 7649 better 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 |
7636 it is needed by non-fontification functions. See also | 7651 it is needed by non-fontification functions. See also |
7637 @code{mh-note-refiled}. | 7652 @code{mh-note-refiled}. |
7645 default setting of @code{mh-folder-font-lock-keywords} expects this | 7660 default setting of @code{mh-folder-font-lock-keywords} expects this |
7646 expression to contain at least two parenthesized expressions. The | 7661 expression to contain at least two parenthesized expressions. The |
7647 first should match the fontification hint (see | 7662 first 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 |
7649 as in the default of | 7664 as in the default of |
7650 @w{@samp{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}. | 7665 @w{@code{"^ *[0-9]+.\\([bct]\\).....[ ]*\\(..................\\)"}}. |
7651 If this regular expression is not correct, the notation hints will not | 7666 If this regular expression is not correct, the notation hints will not |
7652 be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and | 7667 be highlighted with the face @code{mh-mh-folder-sent-to-me-hint} and |
7653 the sender will not be highlighted with the face | 7668 the sender will not be highlighted with the face |
7654 @code{mh-folder-sent-to-me-sender}. | 7669 @code{mh-folder-sent-to-me-sender}. |
7655 @c ------------------------- | 7670 @c ------------------------- |
7665 @code{mh-folder-followup}. The second matches an optional bracketed | 7680 @code{mh-folder-followup}. The second matches an optional bracketed |
7666 number after @samp{Re:}, such as in @samp{Re[2]:} (and is thus a | 7681 number after @samp{Re:}, such as in @samp{Re[2]:} (and is thus a |
7667 sub-expression of the first expression). The third is expected to | 7682 sub-expression of the first expression). The third is expected to |
7668 match the subject line itself which is highlighted with the face | 7683 match 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]*\\)"}}. |
7672 This regular expression should be correct as it is needed by | 7687 This regular expression should be correct as it is needed by |
7673 non-fontification functions. Note that this example is broken up on | 7688 non-fontification functions. Note that this example is broken up on |
7674 two lines for readability, but is actually a single string. | 7689 two lines for readability, but is actually a single string. |
7675 @end vtable | 7690 @end vtable |
7676 | 7691 |
7685 variables contain the notational characters. Note that columns in | 7700 variables contain the notational characters. Note that columns in |
7686 Emacs start with 0. | 7701 Emacs start with 0. |
7687 @c ------------------------- | 7702 @c ------------------------- |
7688 @item mh-note-copied | 7703 @item mh-note-copied |
7689 Messages that have been copied are marked by this character (default: | 7704 Messages 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 |
7693 The current message (in MH, not in MH-E) is marked by this character | 7708 The 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 |
7697 Messages that have been deleted are marked by this character (default: | 7712 Messages 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 |
7701 Messages that have been redistributed are marked by this character | 7716 Messages 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 |
7705 Messages that have been forwarded are marked by this character | 7720 Messages 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 |
7709 Messages that have been printed are marked by this character (default: | 7724 Messages 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 |
7713 Messages that have been refiled are marked by this character (default: | 7728 Messages 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 |
7717 Messages that have been replied to are marked by this character | 7732 Messages 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 |
7721 Messages in a user-defined sequence are marked by this character | 7736 Messages 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 |
7723 marked by this character as well. | 7738 marked by this character as well. |
7724 @end vtable | 7739 @end vtable |
7725 | 7740 |
7726 For example, let's say I have the following in @file{scan.format} | 7741 For example, let's say I have the following in @file{scan.format} |
7727 which displays the sender, the subject, and the message number. This | 7742 which displays the sender, the subject, and the message number. This |