aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBill Wohler2006-03-15 00:26:12 +0000
committerBill Wohler2006-03-15 00:26:12 +0000
commit10e495e4f3edbfd71e32150bf71916945195d269 (patch)
tree4f12453f09bf2d43e8c54d4b2e199a6428001bcb
parentc167547bc3fde196a82f5afb21509a4112e582d7 (diff)
downloademacs-10e495e4f3edbfd71e32150bf71916945195d269.tar.gz
emacs-10e495e4f3edbfd71e32150bf71916945195d269.zip
Add index entries around each paragraph rather than depend on entries
from beginning of node. Doing so ensures that index entries are less likely to be forgotten if text is cut and pasted, and are necessary anyway if the references are on a separate page. It seems that makeinfo is now (v. 4.8) only producing one index entry per node, so there is no longer any excuse not to. Use subheading instead of heading. The incorrect use of heading produced very large fonts in Info--as large as the main heading. (From Bill Wohler): MH-E never did appear in Emacs 21--MH-E versions 6 and 7 appeared *around* the time of these Emacs releases.
-rw-r--r--man/ChangeLog15
-rw-r--r--man/mh-e.texi873
2 files changed, 724 insertions, 164 deletions
diff --git a/man/ChangeLog b/man/ChangeLog
index 35815e228a1..7eddcae6b5e 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,18 @@
12006-03-14 Bill Wohler <wohler@newt.com>
2
3 * mh-e.texi: Add index entries around each paragraph rather than
4 depend on entries from beginning of node. Doing so ensures that
5 index entries are less likely to be forgotten if text is cut and
6 pasted, and are necessary anyway if the references are on a
7 separate page. It seems that makeinfo is now (v. 4.8) only
8 producing one index entry per node, so there is no longer any
9 excuse not to. Use subheading instead of heading. The incorrect
10 use of heading produced very large fonts in Info--as large as the
11 main heading.
12 (From Bill Wohler): MH-E never did appear in Emacs 21--MH-E
13 versions 6 and 7 appeared *around* the time of these Emacs
14 releases.
15
12006-03-13 Carsten Dominik <dominik@science.uva.nl> 162006-03-13 Carsten Dominik <dominik@science.uva.nl>
2 17
3 * org.texi (Clean view): Document new startup options. 18 * org.texi (Clean view): Document new startup options.
diff --git a/man/mh-e.texi b/man/mh-e.texi
index 7e29fa297a8..be1d61d930c 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+cvs 11@set VERSION 7.93
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 , 3rd Edition
15@set UPDATED 2006-03-11 15@set UPDATED 2006-03-14
16@set UPDATE-MONTH March, 2006 16@set UPDATE-MONTH March, 2006
17 17
18@c Other variables. 18@c Other variables.
@@ -203,6 +203,7 @@ History of MH-E
203 203
204@cindex Emacs 204@cindex Emacs
205@cindex Unix commands, Emacs 205@cindex Unix commands, Emacs
206@cindex preface
206 207
207This manual introduces another interface to the MH mail system that is 208This manual introduces another interface to the MH mail system that is
208accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is 209accessible through the GNU Emacs editor, namely, @emph{MH-E}. MH-E is
@@ -221,6 +222,9 @@ shouldn't have to do anything special to use it. This manual covers
221MH-E version @value{VERSION}. To help you decide which version you 222MH-E version @value{VERSION}. To help you decide which version you
222have, see @ref{Getting Started}. 223have, see @ref{Getting Started}.
223 224
225@findex help-with-tutorial
226@kindex C-h t
227
224If you don't already use GNU Emacs but want to learn more, you can 228If 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} 229read an online tutorial by starting GNU Emacs and typing @kbd{C-h t}
226(@code{help-with-tutorial}). (To learn about this notation, see 230(@code{help-with-tutorial}). (To learn about this notation, see
@@ -241,10 +245,13 @@ If more information is needed, you can go to the Unix manual pages of
241the individual MH commands. When the name is not obvious, I'll guide 245the individual MH commands. When the name is not obvious, I'll guide
242you to a relevant MH manual page that describes the action more fully. 246you to a relevant MH manual page that describes the action more fully.
243 247
248@cindex info
249@kindex C-h i
250
244This manual is available in both Info and online formats. The Info 251This manual is available in both Info and online formats. The Info
245version is distributed with Emacs and can be accessed with the 252version is distributed with Emacs and can be accessed with the
246@command{info} command (@samp{info mh-e}) or within Emacs (@kbd{M-x 253@command{info} command (@samp{info mh-e}) or within Emacs (@kbd{C-h i
247info @key{RET} m mh-e @key{RET}}). The online version is available at 254m mh-e @key{RET}}). The online version is available at
248@uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great 255@uref{http://mh-e.sourceforge.net/manual/, SourceForge}. Another great
249online resource is the book @uref{http://www.ics.uci.edu/~mh/book/, 256online resource is the book @uref{http://www.ics.uci.edu/~mh/book/,
250@cite{MH & nmh: Email for Users & Programmers}} (also known as 257@cite{MH & nmh: Email for Users & Programmers}} (also known as
@@ -265,8 +272,11 @@ Bill Wohler <@i{wohler at newt.com}>@*
265@chapter GNU Emacs Terms and Conventions 272@chapter GNU Emacs Terms and Conventions
266 273
267@cindex Emacs 274@cindex Emacs
268@cindex Emacs, terms and conventions 275@cindex Emacs, conventions
276@cindex Emacs, terms
269@cindex Unix commands, Emacs 277@cindex Unix commands, Emacs
278@cindex conventions, Emacs
279@cindex terms, Emacs
270 280
271If you're an experienced Emacs user, you can skip the following 281If you're an experienced Emacs user, you can skip the following
272conventions and definition of terms and go directly to the next 282conventions and definition of terms and go directly to the next
@@ -325,6 +335,7 @@ earlier of Emacs, you will need to use the @key{DEL} key.}.
325 335
326@cindex Emacs, prefix argument 336@cindex Emacs, prefix argument
327@cindex prefix argument 337@cindex prefix argument
338@kindex C-u
328 339
329A @dfn{prefix argument} allows you to pass an argument to any Emacs 340A @dfn{prefix argument} allows you to pass an argument to any Emacs
330function. To pass an argument, type @kbd{C-u} before the Emacs command 341function. To pass an argument, type @kbd{C-u} before the Emacs command
@@ -348,8 +359,11 @@ numerical argument before entering the command.
348@end quotation 359@end quotation
349@sp 1 360@sp 1
350 361
362@cindex @file{.emacs}
351@cindex Emacs, variables 363@cindex Emacs, variables
364@cindex files, @file{.emacs}
352@cindex variables 365@cindex variables
366@findex setq
353 367
354Emacs uses @dfn{variables} to hold values. These can be changed via 368Emacs uses @dfn{variables} to hold values. These can be changed via
355calls to the function @code{setq} in @file{~/.emacs}. 369calls to the function @code{setq} in @file{~/.emacs}.
@@ -392,9 +406,11 @@ See section
392Face Customization} in @cite{The GNU Emacs Manual}. 406Face Customization} in @cite{The GNU Emacs Manual}.
393@end ifhtml 407@end ifhtml
394 408
409@cindex abnormal hooks
395@cindex hooks 410@cindex hooks
396@cindex normal hooks 411@cindex normal hooks
397@cindex abnormal hooks 412@findex add-hook
413@findex customize-option
398 414
399Commands often offer @dfn{hooks} which enable you to extend or modify 415Commands often offer @dfn{hooks} which enable you to extend or modify
400the way a command works. 416the way a command works.
@@ -409,10 +425,11 @@ Hooks} in @cite{The GNU Emacs Manual}
409@end ifhtml 425@end ifhtml
410for a description about @dfn{normal hooks} and @dfn{abnormal hooks}. 426for a description about @dfn{normal hooks} and @dfn{abnormal hooks}.
411MH-E uses normal hooks in nearly all cases, so you can assume that we 427MH-E uses normal hooks in nearly all cases, so you can assume that we
412are talking about normal hooks unless we explicitly mention that a hook 428are talking about normal hooks unless we explicitly mention that a
413is abnormal. We also follow the conventions described in that section: 429hook is abnormal. We also follow the conventions described in that
414the name of the abnormal hooks end in @code{-hooks} and all the rest 430section: the name of the abnormal hooks end in @code{-hooks} and all
415of the MH-E hooks end in @code{-hook}. 431the rest of the MH-E hooks end in @code{-hook}. You can add hooks with
432either @code{customize-option} or @code{add-hook}.
416 433
417@cindex Emacs, mark 434@cindex Emacs, mark
418@cindex Emacs, point 435@cindex Emacs, point
@@ -420,6 +437,8 @@ of the MH-E hooks end in @code{-hook}.
420@cindex mark 437@cindex mark
421@cindex point 438@cindex point
422@cindex region 439@cindex region
440@kindex C-@@
441@kindex C-@key{SPC}
423 442
424There are several other terms that are used in Emacs that you should 443There are several other terms that are used in Emacs that you should
425know. The @dfn{point} is where the cursor currently is. You can save 444know. The @dfn{point} is where the cursor currently is. You can save
@@ -430,14 +449,16 @@ commands operate on regions, such as those for deleting text or
430filling paragraphs. A mark can be set with @kbd{C-@@} (or 449filling paragraphs. A mark can be set with @kbd{C-@@} (or
431@kbd{C-@key{SPC}}). 450@kbd{C-@key{SPC}}).
432 451
452@cindex completion
433@cindex Emacs, completion 453@cindex Emacs, completion
434@cindex Emacs, file completion 454@cindex Emacs, file completion
435@cindex Emacs, folder completion 455@cindex Emacs, folder completion
436@cindex Emacs, minibuffer 456@cindex Emacs, minibuffer
437@cindex completion
438@cindex file completion 457@cindex file completion
439@cindex folder completion 458@cindex folder completion
440@cindex minibuffer 459@cindex minibuffer
460@kindex SPC
461@kindex TAB
441 462
442The @dfn{minibuffer} is the bottom line of the Emacs window, where all 463The @dfn{minibuffer} is the bottom line of the Emacs window, where all
443prompting and multiple-character input is directed. You can use 464prompting and multiple-character input is directed. You can use
@@ -456,6 +477,10 @@ Completion} in @cite{The GNU Emacs Manual}.
456Note that @key{SPC} cannot be used for completing filenames and 477Note that @key{SPC} cannot be used for completing filenames and
457folders. 478folders.
458 479
480@findex help-with-tutorial
481@kindex C-h t
482@kindex M-x
483
459The minibuffer is also where you enter Emacs function names after 484The minibuffer is also where you enter Emacs function names after
460typing @kbd{M-x}. For example, in the preface, I mentioned that you 485typing @kbd{M-x}. For example, in the preface, I mentioned that you
461could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What 486could obtain help with @kbd{C-h t} (@code{help-with-tutorial}). What
@@ -518,6 +543,14 @@ message, @samp{Cannot find the commands `inc' and `mhl' and the file
518MH-E, and you may need to install MH too. However, newer versions of 543MH-E, and you may need to install MH too. However, newer versions of
519MH-E are better at finding MH if it is on your system.}. 544MH-E are better at finding MH if it is on your system.}.
520 545
546@cindex @command{mhparam}
547@cindex MH commands, @command{mhparam}
548@vindex exec-path
549@vindex mh-path
550@vindex mh-sys-path
551@vindex mh-variant
552@vindex mh-variant-in-use
553
521The option @code{mh-variant} specifies the variant used by MH-E 554The option @code{mh-variant} specifies the variant used by MH-E
522(@pxref{Options}). The default setting of this option is 555(@pxref{Options}). The default setting of this option is
523@samp{Auto-detect} which means that MH-E will automatically choose the 556@samp{Auto-detect} which means that MH-E will automatically choose the
@@ -525,15 +558,23 @@ first of nmh, MH, or GNU mailutils that it finds in the directories
525listed in @code{mh-path} (which you can customize), 558listed in @code{mh-path} (which you can customize),
526@code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at 559@code{mh-sys-path}, and @code{exec-path}. If MH-E can't find MH at
527all, you may have to customize @code{mh-path} and add the directory in 560all, you may have to customize @code{mh-path} and add the directory in
528which the command @code{mhparam} is located. If, on the other hand, 561which the command @command{mhparam} is located. If, on the other hand,
529you have both nmh and mailutils installed (for example) and 562you have both nmh and mailutils installed (for example) and
530@code{mh-variant-in-use} was initialized to nmh but you want to use 563@code{mh-variant-in-use} was initialized to nmh but you want to use
531mailutils, then you can set @code{mh-variant} to @samp{mailutils}. 564mailutils, then you can set @code{mh-variant} to @samp{mailutils}.
532 565
566@vindex mh-flists-present-flag
567@vindex mh-lib
568@vindex mh-lib-progs
569@vindex mh-progs
570
533When @code{mh-variant} is changed, MH-E resets @code{mh-progs}, 571When @code{mh-variant} is changed, MH-E resets @code{mh-progs},
534@code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and 572@code{mh-lib}, @code{mh-lib-progs}, @code{mh-flists-present-flag}, and
535@code{mh-variant-in-use} accordingly. 573@code{mh-variant-in-use} accordingly.
536 574
575@cindex @file{.emacs}
576@cindex files, @file{.emacs}
577
537@sp 1 578@sp 1
538@center @strong{NOTE} 579@center @strong{NOTE}
539 580
@@ -565,14 +606,14 @@ profile components}. For example, the @samp{Path:} MH profile
565component contains the path to your mail directory, which is 606component contains the path to your mail directory, which is
566@file{~/Mail} by default. 607@file{~/Mail} by default.
567 608
568@cindex @samp{Draft-Folder:} MH profile component
569@cindex @samp{Path:} MH profile component
570@cindex @samp{Previous-Sequence:} MH profile component
571@cindex @samp{Unseen-Sequence:} MH profile component
572@cindex MH profile component, @samp{Draft-Folder:} 609@cindex MH profile component, @samp{Draft-Folder:}
573@cindex MH profile component, @samp{Path:} 610@cindex MH profile component, @samp{Path:}
574@cindex MH profile component, @samp{Previous-Sequence:} 611@cindex MH profile component, @samp{Previous-Sequence:}
575@cindex MH profile component, @samp{Unseen-Sequence:} 612@cindex MH profile component, @samp{Unseen-Sequence:}
613@cindex @samp{Draft-Folder:} MH profile component
614@cindex @samp{Path:} MH profile component
615@cindex @samp{Previous-Sequence:} MH profile component
616@cindex @samp{Unseen-Sequence:} MH profile component
576@findex mh-find-path 617@findex mh-find-path
577@vindex mh-draft-folder 618@vindex mh-draft-folder
578@vindex mh-find-path-hook 619@vindex mh-find-path-hook
@@ -597,6 +638,10 @@ between MH and MH-E.
597@node Tour Through MH-E, Using This Manual, Getting Started, Top 638@node Tour Through MH-E, Using This Manual, Getting Started, Top
598@chapter Tour Through MH-E 639@chapter Tour Through MH-E
599 640
641@cindex introduction
642@cindex tour
643@cindex tutorial
644
600This chapter introduces some of the terms you'll need to know and then 645This chapter introduces some of the terms you'll need to know and then
601takes you on a tour of MH-E@footnote{The keys mentioned in these 646takes you on a tour of MH-E@footnote{The keys mentioned in these
602chapters refer to the default key bindings. If you've changed the 647chapters refer to the default key bindings. If you've changed the
@@ -621,6 +666,7 @@ get the big picture, and then you can read the manual as you wish.
621 666
622@cindex sending mail 667@cindex sending mail
623@findex mh-smail 668@findex mh-smail
669@kindex M-x mh-smail
624 670
625Let's start our tour by sending ourselves a message which we can later 671Let's start our tour by sending ourselves a message which we can later
626read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program 672read and process. Enter @kbd{M-x mh-smail} to invoke the MH-E program
@@ -671,7 +717,10 @@ present or the body of your message will be considered to be part of
671the header. 717the header.
672 718
673@cindex help 719@cindex help
720@findex describe-mode
721@kindex C-c ?
674@kindex C-c C-c 722@kindex C-c C-c
723@kindex C-h m
675 724
676There are several commands specific to MH-Letter mode@footnote{You can 725There are several commands specific to MH-Letter mode@footnote{You can
677get quick help for the commands used most often with @kbd{C-c ?} or 726get quick help for the commands used most often with @kbd{C-c ?} or
@@ -690,6 +739,7 @@ message. Type @kbd{C-c C-c} now. That's all there is to it!
690@cindex modes, MH-Folder 739@cindex modes, MH-Folder
691@cindex reading mail 740@cindex reading mail
692@findex mh-rmail 741@findex mh-rmail
742@kindex M-x mh-rmail
693 743
694To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}. 744To read the mail you've just sent yourself, enter @kbd{M-x mh-rmail}.
695This incorporates the new mail and puts the output from 745This incorporates the new mail and puts the output from
@@ -702,10 +752,15 @@ pick Ranges Sequences} in the MH book.} which prints a one-line
702summary of each message) into a buffer called @samp{+inbox} whose 752summary of each message) into a buffer called @samp{+inbox} whose
703major mode is MH-Folder. 753major mode is MH-Folder.
704 754
755@findex mh-rmail
756@kindex F r
757@kindex M-x mh-rmail
758
705@sp 1 759@sp 1
706@center @strong{NOTE} 760@center @strong{NOTE}
707 761
708@quotation 762@quotation
763
709The @kbd{M-x mh-rmail} command will show you only new mail, not mail 764The @kbd{M-x mh-rmail} command will show you only new mail, not mail
710you have already read. If you were to run this tour again, you would 765you have already read. If you were to run this tour again, you would
711use @kbd{F r} to pull all your messages into MH-E. 766use @kbd{F r} to pull all your messages into MH-E.
@@ -753,6 +808,7 @@ If you typed a long message, you can view subsequent pages with
753@section Processing Mail 808@section Processing Mail
754 809
755@cindex processing mail 810@cindex processing mail
811@kindex @key{RET}
756@kindex r 812@kindex r
757 813
758The first thing we want to do is reply to the message that we sent 814The first thing we want to do is reply to the message that we sent
@@ -789,8 +845,17 @@ Composing a reply...done
789@end cartouche 845@end cartouche
790@i{Composition window during reply} 846@i{Composition window during reply}
791 847
848@findex backward-char
849@findex forward-char
850@findex next-line
851@findex previous-line
852@kindex C-b
792@kindex C-c C-c 853@kindex C-c C-c
793@kindex C-c C-f C-t 854@kindex C-c C-f C-t
855@kindex C-f
856@kindex C-n
857@kindex C-p
858@kindex @key{BS}
794 859
795By default, MH will not add you to the address list of your replies, 860By default, MH will not add you to the address list of your replies,
796so if you find that the @samp{To:} header field is missing, don't 861so if you find that the @samp{To:} header field is missing, don't
@@ -802,7 +867,10 @@ move around with the arrow keys or with @kbd{C-p}
802delete the previous character with @key{BS}. When you're finished 867delete the previous character with @key{BS}. When you're finished
803editing your message, send it with @kbd{C-c C-c} as before. 868editing your message, send it with @kbd{C-c C-c} as before.
804 869
870@cindex @command{refile}
871@cindex MH commands, @command{refile}
805@cindex folders 872@cindex folders
873@kindex @key{SPC}
806@kindex o 874@kindex o
807 875
808You'll often want to save messages that were sent to you in an 876You'll often want to save messages that were sent to you in an
@@ -820,9 +888,11 @@ in a moment.
820 888
821@cindex MH-Folder mode 889@cindex MH-Folder mode
822@cindex modes, MH-Folder 890@cindex modes, MH-Folder
823@kindex @key{RET}
824@kindex d 891@kindex d
825@kindex i 892@kindex i
893@kindex @key{RET}
894@kindex n
895@kindex p
826@kindex x 896@kindex x
827 897
828Your previous reply is now waiting in the system mailbox. You 898Your previous reply is now waiting in the system mailbox. You
@@ -837,6 +907,7 @@ command.
837 907
838@findex mh-smail 908@findex mh-smail
839@kindex m 909@kindex m
910@kindex M-x mh-smail
840 911
841If you want to send another message you can use @kbd{m} instead of 912If you want to send another message you can use @kbd{m} instead of
842@kbd{M-x mh-smail}. So go ahead, send some mail to your friends! 913@kbd{M-x mh-smail}. So go ahead, send some mail to your friends!
@@ -846,6 +917,7 @@ If you want to send another message you can use @kbd{m} instead of
846@findex describe-mode 917@findex describe-mode
847@kindex ? 918@kindex ?
848@kindex C-h m 919@kindex C-h m
920@kindex F ?
849 921
850You can get a quick reminder about these commands by typing @kbd{?}. 922You can get a quick reminder about these commands by typing @kbd{?}.
851This lists several @dfn{prefix characters}. To list the commands 923This lists several @dfn{prefix characters}. To list the commands
@@ -858,6 +930,8 @@ available with the @kbd{C-h m} (@code{describe-mode}) command.
858 930
859@cindex Emacs, quitting 931@cindex Emacs, quitting
860@cindex quitting 932@cindex quitting
933@kindex C-x C-c
934@kindex x
861 935
862You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c} 936You may now wish to exit @command{emacs} entirely. Use @kbd{C-x C-c}
863to exit @command{emacs}. If you exited without running @kbd{x} in the 937to exit @command{emacs}. If you exited without running @kbd{x} in the
@@ -866,6 +940,9 @@ to exit @command{emacs}. If you exited without running @kbd{x} in the
866perform any refiles and deletes that you did there. 940perform any refiles and deletes that you did there.
867 941
868@findex mh-rmail 942@findex mh-rmail
943@kindex C-x b
944@kindex C-x k
945@kindex M-x mh-rmail
869@kindex q 946@kindex q
870 947
871If you don't want to leave Emacs, you can type @kbd{q} to bury (hide) 948If you don't want to leave Emacs, you can type @kbd{q} to bury (hide)
@@ -968,6 +1045,10 @@ about every MH-E command and option.
968@findex mh-help 1045@findex mh-help
969@kindex ? 1046@kindex ?
970@kindex C-c ? 1047@kindex C-c ?
1048@kindex C-h C-h
1049@kindex C-h C-k i
1050@kindex C-h i
1051@kindex C-h m
971 1052
972There are many commands, but don't get intimidated. There are command 1053There are many commands, but don't get intimidated. There are command
973summaries at the beginning of each chapter. In case you have or would 1054summaries at the beginning of each chapter. In case you have or would
@@ -998,7 +1079,8 @@ possible. That way you will get the same behavior inside and outside
998GNU Emacs. Note that MH-E does not provide hooks for customizations 1079GNU Emacs. Note that MH-E does not provide hooks for customizations
999that can be done in MH; this omission is intentional. 1080that can be done in MH; this omission is intentional.
1000 1081
1001@cindex Emacs, Emacs Lisp manual 1082@cindex Emacs Lisp Manual
1083@cindex Emacs, Emacs Lisp Manual
1002@cindex Emacs, info 1084@cindex Emacs, info
1003@cindex Emacs, online help 1085@cindex Emacs, online help
1004@cindex info 1086@cindex info
@@ -1080,6 +1162,12 @@ use the @samp{State} combo box and select @samp{Save for Future
1080Sessions}. To read more about @code{mh-lpr-command-format}, see 1162Sessions}. To read more about @code{mh-lpr-command-format}, see
1081@ref{Printing}. 1163@ref{Printing}.
1082 1164
1165@cindex nil
1166@cindex off, option
1167@cindex on, option
1168@cindex option, turning on and off
1169@cindex t
1170@findex customize-option
1083@vindex mh-bury-show-buffer-flag, example 1171@vindex mh-bury-show-buffer-flag, example
1084 1172
1085Options can also hold boolean values. In Emacs Lisp, the boolean 1173Options can also hold boolean values. In Emacs Lisp, the boolean
@@ -1095,14 +1183,16 @@ the @samp{Erase Customization} menu item to reset the option to the
1095default, which places the MH-Show buffer at the bottom of the buffer 1183default, which places the MH-Show buffer at the bottom of the buffer
1096stack. 1184stack.
1097 1185
1186@vindex mh-mhl-format-file, example
1187
1098The text usually says to turn on an option by setting it to a 1188The text usually says to turn on an option by setting it to a
1099@emph{non-@code{nil}} value, because sometimes values other than 1189@emph{non-@code{nil}} value, because sometimes values other than
1100@samp{on} are meaningful. An example of this is the variable 1190@samp{on} are meaningful. An example of this is the variable
1101@code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as 1191@code{mh-mhl-format-file} (@pxref{Viewing}). Other options, such as
1102hooks, involve a little more Emacs Lisp programming expertise. 1192hooks, involve a little more Emacs Lisp programming expertise.
1103 1193
1104@cindex @samp{mh} customization group
1105@cindex customization group, @samp{mh} 1194@cindex customization group, @samp{mh}
1195@cindex @samp{mh} customization group
1106@findex customize-group 1196@findex customize-group
1107@findex mh-customize 1197@findex mh-customize
1108 1198
@@ -1117,14 +1207,16 @@ customization group is to use @kbd{M-x mh-customize @key{RET}}.
1117 1207
1118@c Sync with mh-folder-mode docstring. 1208@c Sync with mh-folder-mode docstring.
1119 1209
1120@cindex ranges
1121@cindex message abbreviations 1210@cindex message abbreviations
1122@cindex message ranges 1211@cindex message ranges
1212@cindex ranges
1123 1213
1124Many commands that operate on individual messages, such as 1214Many commands that operate on individual messages, such as
1125@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE} 1215@code{mh-forward} or @code{mh-refile-msg} take a @code{RANGE}
1126argument. This argument can be used in several ways. 1216argument. This argument can be used in several ways.
1127 1217
1218@kindex C-u, with ranges
1219
1128If you provide the prefix argument @kbd{C-u} to these commands, then 1220If you provide the prefix argument @kbd{C-u} to these commands, then
1129you will be prompted for the message range. This can be any valid MH 1221you will be prompted for the message range. This can be any valid MH
1130range which can include messages, sequences (@pxref{Sequences}), and 1222range which can include messages, sequences (@pxref{Sequences}), and
@@ -1156,9 +1248,9 @@ For example, a range that shows all of these things is @samp{1 2 3
1156 1248
1157@vindex transient-mark-mode 1249@vindex transient-mark-mode
1158 1250
1159If the option @code{transient-mark-mode} is set to @code{t} and you 1251If the option @code{transient-mark-mode} is turned on and you set a
1160set a region in the MH-Folder buffer, then the MH-E command will 1252region in the MH-Folder buffer, then the MH-E command will perform the
1161perform the operation on all messages in that region. 1253operation on all messages in that region.
1162 1254
1163@cindex @samp{mh-range} customization group 1255@cindex @samp{mh-range} customization group
1164@cindex customization group, @samp{mh-range} 1256@cindex customization group, @samp{mh-range}
@@ -1171,6 +1263,8 @@ affects how ranges are interpreted.
1171On means interpret a number as a range (default: @samp{on}). 1263On means interpret a number as a range (default: @samp{on}).
1172@end vtable 1264@end vtable
1173 1265
1266@vindex mh-interpret-number-as-range-flag
1267
1174Since one of the most frequent ranges used is @samp{last:N}, MH-E will 1268Since one of the most frequent ranges used is @samp{last:N}, MH-E will
1175interpret input such as @samp{200} as @samp{last:200} if the 1269interpret input such as @samp{200} as @samp{last:200} if the
1176@code{mh-interpret-number-as-range-flag} option is on (which is the 1270@code{mh-interpret-number-as-range-flag} option is on (which is the
@@ -1180,6 +1274,8 @@ default). If you need to scan just the message 200, then use the range
1180@node Folder Selection, , Ranges, Using This Manual 1274@node Folder Selection, , Ranges, Using This Manual
1181@section Folder Selection 1275@section Folder Selection
1182 1276
1277@cindex completion, folders
1278@cindex folders, completion
1183@cindex folders, selecting 1279@cindex folders, selecting
1184 1280
1185When you choose a folder in MH-E via a command such as @kbd{o} 1281When you choose a folder in MH-E via a command such as @kbd{o}
@@ -1195,8 +1291,8 @@ Completion} in @cite{The GNU Emacs Manual}).
1195In addition, MH-E has several ways of choosing a suitable default so 1291In addition, MH-E has several ways of choosing a suitable default so
1196that the folder can often be selected with a single @key{RET} key. 1292that the folder can often be selected with a single @key{RET} key.
1197 1293
1198@cindex @samp{mh-folder-selection} customization group
1199@cindex customization group, @samp{mh-folder-selection} 1294@cindex customization group, @samp{mh-folder-selection}
1295@cindex @samp{mh-folder-selection} customization group
1200 1296
1201The @samp{mh-folder-selection} customization group contains some 1297The @samp{mh-folder-selection} customization group contains some
1202options which are used to help with this. 1298options which are used to help with this.
@@ -1217,6 +1313,8 @@ On means guessed folder name must exist to be used (default:
1217Prefix used for folder names generated from aliases (default: @code{""}). 1313Prefix used for folder names generated from aliases (default: @code{""}).
1218@end vtable 1314@end vtable
1219 1315
1316@vindex mh-default-folder-for-message-function
1317
1220You can set the option @code{mh-default-folder-for-message-function} 1318You can set the option @code{mh-default-folder-for-message-function}
1221to a function that provides a default folder for the message to be 1319to a function that provides a default folder for the message to be
1222refiled. When this function is called, the current buffer contains the 1320refiled. When this function is called, the current buffer contains the
@@ -1230,6 +1328,7 @@ Otherwise, the name of the destination folder is derived from the
1230sender as follows: 1328sender as follows:
1231 1329
1232@enumerate 1330@enumerate
1331@vindex mh-default-folder-list
1233@item 1332@item
1234The folder name associated with the first address found in the list 1333The folder name associated with the first address found in the list
1235@code{mh-default-folder-list} is used. Each element in this list 1334@code{mh-default-folder-list} is used. Each element in this list
@@ -1237,12 +1336,15 @@ contains a @samp{Check Recipient} item. If this item is turned on,
1237then the address is checked against the recipient instead of the 1336then the address is checked against the recipient instead of the
1238sender. This is useful for mailing lists. 1337sender. This is useful for mailing lists.
1239@c ------------------------- 1338@c -------------------------
1339@vindex mh-default-folder-prefix
1240@item 1340@item
1241An alias prefixed by @code{mh-default-folder-prefix} corresponding to 1341An alias prefixed by @code{mh-default-folder-prefix} corresponding to
1242the address is used. The prefix is used to prevent clutter in your 1342the address is used. The prefix is used to prevent clutter in your
1243mail directory. @xref{Aliases}. 1343mail directory. @xref{Aliases}.
1244@end enumerate 1344@end enumerate
1245 1345
1346@vindex mh-default-folder-must-exist-flag
1347
1246If the derived folder does not exist, and 1348If the derived folder does not exist, and
1247@code{mh-default-folder-must-exist-flag} is @code{t}, then the last 1349@code{mh-default-folder-must-exist-flag} is @code{t}, then the last
1248folder name used is suggested. This is useful if you get mail from 1350folder name used is suggested. This is useful if you get mail from
@@ -1252,7 +1354,9 @@ same project folder.
1252@node Incorporating Mail, Reading Mail, Using This Manual, Top 1354@node Incorporating Mail, Reading Mail, Using This Manual, Top
1253@chapter Incorporating Your Mail 1355@chapter Incorporating Your Mail
1254 1356
1357@cindex @samp{Folder} menu
1255@cindex incorporating 1358@cindex incorporating
1359@cindex menu, @samp{Folder}
1256 1360
1257This chapter talks about getting mail from your system mailbox into 1361This chapter talks about getting mail from your system mailbox into
1258your MH @samp{+inbox} folder. The following command accomplishes that 1362your MH @samp{+inbox} folder. The following command accomplishes that
@@ -1284,11 +1388,16 @@ Alternate spool files (default: @code{nil}).
1284The following hook is available. 1388The following hook is available.
1285 1389
1286@vtable @code 1390@vtable @code
1391@findex mh-inc-folder
1287@item mh-inc-folder-hook 1392@item mh-inc-folder-hook
1288Hook run by @samp{mh-inc-folder} after incorporating mail into a 1393Hook run by @code{mh-inc-folder} after incorporating mail into a
1289folder (default: @code{nil}). 1394folder (default: @code{nil}).
1290@end vtable 1395@end vtable
1291 1396
1397@cindex @samp{+inbox}
1398@findex mh-inc-folder
1399@kindex i
1400
1292If at any time you receive new mail, incorporate the new mail into 1401If at any time you receive new mail, incorporate the new mail into
1293your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note 1402your @samp{+inbox} buffer with @kbd{i} (@code{mh-inc-folder}). Note
1294that @kbd{i} will display the @samp{+inbox} buffer, even if there 1403that @kbd{i} will display the @samp{+inbox} buffer, even if there
@@ -1305,7 +1414,7 @@ example, @kbd{C-u i ~/mbox @key{RET} +tmp @key{RET}}).
1305 1414
1306Emacs can notify you when you have new mail by displaying @samp{Mail} 1415Emacs can notify you when you have new mail by displaying @samp{Mail}
1307in the mode line. To enable this behavior, and to have a clock in the 1416in the mode line. To enable this behavior, and to have a clock in the
1308mode line besides, add the following to @file{~/.emacs}: 1417mode line as well, add the following to @file{~/.emacs}:
1309 1418
1310@findex display-time 1419@findex display-time
1311 1420
@@ -1314,8 +1423,9 @@ mode line besides, add the following to @file{~/.emacs}:
1314@end lisp 1423@end lisp
1315 1424
1316@cindex @command{inc} 1425@cindex @command{inc}
1317@cindex MH commands, @command{inc}
1318@cindex incorporating 1426@cindex incorporating
1427@cindex MH commands, @command{inc}
1428@vindex mh-inc-prog
1319@vindex mh-progs 1429@vindex mh-progs
1320 1430
1321The name of the program that incorporates new mail is stored in 1431The name of the program that incorporates new mail is stored in
@@ -1330,6 +1440,8 @@ prev} and @uref{@value{MH-BOOK-HOME}/mhstr.htm, MH Format Strings} in
1330the MH book). You'll then need to modify several variables 1440the MH book). You'll then need to modify several variables
1331appropriately (@pxref{Scan Line Formats}). 1441appropriately (@pxref{Scan Line Formats}).
1332 1442
1443@vindex mh-inc-spool-list
1444
1333You can use the @code{mh-inc-spool-list} variable to direct MH-E to 1445You can use the @code{mh-inc-spool-list} variable to direct MH-E to
1334retrieve mail from arbitrary spool files other than your system 1446retrieve mail from arbitrary spool files other than your system
1335mailbox, file it in folders other than your @samp{+inbox}, and assign 1447mailbox, file it in folders other than your @samp{+inbox}, and assign
@@ -1351,6 +1463,9 @@ MAILDIR=$HOME/mail
1351mh-e 1463mh-e
1352@end smallexample 1464@end smallexample
1353 1465
1466@findex mh-inc-spool-*
1467@kindex I *
1468
1354In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an 1469In order to incorporate @file{~/mail/mh-e} into @samp{+mh-e} with an
1355@kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option, 1470@kbd{I m} (@code{mh-inc-spool-mh-e}) command, customize this option,
1356and click on the @samp{INS} button. Enter a @samp{Spool File} of 1471and click on the @samp{INS} button. Enter a @samp{Spool File} of
@@ -1380,6 +1495,10 @@ box ~/mail/mh-e
1380In XEmacs, the command @command{gnuclient} is used in a similar 1495In XEmacs, the command @command{gnuclient} is used in a similar
1381fashion. 1496fashion.
1382 1497
1498@findex mh-inc-folder
1499@kindex i
1500@vindex mh-inc-folder-hook
1501
1383You can set the hook @code{mh-inc-folder-hook}, which is called after 1502You can set the hook @code{mh-inc-folder-hook}, which is called after
1384new mail is incorporated by the @kbd{i} (@code{mh-inc-folder}) 1503new mail is incorporated by the @kbd{i} (@code{mh-inc-folder})
1385command. A good use of this hook is to rescan the whole folder either 1504command. A good use of this hook is to rescan the whole folder either
@@ -1410,13 +1529,16 @@ the message numbers from outside of MH-E.
1410@node Reading Mail, Folders, Incorporating Mail, Top 1529@node Reading Mail, Folders, Incorporating Mail, Top
1411@chapter Reading Your Mail 1530@chapter Reading Your Mail
1412 1531
1532@cindex @samp{+inbox}
1413@cindex MH-Folder mode 1533@cindex MH-Folder mode
1414@cindex MH-Show mode 1534@cindex MH-Show mode
1415@cindex modes, MH-Folder 1535@cindex modes, MH-Folder
1416@cindex modes, MH-Show 1536@cindex modes, MH-Show
1417@cindex reading mail 1537@cindex reading mail
1418@cindex scan lines
1419@findex mh-rmail 1538@findex mh-rmail
1539@kindex M-x mh-rmail
1540@kindex F r
1541@kindex F v
1420 1542
1421The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This 1543The MH-E entry point for reading mail is @kbd{M-x mh-rmail}. This
1422command incorporates your mail and creates a buffer called 1544command incorporates your mail and creates a buffer called
@@ -1427,6 +1549,12 @@ into MH-E. Or, give a prefix argument to @code{mh-rmail} so it will
1427prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u 1549prompt you for folder to visit like @kbd{F v} (for example, @kbd{C-u
1428M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}. 1550M-x mh-rmail @key{RET} bob @key{RET}}). @xref{Folders}.}.
1429 1551
1552@cindex @command{scan}
1553@cindex @samp{Message} menu
1554@cindex MH commands, @command{scan}
1555@cindex menu, @samp{Message}
1556@cindex scan lines
1557
1430The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line 1558The @samp{+inbox} buffer contains @dfn{scan lines}, which are one-line
1431summaries of each incorporated message. You can perform most MH 1559summaries of each incorporated message. You can perform most MH
1432commands on these messages via one- or two-letter commands in either 1560commands on these messages via one- or two-letter commands in either
@@ -1880,6 +2008,8 @@ header fields that mailers add to a message, but if you wish to see
1880all of them, use the command @kbd{,} (comma; 2008all of them, use the command @kbd{,} (comma;
1881@code{mh-header-display}). 2009@code{mh-header-display}).
1882 2010
2011@vindex mh-show-maximum-size
2012
1883The option @code{mh-show-maximum-size} provides an opportunity to skip 2013The option @code{mh-show-maximum-size} provides an opportunity to skip
1884over large messages which may be slow to load. The default value of 0 2014over large messages which may be slow to load. The default value of 0
1885means that all message are shown regardless of size. 2015means that all message are shown regardless of size.
@@ -1901,8 +2031,8 @@ interesting, header fields.
1901 2031
1902@cindex regular expressions, @code{mh-invisible-header-fields} 2032@cindex regular expressions, @code{mh-invisible-header-fields}
1903@vindex mh-clean-message-header-flag 2033@vindex mh-clean-message-header-flag
1904@vindex mh-invisible-header-fields-default
1905@vindex mh-invisible-header-fields 2034@vindex mh-invisible-header-fields
2035@vindex mh-invisible-header-fields-default
1906 2036
1907Normally messages are delivered with a handful of uninteresting header 2037Normally messages are delivered with a handful of uninteresting header
1908fields. These are hidden by turning on the option 2038fields. These are hidden by turning on the option
@@ -1918,12 +2048,12 @@ entire class of fields that start with the same prefix. If you think a
1918header field should be generally ignored, report a bug (@pxref{Bug 2048header field should be generally ignored, report a bug (@pxref{Bug
1919Reports}). 2049Reports}).
1920 2050
1921@cindex @samp{Face:} header field
1922@cindex @samp{X-Face:} header field
1923@cindex @samp{X-Image-URL:} header field
1924@cindex header field, @samp{Face:} 2051@cindex header field, @samp{Face:}
1925@cindex header field, @samp{X-Face:} 2052@cindex header field, @samp{X-Face:}
1926@cindex header field, @samp{X-Image-URL:} 2053@cindex header field, @samp{X-Image-URL:}
2054@cindex @samp{Face:} header field
2055@cindex @samp{X-Face:} header field
2056@cindex @samp{X-Image-URL:} header field
1927@vindex mh-show-use-xface-flag 2057@vindex mh-show-use-xface-flag
1928 2058
1929MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and 2059MH-E can display the content of @samp{Face:}, @samp{X-Face:}, and
@@ -2022,9 +2152,9 @@ parse the header. Note that @command{mhl} is always used for printing
2022and forwarding; in this case, the value of @code{mh-mhl-format-file} 2152and forwarding; in this case, the value of @code{mh-mhl-format-file}
2023is consulted if you have specified a format file. 2153is consulted if you have specified a format file.
2024 2154
2025@vindex mh-highlight-citation-style
2026@cindex citations, highlighting 2155@cindex citations, highlighting
2027@cindex highlighting citations 2156@cindex highlighting citations
2157@vindex mh-highlight-citation-style
2028 2158
2029If the sender of the message has cited other messages in his message, 2159If the sender of the message has cited other messages in his message,
2030then MH-E will highlight these citations to emphasize the sender's 2160then MH-E will highlight these citations to emphasize the sender's
@@ -2047,9 +2177,9 @@ highlighting of citations entirely, choose @samp{None}.
2047Email addresses and URLs in the message are highlighted if the option 2177Email addresses and URLs in the message are highlighted if the option
2048@code{goto-address-highlight-p} is on, which it is by default. To view 2178@code{goto-address-highlight-p} is on, which it is by default. To view
2049the web page for a highlighted URL or to send a message using a 2179the web page for a highlighted URL or to send a message using a
2050highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}. 2180highlighted email address, use @kbd{Mouse-2} or @kbd{C-c @key{RET}}
2051See @ref{Sending Mail}, to see how to configure Emacs to send the 2181(@code{goto-address-at-point}). @xref{Sending Mail}, to see how to
2052message using MH-E. 2182configure Emacs to send the message using MH-E.
2053 2183
2054@cindex boldface, showing 2184@cindex boldface, showing
2055@cindex emphasis 2185@cindex emphasis
@@ -2106,9 +2236,9 @@ thing called after messages are displayed. It's used to affect the
2106behavior of MH-E in general or when @code{mh-show-mode-hook} is too 2236behavior of MH-E in general or when @code{mh-show-mode-hook} is too
2107early. 2237early.
2108 2238
2109@vindex mh-show-buffer-mode-line-buffer-id
2110@cindex MH-Show mode 2239@cindex MH-Show mode
2111@cindex modes, MH-Show 2240@cindex modes, MH-Show
2241@vindex mh-show-buffer-mode-line-buffer-id
2112 2242
2113For those who like to modify their mode lines, use 2243For those who like to modify their mode lines, use
2114@code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in 2244@code{mh-show-buffer-mode-line-buffer-id} to modify the mode line in
@@ -2124,13 +2254,13 @@ of @code{"@{show-%s@} %d"} yields a mode line of
2124@node Viewing Attachments, HTML, Viewing, Reading Mail 2254@node Viewing Attachments, HTML, Viewing, Reading Mail
2125@section Viewing Attachments 2255@section Viewing Attachments
2126 2256
2257@cindex attachments
2258@cindex body parts
2127@cindex @command{mhshow} 2259@cindex @command{mhshow}
2128@cindex @command{show} 2260@cindex @command{show}
2129@cindex MH commands, @command{mhshow} 2261@cindex MH commands, @command{mhshow}
2130@cindex MH commands, @command{show} 2262@cindex MH commands, @command{show}
2131@cindex MIME 2263@cindex MIME
2132@cindex attachments
2133@cindex body parts
2134@cindex multimedia mail 2264@cindex multimedia mail
2135 2265
2136MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet 2266MH has the ability to display @dfn{@sc{mime}} (Multipurpose Internet
@@ -2164,21 +2294,22 @@ option also controls the display of quoted-printable messages and
2164other graphical widgets. @xref{Viewing}. 2294other graphical widgets. @xref{Viewing}.
2165 2295
2166@cindex buttons 2296@cindex buttons
2167@kindex Mouse-1
2168@kindex Mouse-2
2169@kindex @key{RET}
2170@findex mh-press-button
2171@findex mh-next-button
2172@findex mh-prev-button
2173@kindex K @key{TAB}
2174@kindex K S-@key{TAB}
2175 2297
2176Attachments in MH-E are indicated by buttons like this: 2298Attachments in MH-E are indicated by @dfn{buttons} like this:
2177 2299
2178@example 2300@example
2179[1. image/jpeg; foo.jpg]... 2301[1. image/jpeg; foo.jpg]...
2180@end example 2302@end example
2181 2303
2304@findex mh-next-button
2305@findex mh-press-button
2306@findex mh-prev-button
2307@kindex @key{RET}
2308@kindex K @key{TAB}
2309@kindex K S-@key{TAB}
2310@kindex Mouse-1
2311@kindex Mouse-2
2312
2182To view the contents of the button, use either @kbd{Mouse-1} or 2313To view the contents of the button, use either @kbd{Mouse-1} or
2183@kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when 2314@kbd{Mouse-2} on the button or @key{RET} (@code{mh-press-button}) when
2184the cursor is over the button. This command is a toggle so if you use 2315the cursor is over the button. This command is a toggle so if you use
@@ -2231,7 +2362,6 @@ default for the viewer by calling the Emacs function
2231 2362
2232@cindex attachments, saving 2363@cindex attachments, saving
2233@cindex saving attachments 2364@cindex saving attachments
2234
2235@findex mh-folder-save-mime-part 2365@findex mh-folder-save-mime-part
2236@kindex K o 2366@kindex K o
2237 2367
@@ -2261,6 +2391,8 @@ directory. These directories may be superseded by MH profile
2261components, since this function calls on @command{mhstore} 2391components, since this function calls on @command{mhstore}
2262(@command{mhn}) to do the work. 2392(@command{mhn}) to do the work.
2263 2393
2394@vindex mh-mime-save-parts-default-directory
2395
2264The default value for the option 2396The default value for the option
2265@code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so 2397@code{mh-mime-save-parts-default-directory} is @samp{Prompt Always} so
2266that you are always prompted for the directory in which to save the 2398that you are always prompted for the directory in which to save the
@@ -2292,9 +2424,9 @@ permanently by turning on the option
2292MH-E cannot display all attachments inline however. It can display 2424MH-E cannot display all attachments inline however. It can display
2293text (including @sc{html}) and images. 2425text (including @sc{html}) and images.
2294 2426
2295@cindex @samp{Content-Disposition:} header field
2296@cindex header field, @samp{Content-Disposition:} 2427@cindex header field, @samp{Content-Disposition:}
2297@cindex inline images 2428@cindex inline images
2429@cindex @samp{Content-Disposition:} header field
2298@vindex mh-max-inline-image-height 2430@vindex mh-max-inline-image-height
2299@vindex mh-max-inline-image-width 2431@vindex mh-max-inline-image-width
2300 2432
@@ -2348,7 +2480,6 @@ in the @cite{The Gnus Manual}.
2348 2480
2349@cindex HTML 2481@cindex HTML
2350@cindex Gnus 2482@cindex Gnus
2351@vindex mm-text-html-renderer
2352 2483
2353MH-E can display messages that have been sent in HTML@footnote{This 2484MH-E can display messages that have been sent in HTML@footnote{This
2354feature depends on a version of Gnus that is at least 5.10.}. The 2485feature depends on a version of Gnus that is at least 5.10.}. The
@@ -2364,6 +2495,8 @@ then you'll see a button like this:
2364To see how to read the contents of this body part, see @ref{Viewing 2495To see how to read the contents of this body part, see @ref{Viewing
2365Attachments}. 2496Attachments}.
2366 2497
2498@vindex mm-text-html-renderer
2499
2367The browser that MH-E uses is determined by the option 2500The browser that MH-E uses is determined by the option
2368@code{mm-text-html-renderer}. The default setting is set automatically 2501@code{mm-text-html-renderer}. The default setting is set automatically
2369based upon the presence of a known browser on your system. If you wish 2502based upon the presence of a known browser on your system. If you wish
@@ -2373,12 +2506,17 @@ how to use it. In particular, find and disable the option to render
2373images as this can tip off spammers that the email address they have 2506images as this can tip off spammers that the email address they have
2374used is valid. 2507used is valid.
2375 2508
2509@vindex mm-text-html-renderer
2510
2376If you're confused about which @code{mm-text-html-renderer} to use, 2511If you're confused about which @code{mm-text-html-renderer} to use,
2377here's a brief description of each, sorted by popularity, that 2512here's a brief description of each, sorted by popularity, that
2378includes the results of a quick poll of MH-E users from 2005-12-23. 2513includes the results of a quick poll of MH-E users from 2005-12-23.
2379 2514
2380@table @asis 2515@table @asis
2381 2516@cindex browser, @samp{w3m}
2517@cindex @samp{w3m}
2518@kindex Mouse-2
2519@kindex S-Mouse-2
2382@item @samp{w3m} 7 2520@item @samp{w3m} 7
2383The @samp{w3m} browser requires an external program. It's quick, 2521The @samp{w3m} browser requires an external program. It's quick,
2384produces pretty nice output, and best of all, it's the only browser 2522produces pretty nice output, and best of all, it's the only browser
@@ -2389,6 +2527,8 @@ handles tables well and actually respects the table's width parameter
2389(which can cause text to wrap if the author didn't anticipate that the 2527(which can cause text to wrap if the author didn't anticipate that the
2390page would be viewed in Emacs). 2528page would be viewed in Emacs).
2391@c ------------------------- 2529@c -------------------------
2530@cindex browser, @samp{w3m-standalone}
2531@cindex @samp{w3m-standalone}
2392@item @samp{w3m-standalone} 3 2532@item @samp{w3m-standalone} 3
2393This browser, along with @samp{nil} for the external browser, are the 2533This browser, along with @samp{nil} for the external browser, are the
2394only choices that work without having to download a separate lisp 2534only choices that work without having to download a separate lisp
@@ -2398,6 +2538,8 @@ wider than the Emacs frame. This browser was the only one not to
2398handle the escape @samp{&ndash;} (it printed a @samp{?}), but it did 2538handle the escape @samp{&ndash;} (it printed a @samp{?}), but it did
2399render @samp{&reg;}. 2539render @samp{&reg;}.
2400@c ------------------------- 2540@c -------------------------
2541@cindex browser, @samp{links}
2542@cindex @samp{links}
2401@item @samp{links} 1 2543@item @samp{links} 1
2402The @samp{links} browser requires an external program. It's quick, and 2544The @samp{links} browser requires an external program. It's quick, and
2403produces nicer output than @samp{lynx} on single column mails in 2545produces nicer output than @samp{lynx} on single column mails in
@@ -2406,6 +2548,8 @@ on multi-column tables as some lines wrap. At least it fits in 80
2406columns and thus seems better than @samp{w3} and 2548columns and thus seems better than @samp{w3} and
2407@samp{w3m-standalone}. Converts escapes such as @samp{&reg;} to (R). 2549@samp{w3m-standalone}. Converts escapes such as @samp{&reg;} to (R).
2408@c ------------------------- 2550@c -------------------------
2551@cindex browser, @samp{lynx}
2552@cindex @samp{lynx}
2409@item @samp{lynx} 1 2553@item @samp{lynx} 1
2410The @samp{lynx} browser requires an external program. It's quick and 2554The @samp{lynx} browser requires an external program. It's quick and
2411produces pretty decent output but it doesn't show links. It doesn't 2555produces pretty decent output but it doesn't show links. It doesn't
@@ -2419,6 +2563,8 @@ This choice obviously requires an external browser. Like
2419HTML messages have a button for the body part which you can view with 2563HTML messages have a button for the body part which you can view with
2420@kbd{K v} (@code{mh-folder-toggle-mime-part}). 2564@kbd{K v} (@code{mh-folder-toggle-mime-part}).
2421@c ------------------------- 2565@c -------------------------
2566@cindex browser, @samp{w3}
2567@cindex @samp{w3}
2422@item @samp{w3} 0 2568@item @samp{w3} 0
2423This choice does not require an external program as all of the 2569This choice does not require an external program as all of the
2424rendering is done in lisp. You do need to get the package separately. 2570rendering is done in lisp. You do need to get the package separately.
@@ -2431,6 +2577,8 @@ can follow links, but you have to find them first as they are not
2431highlighted. Performs well on single-column tables and handles escapes 2577highlighted. Performs well on single-column tables and handles escapes
2432such as @samp{&reg;}. 2578such as @samp{&reg;}.
2433@c ------------------------- 2579@c -------------------------
2580@cindex browser, @samp{html2text}
2581@cindex @samp{html2text}
2434@item @samp{html2text} 0 2582@item @samp{html2text} 0
2435The @samp{html2text} browser requires an external program. I noticed 2583The @samp{html2text} browser requires an external program. I noticed
2436that it can do some nasty things with simple HTML mails (like filling 2584that it can do some nasty things with simple HTML mails (like filling
@@ -2439,6 +2587,8 @@ On another message, it displayed half of the HTML tags for some
2439reason. 2587reason.
2440@end table 2588@end table
2441 2589
2590@vindex mm-text-html-renderer
2591
2442For a couple more sources of information about 2592For a couple more sources of information about
2443@code{mm-text-html-renderer}, 2593@code{mm-text-html-renderer},
2444@ifinfo 2594@ifinfo
@@ -2459,10 +2609,10 @@ documentation for the Gnus command @kbd{W h} (see section
2459@cindex digests 2609@cindex digests
2460@findex mh-page-digest 2610@findex mh-page-digest
2461@findex mh-page-digest-backwards 2611@findex mh-page-digest-backwards
2462@kindex @key{BS}
2463@kindex @key{SPC}
2464@kindex D @key{BS} 2612@kindex D @key{BS}
2465@kindex D @key{SPC} 2613@kindex D @key{SPC}
2614@kindex @key{BS}
2615@kindex @key{SPC}
2466 2616
2467A digest is a message that contains other messages. Special MH-E 2617A digest is a message that contains other messages. Special MH-E
2468commands let you read digests conveniently. You can use @key{SPC} and 2618commands let you read digests conveniently. You can use @key{SPC} and
@@ -2476,8 +2626,8 @@ use @kbd{D @key{BS}} (@code{mh-page-digest-backwards}).
2476@cindex MH-Folder Show mode 2626@cindex MH-Folder Show mode
2477@cindex modes, MH-Folder Show 2627@cindex modes, MH-Folder Show
2478@findex mh-burst-digest 2628@findex mh-burst-digest
2479@kindex D b
2480@kindex d 2629@kindex d
2630@kindex D b
2481@kindex t 2631@kindex t
2482 2632
2483Another handy command is @kbd{D b} (@code{mh-burst-digest}). This 2633Another handy command is @kbd{D b} (@code{mh-burst-digest}). This
@@ -2639,6 +2789,8 @@ See
2639@findex mh-ps-print-msg-file 2789@findex mh-ps-print-msg-file
2640@kindex P f 2790@kindex P f
2641@kindex P p 2791@kindex P p
2792@vindex mh-lpr-command-format
2793@vindex mh-print-background-flag
2642 2794
2643To print messages in MH-E, use the command @kbd{P p} 2795To print messages in MH-E, use the command @kbd{P p}
2644(@code{mh-ps-print-msg}). You can print all the messages in a range 2796(@code{mh-ps-print-msg}). You can print all the messages in a range
@@ -2694,6 +2846,9 @@ formatted with @command{mhl}@footnote{See the section
2694@uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH 2846@uref{@value{MH-BOOK-HOME}/shomes.htm#Usisho, Using mhl} in the MH
2695book.} and printed with the @command{lpr} command. 2847book.} and printed with the @command{lpr} command.
2696 2848
2849@kindex P f
2850@kindex P l
2851@kindex P p
2697@vindex mh-lpr-command-format 2852@vindex mh-lpr-command-format
2698@vindex mh-print-background-flag 2853@vindex mh-print-background-flag
2699 2854
@@ -2716,11 +2871,10 @@ commands @kbd{P p} or @kbd{P f}.
2716 2871
2717@cindex files 2872@cindex files
2718@cindex pipes 2873@cindex pipes
2719
2720@findex mh-refile-or-write-again 2874@findex mh-refile-or-write-again
2721@findex mh-write-msg-to-file 2875@findex mh-write-msg-to-file
2722@kindex !
2723@kindex > 2876@kindex >
2877@kindex !
2724 2878
2725MH-E does offer a couple of commands that are not a part of MH@. The 2879MH-E does offer a couple of commands that are not a part of MH@. The
2726first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to 2880first one, @kbd{>} (@code{mh-write-msg-to-file}), writes a message to
@@ -2733,6 +2887,7 @@ can be made with the command @kbd{!}
2733 2887
2734@findex mh-pipe-msg 2888@findex mh-pipe-msg
2735@kindex | 2889@kindex |
2890@kindex l
2736 2891
2737You can also pipe the message through a Unix shell command with the 2892You can also pipe the message through a Unix shell command with the
2738command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix 2893command @kbd{|} (@code{mh-pipe-msg}). You are prompted for the Unix
@@ -2761,6 +2916,8 @@ like to change the initial default directory, customize the option
2761directory for storing the content of these messages. 2916directory for storing the content of these messages.
2762 2917
2763@findex mh-store-buffer 2918@findex mh-store-buffer
2919@kindex @key{RET}
2920@kindex X s
2764 2921
2765By the way, @kbd{X s} calls the Emacs Lisp function 2922By the way, @kbd{X s} calls the Emacs Lisp function
2766@code{mh-store-buffer}. I mention this because you can use it directly 2923@code{mh-store-buffer}. I mention this because you can use it directly
@@ -2781,11 +2938,11 @@ typing @kbd{M-x mh-store-buffer @key{RET} ~ @key{RET}}.
2781@findex mh-next-unread-msg 2938@findex mh-next-unread-msg
2782@findex mh-previous-undeleted-msg 2939@findex mh-previous-undeleted-msg
2783@findex mh-previous-unread-msg 2940@findex mh-previous-unread-msg
2941@kindex g
2784@kindex M-< 2942@kindex M-<
2785@kindex M-> 2943@kindex M->
2786@kindex M-n 2944@kindex M-n
2787@kindex M-p 2945@kindex M-p
2788@kindex g
2789@kindex n 2946@kindex n
2790@kindex p 2947@kindex p
2791 2948
@@ -2809,6 +2966,7 @@ message with @kbd{M-<} (@code{mh-first-msg}) and @kbd{M->}
2809@findex previous-line 2966@findex previous-line
2810@kindex C-n 2967@kindex C-n
2811@kindex C-p 2968@kindex C-p
2969@kindex @key{RET}
2812 2970
2813You can also use the Emacs commands @kbd{C-p} (@code{previous-line}) 2971You can also use the Emacs commands @kbd{C-p} (@code{previous-line})
2814and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in 2972and @kbd{C-n} (@code{next-line}) to move up and down the scan lines in
@@ -2818,6 +2976,8 @@ the MH-Folder window. These commands can be used in conjunction with
2818@cindex deleting messages 2976@cindex deleting messages
2819@findex mh-delete-msg 2977@findex mh-delete-msg
2820@kindex d 2978@kindex d
2979@kindex n
2980@kindex p
2821 2981
2822To mark a message for deletion, use the command @kbd{d} 2982To mark a message for deletion, use the command @kbd{d}
2823(@code{mh-delete-msg}). A @samp{D} is placed by the message in the 2983(@code{mh-delete-msg}). A @samp{D} is placed by the message in the
@@ -2839,7 +2999,11 @@ the message.
2839 2999
2840@findex mh-delete-subject 3000@findex mh-delete-subject
2841@findex mh-delete-subject-or-thread 3001@findex mh-delete-subject-or-thread
3002@findex mh-thread-delete
3003@findex mh-undo
2842@kindex k 3004@kindex k
3005@kindex T d
3006@kindex u
2843 3007
2844And to delete more messages faster, you can use @kbd{k} 3008And to delete more messages faster, you can use @kbd{k}
2845(@code{mh-delete-subject-or-thread}) to delete all the messages with 3009(@code{mh-delete-subject-or-thread}) to delete all the messages with
@@ -2878,6 +3042,8 @@ the command @kbd{M} (@code{mh-modify}). It displays the raw message in
2878an editable buffer. When you are done editing, save and kill the 3042an editable buffer. When you are done editing, save and kill the
2879buffer as you would any other. 3043buffer as you would any other.
2880 3044
3045@findex mh-kill-folder
3046@findex mh-pack-folder
2881@vindex mh-do-not-confirm-flag 3047@vindex mh-do-not-confirm-flag
2882 3048
2883Commands such as @code{mh-pack-folder} prompt to confirm whether to 3049Commands such as @code{mh-pack-folder} prompt to confirm whether to
@@ -2977,7 +3143,11 @@ original configuration is displayed.
2977@node Folders, Sending Mail, Reading Mail, Top 3143@node Folders, Sending Mail, Reading Mail, Top
2978@chapter Organizing Your Mail with Folders 3144@chapter Organizing Your Mail with Folders
2979 3145
3146@cindex @samp{Folder} menu
3147@cindex @samp{Message} menu
2980@cindex folders 3148@cindex folders
3149@cindex menu, @samp{Folder}
3150@cindex menu, @samp{Message}
2981@cindex using folders 3151@cindex using folders
2982 3152
2983This chapter discusses the things you can do with folders within MH-E. 3153This chapter discusses the things you can do with folders within MH-E.
@@ -3231,6 +3401,8 @@ Ticked message face.
3231@samp{To:} face. 3401@samp{To:} face.
3232@end vtable 3402@end vtable
3233 3403
3404@vindex mh-folder-mode-hook
3405
3234The hook @code{mh-folder-mode-hook} is called when visiting a new 3406The hook @code{mh-folder-mode-hook} is called when visiting a new
3235folder in MH-Folder mode. This could be used to set your own key 3407folder in MH-Folder mode. This could be used to set your own key
3236bindings, for example: 3408bindings, for example:
@@ -3285,6 +3457,9 @@ create folders. If you specify a folder that does not exist, you will
3285be prompted to create it. The hook @code{mh-refile-msg-hook} is called 3457be prompted to create it. The hook @code{mh-refile-msg-hook} is called
3286after a message is marked to be refiled. 3458after a message is marked to be refiled.
3287 3459
3460@findex mh-write-msg-to-file
3461@kindex !
3462
3288If you are refiling several messages into the same folder, you can use 3463If you are refiling several messages into the same folder, you can use
3289the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the 3464the command @kbd{!} (@code{mh-refile-or-write-again}) to repeat the
3290last refile or write (for the description of @kbd{>} 3465last refile or write (for the description of @kbd{>}
@@ -3294,6 +3469,8 @@ range in either case (for example, @kbd{C-u o 1 3 5-7 last:5 frombob
3294 3469
3295@cindex expunging refiles and deletes 3470@cindex expunging refiles and deletes
3296@cindex undoing refiles and deletes 3471@cindex undoing refiles and deletes
3472@findex mh-undo
3473@kindex u
3297 3474
3298If you've deleted a message or refiled it, but changed your mind, you 3475If you've deleted a message or refiled it, but changed your mind, you
3299can cancel the action before you've executed it. Use @kbd{u} 3476can cancel the action before you've executed it. Use @kbd{u}
@@ -3301,9 +3478,15 @@ can cancel the action before you've executed it. Use @kbd{u}
3301You can also undo refiles and deletes for messages that are found in a 3478You can also undo refiles and deletes for messages that are found in a
3302given range (@pxref{Ranges}). 3479given range (@pxref{Ranges}).
3303 3480
3481@findex mh-undo-folder
3482@kindex F u
3483
3304Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo 3484Alternatively, you can use @kbd{F u} (@code{mh-undo-folder}) to undo
3305all refiles and deletes in the current folder. 3485all refiles and deletes in the current folder.
3306 3486
3487@findex mh-execute-commands
3488@kindex x
3489
3307If you've marked messages to be deleted or refiled and you want to go 3490If you've marked messages to be deleted or refiled and you want to go
3308ahead and delete or refile the messages, use @kbd{x} 3491ahead and delete or refile the messages, use @kbd{x}
3309(@code{mh-execute-commands}). Many MH-E commands that may affect the 3492(@code{mh-execute-commands}). Many MH-E commands that may affect the
@@ -3312,6 +3495,10 @@ you want to process refiles or deletes first and then either run
3312@kbd{x} for you or undo the pending refiles and deletes, which are 3495@kbd{x} for you or undo the pending refiles and deletes, which are
3313lost. 3496lost.
3314 3497
3498@kindex x
3499@vindex mh-after-commands-processed-hook
3500@vindex mh-before-commands-processed-hook
3501
3315The command @kbd{x} runs @code{mh-before-commands-processed-hook} 3502The command @kbd{x} runs @code{mh-before-commands-processed-hook}
3316before the commands are processed and 3503before the commands are processed and
3317@code{mh-after-commands-processed-hook} after the commands are 3504@code{mh-after-commands-processed-hook} after the commands are
@@ -3323,6 +3510,10 @@ hook include @code{mh-folders-changed}, which lists which folders were
3323affected by deletes and refiles. This list will always include the 3510affected by deletes and refiles. This list will always include the
3324current folder @code{mh-current-folder}. 3511current folder @code{mh-current-folder}.
3325 3512
3513@findex mh-copy-msg
3514@kindex c
3515@kindex o
3516
3326If you wish to copy a message to another folder, you can use the 3517If you wish to copy a message to another folder, you can use the
3327command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument 3518command @kbd{c} (@code{mh-copy-msg}) (see the @option{-link} argument
3328to @command{refile}(1)). Like the command @kbd{o}, this command 3519to @command{refile}(1)). Like the command @kbd{o}, this command
@@ -3331,12 +3522,14 @@ range (@pxref{Ranges}). Note that unlike the command @kbd{o}, the copy
3331takes place immediately. The original copy remains in the current 3522takes place immediately. The original copy remains in the current
3332folder. 3523folder.
3333 3524
3334@cindex MH-Folder Show mode
3335@cindex MH-Folder mode
3336@cindex junk mail 3525@cindex junk mail
3526@cindex MH-Folder mode
3527@cindex MH-Folder Show mode
3337@cindex modes, MH-Folder 3528@cindex modes, MH-Folder
3338@cindex modes, MH-Folder Show 3529@cindex modes, MH-Folder Show
3339@cindex spam 3530@cindex spam
3531@findex mh-toggle-showing
3532@kindex t
3340 3533
3341The command @kbd{t} (@code{mh-toggle-showing}) switches between 3534The command @kbd{t} (@code{mh-toggle-showing}) switches between
3342MH-Folder mode and MH-Folder Show mode@footnote{For you Emacs wizards, 3535MH-Folder mode and MH-Folder Show mode@footnote{For you Emacs wizards,
@@ -3351,6 +3544,7 @@ folder for later examination.
3351@cindex modes, MH-Folder 3544@cindex modes, MH-Folder
3352@cindex modes, MH-Show 3545@cindex modes, MH-Show
3353@cindex moving between messages 3546@cindex moving between messages
3547@kindex t
3354@vindex mh-recenter-summary-flag 3548@vindex mh-recenter-summary-flag
3355 3549
3356When you use @kbd{t} to toggle between show mode and scan mode, the 3550When you use @kbd{t} to toggle between show mode and scan mode, the
@@ -3360,6 +3554,10 @@ causes the toggle to display as many scan lines as possible, with the
3360cursor at the middle. The effect of @code{mh-recenter-summary-flag} is 3554cursor at the middle. The effect of @code{mh-recenter-summary-flag} is
3361rather useful, but it can be annoying on a slow network connection. 3555rather useful, but it can be annoying on a slow network connection.
3362 3556
3557@findex mh-visit-folder
3558@kindex F v
3559@vindex mh-large-folder
3560
3363When you want to read the messages that you have refiled into folders, 3561When you want to read the messages that you have refiled into folders,
3364use the command @kbd{F v} (@code{mh-visit-folder}) to visit the 3562use the command @kbd{F v} (@code{mh-visit-folder}) to visit the
3365folder. You are prompted for the folder name. The folder buffer will 3563folder. You are prompted for the folder name. The folder buffer will
@@ -3373,15 +3571,18 @@ to specify the range and @code{mh-large-folder} is ignored. Note that
3373this command can also be used to create folders. If you specify a 3571this command can also be used to create folders. If you specify a
3374folder that does not exist, you will be prompted to create it. 3572folder that does not exist, you will be prompted to create it.
3375 3573
3574@findex mh-search
3575@kindex F s
3576
3376If you forget where you've refiled your messages, you can find them 3577If you forget where you've refiled your messages, you can find them
3377using @kbd{F s} (@code{mh-search}). @xref{Searching}. 3578using @kbd{F s} (@code{mh-search}). @xref{Searching}.
3378 3579
3379@cindex @command{procmail} 3580@cindex @command{procmail}
3380@cindex @command{rcvstore} 3581@cindex @command{rcvstore}
3381@cindex @samp{unseen} sequence
3382@cindex MH commands, @command{rcvstore} 3582@cindex MH commands, @command{rcvstore}
3383@cindex Unix commands, @command{procmail} 3583@cindex @samp{unseen} sequence
3384@cindex sequence, @samp{unseen} 3584@cindex sequence, @samp{unseen}
3585@cindex Unix commands, @command{procmail}
3385@cindex unseen messages, viewing 3586@cindex unseen messages, viewing
3386@findex mh-index-new-messages 3587@findex mh-index-new-messages
3387@kindex F n 3588@kindex F n
@@ -3399,6 +3600,9 @@ folders, or nothing to search all folders.
3399@cindex @samp{tick} sequence 3600@cindex @samp{tick} sequence
3400@cindex sequence, @samp{tick} 3601@cindex sequence, @samp{tick}
3401@cindex ticked messages, viewing 3602@cindex ticked messages, viewing
3603@findex mh-index-ticked-messages
3604@kindex F '
3605@vindex mh-ticked-messages-folders
3402 3606
3403If you have ticked messages (@pxref{Sequences}), you can display them 3607If you have ticked messages (@pxref{Sequences}), you can display them
3404using the command @kbd{F '} (@code{mh-index-ticked-messages}). All 3608using the command @kbd{F '} (@code{mh-index-ticked-messages}). All
@@ -3417,14 +3621,28 @@ You can display messages in any sequence with the command @kbd{F q}
3417With a prefix argument, enter a space-separated list of folders at the 3621With a prefix argument, enter a space-separated list of folders at the
3418prompt, or nothing to search all folders. 3622prompt, or nothing to search all folders.
3419 3623
3624@vindex mh-new-messages-folders
3625@vindex mh-recursive-folders-flag
3626@vindex mh-ticked-messages-folders
3627
3420Set the options @code{mh-new-messages-folders} and 3628Set the options @code{mh-new-messages-folders} and
3421@code{mh-ticked-messages-folders} to @samp{Inbox} to search the 3629@code{mh-ticked-messages-folders} to @samp{Inbox} to search the
3422@samp{+inbox} folder or @samp{All} to search all of the top level 3630@samp{+inbox} folder or @samp{All} to search all of the top level
3423folders. Otherwise, list the folders that should be searched with the 3631folders. Otherwise, list the folders that should be searched with the
3424@samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}. 3632@samp{Choose Folders} menu item. See @code{mh-recursive-folders-flag}.
3425 3633
3426@cindex @samp{*MH-E Folders*}
3427@cindex buffers, @samp{*MH-E Folders*} 3634@cindex buffers, @samp{*MH-E Folders*}
3635@cindex @samp{*MH-E Folders*}
3636@findex mh-kill-folder
3637@findex mh-list-folders
3638@findex mh-pack-folder
3639@findex mh-rescan-folder
3640@findex mh-sort-folder
3641@kindex F k
3642@kindex F l
3643@kindex F p
3644@kindex F r
3645@kindex F S
3428 3646
3429Other commands you can perform on folders include: @kbd{F l} 3647Other commands you can perform on folders include: @kbd{F l}
3430(@code{mh-list-folders}), to place a listing of all the folders in 3648(@code{mh-list-folders}), to place a listing of all the folders in
@@ -3439,11 +3657,16 @@ to rescan the folder, which is useful to grab all messages in your
3439you don't want to rescan the entire folder, the commands @kbd{F r} or 3657you don't want to rescan the entire folder, the commands @kbd{F r} or
3440@kbd{F p} will accept a range (@pxref{Ranges}). 3658@kbd{F p} will accept a range (@pxref{Ranges}).
3441 3659
3660@kindex @key{TAB}
3661@vindex mh-recursive-folders-flag
3662
3442By default, operations on folders work only one level at a time. Set 3663By default, operations on folders work only one level at a time. Set
3443@code{mh-recursive-folders-flag} to non-@code{nil} to operate on all 3664@code{mh-recursive-folders-flag} to non-@code{nil} to operate on all
3444folders. This mostly means that you'll be able to see all your folders 3665folders. This mostly means that you'll be able to see all your folders
3445when you press @key{TAB} when prompted for a folder name. 3666when you press @key{TAB} when prompted for a folder name.
3446 3667
3668@findex mh-search-p
3669@kindex k
3447@vindex mh-kill-folder-suppress-prompt-hooks 3670@vindex mh-kill-folder-suppress-prompt-hooks
3448 3671
3449The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal 3672The hook @code{mh-kill-folder-suppress-prompt-hooks} is an abnormal
@@ -3466,10 +3689,12 @@ Use this hook with care. If there is a bug in your hook which returns
3466 3689
3467@cindex @command{sortm} 3690@cindex @command{sortm}
3468@cindex @file{.mh_profile} 3691@cindex @file{.mh_profile}
3469@cindex @samp{sortm:} MH profile component 3692@cindex files, @file{.mh_profile}
3470@cindex MH commands, @command{sortm} 3693@cindex MH commands, @command{sortm}
3471@cindex MH profile component, @samp{sortm:} 3694@cindex MH profile component, @samp{sortm:}
3472@cindex files, @file{.mh_profile} 3695@cindex @samp{sortm:} MH profile component
3696@kindex F S
3697@vindex mh-sortm-args
3473 3698
3474The option @code{mh-sortm-args} holds extra arguments to pass on to 3699The option @code{mh-sortm-args} holds extra arguments to pass on to
3475the command @command{sortm}@footnote{See the section 3700the command @command{sortm}@footnote{See the section
@@ -3481,7 +3706,8 @@ This option may be used to provide an alternate view. For example,
3481 3706
3482@cindex exiting 3707@cindex exiting
3483@cindex quitting 3708@cindex quitting
3484@findex mh-rmail 3709@findex mh-quit
3710@kindex q
3485 3711
3486When you want to quit using MH-E and go back to editing, you can use 3712When you want to quit using MH-E and go back to editing, you can use
3487the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the 3713the @kbd{q} (@code{mh-quit}) command. This buries the buffers of the
@@ -3492,18 +3718,20 @@ buffers whose name begins with @samp{ *mh-} or @samp{*MH-E }
3492selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail} 3718selecting the @samp{+inbox} buffer or by running @kbd{M-x mh-rmail}
3493again. 3719again.
3494 3720
3721@findex mh-execute-commands
3722@kindex q
3495@vindex mh-before-quit-hook 3723@vindex mh-before-quit-hook
3496@vindex mh-quit-hook 3724@vindex mh-quit-hook
3497 3725
3498The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are 3726The two hooks @code{mh-before-quit-hook} and @code{mh-quit-hook} are
3499called by @kbd{q} (@code{mh-quit}). The former one is called before 3727called by @kbd{q}. The former one is called before the quit occurs, so
3500the quit occurs, so you might use it to perform any MH-E operations; 3728you might use it to perform any MH-E operations; you could perform
3501you could perform some query and abort the quit or call 3729some query and abort the quit or call @code{mh-execute-commands}, for
3502@code{mh-execute-commands}, for example. The latter is not run in an 3730example. The latter is not run in an MH-E context, so you might use it
3503MH-E context, so you might use it to modify the window setup. For 3731to modify the window setup. For example, if the window configuration
3504example, if the window configuration was saved as in the example in 3732was saved as in the example in @ref{Miscellaneous Commands and
3505@ref{Miscellaneous Commands and Options}, you would also want to set 3733Options}, you would also want to set @code{mh-quit-hook} to the
3506@code{mh-quit-hook} to the following: 3734following:
3507 3735
3508@c XXX Replace this with my example for killing the mail buffers. 3736@c XXX Replace this with my example for killing the mail buffers.
3509 3737
@@ -3525,8 +3753,8 @@ example, if the window configuration was saved as in the example in
3525 3753
3526@cindex folders, renaming 3754@cindex folders, renaming
3527@cindex renaming folders 3755@cindex renaming folders
3756@findex dired
3528@findex dired-do-rename 3757@findex dired-do-rename
3529@kindex R
3530 3758
3531You can use dired to manipulate the folders themselves. For example, I 3759You can use dired to manipulate the folders themselves. For example, I
3532renamed my @samp{+out} folder to the more common @samp{+outbox} by 3760renamed my @samp{+out} folder to the more common @samp{+outbox} by
@@ -3539,6 +3767,7 @@ moving my cursor to @samp{out} and using the command @kbd{R}
3539 3767
3540@cindex sending mail 3768@cindex sending mail
3541@findex mh-smail 3769@findex mh-smail
3770@kindex M-x mh-smail
3542 3771
3543You can send a mail message in several ways. You can call @kbd{M-x 3772You can send a mail message in several ways. You can call @kbd{M-x
3544mh-smail} directly, or from the command line like this: 3773mh-smail} directly, or from the command line like this:
@@ -3557,6 +3786,9 @@ There are some commands that need to send a mail message, such as
3557commands use MH-E by setting the option @code{mail-user-agent} to 3786commands use MH-E by setting the option @code{mail-user-agent} to
3558@samp{Emacs interface to MH}. 3787@samp{Emacs interface to MH}.
3559 3788
3789@cindex @samp{Message} menu
3790@cindex menu, @samp{Message}
3791
3560From within MH-E's MH-Folder mode, other methods of sending mail are 3792From within MH-E's MH-Folder mode, other methods of sending mail are
3561available as well. These can also be found in the @samp{Message} menu. 3793available as well. These can also be found in the @samp{Message} menu.
3562 3794
@@ -3688,6 +3920,8 @@ in the following sections.
3688@cindex sending mail 3920@cindex sending mail
3689@findex mh-smail 3921@findex mh-smail
3690@findex mh-smail-other-window 3922@findex mh-smail-other-window
3923@kindex M-x mh-smail
3924@kindex M-x mh-smail-other-window
3691 3925
3692Outside of an MH-Folder buffer, you must call either @kbd{M-x 3926Outside of an MH-Folder buffer, you must call either @kbd{M-x
3693mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message. 3927mh-smail} or @kbd{M-x mh-smail-other-window} to compose a new message.
@@ -3701,8 +3935,8 @@ following key bindings to @file{~/.emacs} useful:
3701(global-set-key "\C-x4m" 'mh-smail-other-window) 3935(global-set-key "\C-x4m" 'mh-smail-other-window)
3702@end smalllisp 3936@end smalllisp
3703 3937
3704@cindex MH-Letter mode
3705@cindex draft folder 3938@cindex draft folder
3939@cindex MH-Letter mode
3706@cindex modes, MH-Letter 3940@cindex modes, MH-Letter
3707@findex mh-send 3941@findex mh-send
3708@kindex m 3942@kindex m
@@ -3726,8 +3960,8 @@ If you prefer to be prompted for the recipient and subject fields
3726before the MH-Letter buffer appears, turn on the option 3960before the MH-Letter buffer appears, turn on the option
3727@code{mh-compose-prompt-flag}. 3961@code{mh-compose-prompt-flag}.
3728 3962
3729@cindex @samp{X-Mailer:} header field
3730@cindex header field, @samp{X-Mailer:} 3963@cindex header field, @samp{X-Mailer:}
3964@cindex @samp{X-Mailer:} header field
3731@vindex mh-insert-x-mailer-flag 3965@vindex mh-insert-x-mailer-flag
3732 3966
3733MH-E adds an @samp{X-Mailer:} header field to the header that includes 3967MH-E adds an @samp{X-Mailer:} header field to the header that includes
@@ -3738,8 +3972,10 @@ participate in our marketing, you can turn off the option
3738@cindex @command{repl} 3972@cindex @command{repl}
3739@cindex @file{components} 3973@cindex @file{components}
3740@cindex MH commands, @command{repl} 3974@cindex MH commands, @command{repl}
3975@cindex MH-Letter mode
3741@cindex Mail mode 3976@cindex Mail mode
3742@cindex files, @file{components} 3977@cindex files, @file{components}
3978@cindex modes, MH-Letter
3743@cindex modes, Mail 3979@cindex modes, Mail
3744@vindex mail-mode-hook 3980@vindex mail-mode-hook
3745@vindex mh-letter-mode-hook 3981@vindex mh-letter-mode-hook
@@ -3754,9 +3990,7 @@ order) before @code{mh-letter-mode-hook}.}. For example, you may wish
3754to modify the header after @command{repl} has done its work, or you 3990to modify the header after @command{repl} has done its work, or you
3755may have a complicated @file{components} file and need to tell MH-E 3991may have a complicated @file{components} file and need to tell MH-E
3756where the cursor should go. Here's an example of how you would use 3992where the cursor should go. Here's an example of how you would use
3757this hook. You can add the hook using @code{add-hook} or by running 3993this hook.
3758@kbd{M-x customize-option @key{RET} mh-letter-mode-hook
3759@key{RET}}---all of the other hooks are set in a similar fashion.
3760 3994
3761@findex mh-insert-signature, example 3995@findex mh-insert-signature, example
3762 3996
@@ -3780,8 +4014,6 @@ this hook. You can add the hook using @code{add-hook} or by running
3780 (goto-char (point-max)) ; @r{go to end of message to} 4014 (goto-char (point-max)) ; @r{go to end of message to}
3781 (mh-insert-signature))) ; @r{insert signature} 4015 (mh-insert-signature))) ; @r{insert signature}
3782 4016
3783(add-hook 'mh-letter-mode-hook 'my-mh-letter-mode-hook)
3784
3785@i{Prepare draft for editing via mh-letter-mode-hook} 4017@i{Prepare draft for editing via mh-letter-mode-hook}
3786 4018
3787@end group 4019@end group
@@ -3791,6 +4023,7 @@ The function, @code{add-enriched-text} is defined in the example in
3791@ref{Adding Attachments}. 4023@ref{Adding Attachments}.
3792 4024
3793@vindex mh-compose-letter-function 4025@vindex mh-compose-letter-function
4026@vindex mh-letter-mode-hook
3794 4027
3795The second hook, a function really, is 4028The second hook, a function really, is
3796@code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it 4029@code{mh-compose-letter-function}. Like @code{mh-letter-mode-hook}, it
@@ -3869,6 +4102,8 @@ no effect.
3869Another way to include the message automatically in your draft is to 4102Another way to include the message automatically in your draft is to
3870use @samp{repl: -filter repl.filter} in your MH profile. 4103use @samp{repl: -filter repl.filter} in your MH profile.
3871 4104
4105@vindex mh-reply-show-message-flag
4106
3872If you include the message automatically, you can hide the MH-Show 4107If you include the message automatically, you can hide the MH-Show
3873buffer by turning off the option @code{mh-reply-show-message-flag}. 4108buffer by turning off the option @code{mh-reply-show-message-flag}.
3874 4109
@@ -3888,9 +4123,9 @@ recipients in the draft.
3888@section Forwarding Mail 4123@section Forwarding Mail
3889 4124
3890@cindex @command{forw} 4125@cindex @command{forw}
3891@cindex MH commands, @command{forw}
3892@cindex draft 4126@cindex draft
3893@cindex forwarding 4127@cindex forwarding
4128@cindex MH commands, @command{forw}
3894@findex mh-forward 4129@findex mh-forward
3895@kindex f 4130@kindex f
3896@vindex mh-forward-hook 4131@vindex mh-forward-hook
@@ -3906,9 +4141,9 @@ All of the messages in the range are inserted into your draft. The
3906hook @code{mh-forward-hook} is called on the draft. 4141hook @code{mh-forward-hook} is called on the draft.
3907 4142
3908@cindex @file{.mh_profile} 4143@cindex @file{.mh_profile}
3909@cindex @samp{forw:} MH profile component
3910@cindex MH profile component, @samp{forw:}
3911@cindex files, @file{.mh_profile} 4144@cindex files, @file{.mh_profile}
4145@cindex MH profile component, @samp{forw:}
4146@cindex @samp{forw:} MH profile component
3912@vindex mh-compose-forward-as-mime-flag 4147@vindex mh-compose-forward-as-mime-flag
3913 4148
3914By default, the option @code{mh-compose-forward-as-mime-flag} is on 4149By default, the option @code{mh-compose-forward-as-mime-flag} is on
@@ -3959,6 +4194,9 @@ does it add your name to the @samp{From:} header field. It appears to
3959the recipient as if the message had come from the original sender. 4194the recipient as if the message had come from the original sender.
3960When you run this command, you are prompted for the recipients. 4195When you run this command, you are prompted for the recipients.
3961 4196
4197@findex mh-edit-again
4198@kindex e
4199
3962For more information on redistributing messages, see 4200For more information on redistributing messages, see
3963@command{dist}(1). Also investigate the command @kbd{e} 4201@command{dist}(1). Also investigate the command @kbd{e}
3964(@code{mh-edit-again}) for another way to redistribute messages 4202(@code{mh-edit-again}) for another way to redistribute messages
@@ -3985,7 +4223,9 @@ a message that has been redistributed before, turn off this option.
3985@cindex files, @file{draft} 4223@cindex files, @file{draft}
3986@cindex re-editing drafts 4224@cindex re-editing drafts
3987@findex mh-edit-again 4225@findex mh-edit-again
4226@kindex F v drafts
3988@kindex e 4227@kindex e
4228@kindex n
3989 4229
3990If you don't complete a draft for one reason or another, and if the 4230If you don't complete a draft for one reason or another, and if the
3991draft buffer is no longer available, you can pick your draft up again 4231draft buffer is no longer available, you can pick your draft up again
@@ -3995,11 +4235,14 @@ folders, you'll need to visit the draft folder with @kbd{F v drafts
3995@key{RET}}, use @kbd{n} to move to the appropriate message, and then 4235@key{RET}}, use @kbd{n} to move to the appropriate message, and then
3996use @kbd{e} to prepare the message for editing. 4236use @kbd{e} to prepare the message for editing.
3997 4237
4238@kindex e
4239
3998The @kbd{e} command can also be used to take messages that were sent 4240The @kbd{e} command can also be used to take messages that were sent
3999to you and to send them to more people. 4241to you and to send them to more people.
4000 4242
4001@cindex Mailer-Daemon 4243@cindex Mailer-Daemon
4002@findex mh-extract-rejected-mail 4244@findex mh-extract-rejected-mail
4245@kindex C-c C-c
4003@kindex E 4246@kindex E
4004 4247
4005Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who 4248Don't use @kbd{e} to re-edit a message from a @i{Mailer-Daemon} who
@@ -4012,9 +4255,11 @@ send the message again with @kbd{C-c C-c}.
4012@node Editing Drafts, Aliases, Sending Mail, Top 4255@node Editing Drafts, Aliases, Sending Mail, Top
4013@chapter Editing a Draft 4256@chapter Editing a Draft
4014 4257
4258@cindex @samp{Letter} menu
4015@cindex MH-Letter mode 4259@cindex MH-Letter mode
4016@cindex draft 4260@cindex draft
4017@cindex editing draft 4261@cindex editing draft
4262@cindex menu, @samp{Letter}
4018@cindex modes, MH-Letter 4263@cindex modes, MH-Letter
4019 4264
4020When you edit a message that you want to send (called a @dfn{draft} in 4265When you edit a message that you want to send (called a @dfn{draft} in
@@ -4449,8 +4694,8 @@ draft. @xref{Folder Selection}.
4449@findex indent-relative 4694@findex indent-relative
4450@findex mh-letter-next-header-field-or-indent 4695@findex mh-letter-next-header-field-or-indent
4451@findex mh-letter-previous-header-field 4696@findex mh-letter-previous-header-field
4452@kindex S-@key{TAB}
4453@kindex @key{TAB} 4697@kindex @key{TAB}
4698@kindex S-@key{TAB}
4454@vindex mh-compose-skipped-header-fields 4699@vindex mh-compose-skipped-header-fields
4455@vindex mh-letter-header-field 4700@vindex mh-letter-header-field
4456 4701
@@ -4476,8 +4721,10 @@ take point to the last field from anywhere in the body.
4476@findex mh-letter-complete-or-space 4721@findex mh-letter-complete-or-space
4477@findex mh-letter-confirm-address 4722@findex mh-letter-confirm-address
4478@kindex , (comma) 4723@kindex , (comma)
4479@kindex M-@key{TAB}
4480@kindex @key{SPC} 4724@kindex @key{SPC}
4725@kindex M-@key{TAB}
4726@vindex mh-alias-flash-on-comma
4727@vindex mh-compose-space-does-completion-flag
4481@vindex mh-letter-complete-function 4728@vindex mh-letter-complete-function
4482 4729
4483If the field contains addresses (for example, @samp{To:} or 4730If the field contains addresses (for example, @samp{To:} or
@@ -4496,10 +4743,11 @@ press the comma, the command @code{mh-letter-confirm-address} flashes
4496the alias expansion in the minibuffer if 4743the alias expansion in the minibuffer if
4497@code{mh-alias-flash-on-comma} is turned on. 4744@code{mh-alias-flash-on-comma} is turned on.
4498 4745
4499@kindex C-c C-t
4500@findex mh-letter-toggle-header-field-display
4501@c XXX Document the replacement for the inaccessible 'long argument. 4746@c XXX Document the replacement for the inaccessible 'long argument.
4502 4747
4748@findex mh-letter-toggle-header-field-display
4749@kindex C-c C-t
4750
4503Use the command @kbd{C-c C-t} 4751Use the command @kbd{C-c C-t}
4504@code{mh-letter-toggle-header-field-display} to display truncated 4752@code{mh-letter-toggle-header-field-display} to display truncated
4505header fields. This command is a toggle so entering it again will hide 4753header fields. This command is a toggle so entering it again will hide
@@ -4582,6 +4830,7 @@ the first period in the paragraph above, the result would be this:
4582@cindex yanking messages 4830@cindex yanking messages
4583@findex mh-yank-cur-msg 4831@findex mh-yank-cur-msg
4584@kindex C-c C-y 4832@kindex C-c C-y
4833@vindex mh-ins-buf-prefix
4585 4834
4586It is often useful to insert a snippet of text from a letter that 4835It is often useful to insert a snippet of text from a letter that
4587someone mailed to provide some context for your reply. The command 4836someone mailed to provide some context for your reply. The command
@@ -4608,7 +4857,9 @@ followed by the content of the option
4608@samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use 4857@samp{wrote:}, @samp{a écrit:}, and @samp{schrieb:}. You can also use
4609the @samp{Custom String} menu item to enter your own verb. 4858the @samp{Custom String} menu item to enter your own verb.
4610 4859
4860@vindex mail-citation-hook
4611@vindex mh-ins-buf-prefix 4861@vindex mh-ins-buf-prefix
4862@vindex mh-yank-behavior
4612 4863
4613The prefix @code{"> "} is the default setting for the option 4864The prefix @code{"> "} is the default setting for the option
4614@code{mh-ins-buf-prefix}. I suggest that you not modify this option 4865@code{mh-ins-buf-prefix}. I suggest that you not modify this option
@@ -4624,9 +4875,11 @@ You can also turn on the @code{mh-delete-yanked-msg-window-flag}
4624option to delete the window containing the original message after 4875option to delete the window containing the original message after
4625yanking it to make more room on your screen for your reply. 4876yanking it to make more room on your screen for your reply.
4626 4877
4627@vindex mh-yank-behavior
4628@cindex Emacs, packages, supercite 4878@cindex Emacs, packages, supercite
4629@cindex supercite package 4879@cindex supercite package
4880@kindex r
4881@vindex mail-citation-hook
4882@vindex mh-yank-behavior
4630 4883
4631You can control how the message to which you are replying is yanked 4884You can control how the message to which you are replying is yanked
4632into your reply using @code{mh-yank-behavior}. To include the entire 4885into your reply using @code{mh-yank-behavior}. To include the entire
@@ -4644,11 +4897,16 @@ Choose @samp{Invoke supercite}@footnote{@emph{Supercite} is a
4644full-bodied, full-featured, citation package that comes standard with 4897full-bodied, full-featured, citation package that comes standard with
4645Emacs.} to pass the entire message and header through supercite. 4898Emacs.} to pass the entire message and header through supercite.
4646 4899
4900@vindex mh-extract-from-attribution-verb
4901
4647If the @samp{Body With Attribution} setting is used, then the message 4902If the @samp{Body With Attribution} setting is used, then the message
4648minus the header is yanked and a simple attribution line is added at 4903minus the header is yanked and a simple attribution line is added at
4649the top using the value of the option 4904the top using the value of the option
4650@code{mh-extract-from-attribution-verb}. This is the default. 4905@code{mh-extract-from-attribution-verb}. This is the default.
4651 4906
4907@kindex C-c C-y
4908@vindex mh-delete-yanked-msg-window-flag
4909
4652If the @samp{Invoke supercite} or @samp{Body With Attribution} 4910If the @samp{Invoke supercite} or @samp{Body With Attribution}
4653settings are used, the @samp{-noformat} argument is passed to the 4911settings are used, the @samp{-noformat} argument is passed to the
4654@command{repl} program to override a @samp{-filter} or @samp{-format} 4912@command{repl} program to override a @samp{-filter} or @samp{-format}
@@ -4660,12 +4918,16 @@ People who use the automatic variants tend to turn on the option
4660@code{mh-delete-yanked-msg-window-flag} as well so that the show 4918@code{mh-delete-yanked-msg-window-flag} as well so that the show
4661window is never displayed. 4919window is never displayed.
4662 4920
4921@vindex mh-yank-behavior
4922
4663If the show buffer has a region, the option @code{mh-yank-behavior} is 4923If the show buffer has a region, the option @code{mh-yank-behavior} is
4664ignored unless its value is one of @samp{Attribution} variants in 4924ignored unless its value is one of @samp{Attribution} variants in
4665which case the attribution is added to the yanked region. 4925which case the attribution is added to the yanked region.
4666 4926
4667@findex trivial-cite 4927@findex trivial-cite
4668@vindex mail-citation-hook 4928@vindex mail-citation-hook
4929@vindex mh-ins-buf-prefix
4930@vindex mh-yank-behavior
4669 4931
4670If this isn't enough, you can gain full control over the appearance of 4932If this isn't enough, you can gain full control over the appearance of
4671the included text by setting @code{mail-citation-hook} to a function 4933the included text by setting @code{mail-citation-hook} to a function
@@ -4677,6 +4939,10 @@ and it should leave point and mark around the modified citation text
4677for the next hook function. The standard prefix 4939for the next hook function. The standard prefix
4678@code{mh-ins-buf-prefix} is not added if this hook is set. 4940@code{mh-ins-buf-prefix} is not added if this hook is set.
4679 4941
4942@cindex Emacs, packages, trivial-cite
4943@cindex trivial-cite package
4944@vindex mh-yank-behavior
4945
4680For example, if you use the hook function 4946For example, if you use the hook function
4681@uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html, 4947@uref{http://shasta.cs.uiuc.edu/~lrclause/tc.html,
4682@code{trivial-cite}} (which is NOT part of Emacs), set 4948@code{trivial-cite}} (which is NOT part of Emacs), set
@@ -4691,6 +4957,7 @@ For example, if you use the hook function
4691@kindex C-c C-i 4957@kindex C-c C-i
4692@vindex mh-ins-buf-prefix 4958@vindex mh-ins-buf-prefix
4693@vindex mh-invisible-header-fields-compiled 4959@vindex mh-invisible-header-fields-compiled
4960@vindex mh-yank-behavior
4694 4961
4695Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}). 4962Messages can be inserted with @kbd{C-c C-i} (@code{mh-insert-letter}).
4696This command prompts you for the folder and message number, which 4963This command prompts you for the folder and message number, which
@@ -4717,8 +4984,8 @@ letter and point after it.
4717You can insert your signature at the current cursor location with the 4984You can insert your signature at the current cursor location with the
4718command @kbd{C-c C-s} (@code{mh-insert-signature}). 4985command @kbd{C-c C-s} (@code{mh-insert-signature}).
4719 4986
4720@cindex @file{.signature}
4721@cindex files, @file{.signature} 4987@cindex files, @file{.signature}
4988@cindex @file{.signature}
4722@cindex vCard 4989@cindex vCard
4723@vindex mh-signature-file-name 4990@vindex mh-signature-file-name
4724 4991
@@ -4728,6 +4995,7 @@ option @code{mh-signature-file-name}. This file may contain a
4728@dfn{vCard} in which case an attachment is added with the vCard. 4995@dfn{vCard} in which case an attachment is added with the vCard.
4729 4996
4730@findex mh-signature-separator-p 4997@findex mh-signature-separator-p
4998@vindex mh-signature-file-name
4731@vindex mh-signature-separator 4999@vindex mh-signature-separator
4732@vindex mh-signature-separator-regexp 5000@vindex mh-signature-separator-regexp
4733 5001
@@ -4751,6 +5019,7 @@ signature differently, and to suppress the signature when replying or
4751yanking a letter into a draft. 5019yanking a letter into a draft.
4752 5020
4753@vindex mh-insert-signature-hook 5021@vindex mh-insert-signature-hook
5022@vindex mh-signature-file-name
4754 5023
4755The hook @code{mh-insert-signature-hook} is run after the signature is 5024The hook @code{mh-insert-signature-hook} is run after the signature is
4756inserted. Hook functions may access the actual name of the file or the 5025inserted. Hook functions may access the actual name of the file or the
@@ -4802,6 +5071,8 @@ resolution, color, @samp{Face:} header field.
4802The URL of any image can be used for the @samp{X-Image-URL:} field and 5071The URL of any image can be used for the @samp{X-Image-URL:} field and
4803no processing of the image is required. 5072no processing of the image is required.
4804 5073
5074@vindex mh-x-face-file
5075
4805To prevent the setting of any of these header fields, either set 5076To prevent the setting of any of these header fields, either set
4806@code{mh-x-face-file} to @code{nil}, or simply ensure that the file 5077@code{mh-x-face-file} to @code{nil}, or simply ensure that the file
4807defined by this option doesn't exist. 5078defined by this option doesn't exist.
@@ -4826,6 +5097,8 @@ protocol@footnote{@sc{mime} is defined in
4826binary files, and even commands that fetch a file with @samp{ftp} when 5097binary files, and even commands that fetch a file with @samp{ftp} when
4827your recipient reads the message! 5098your recipient reads the message!
4828 5099
5100@kindex C-c C-m
5101
4829If you were to create a multimedia message with plain MH commands, you 5102If you were to create a multimedia message with plain MH commands, you
4830would insert @command{mhbuild} or @command{mhn} directives (henceforth 5103would insert @command{mhbuild} or @command{mhn} directives (henceforth
4831called @dfn{MH-style directives} into your draft and use the 5104called @dfn{MH-style directives} into your draft and use the
@@ -4871,8 +5144,8 @@ whereas others require you to enter one.
4871 5144
4872@cindex @command{file} 5145@cindex @command{file}
4873@cindex @file{/etc/mime.types} 5146@cindex @file{/etc/mime.types}
4874@cindex Unix commands, @command{file}
4875@cindex files, @file{/etc/mime.types} 5147@cindex files, @file{/etc/mime.types}
5148@cindex Unix commands, @command{file}
4876@findex mailcap-mime-types 5149@findex mailcap-mime-types
4877 5150
4878In the cases where MH-E can do so, it will determine the media type 5151In the cases where MH-E can do so, it will determine the media type
@@ -4952,16 +5225,17 @@ You may also be interested in investigating @code{sgml-mode}.
4952 5225
4953@subheading Including Files 5226@subheading Including Files
4954 5227
5228@cindex attachments, inserting
5229@cindex images
4955@cindex MIME, images 5230@cindex MIME, images
4956@cindex MIME, sound 5231@cindex MIME, sound
4957@cindex MIME, video 5232@cindex MIME, video
4958@cindex attachments, inserting
4959@cindex images
4960@cindex sound 5233@cindex sound
4961@cindex video 5234@cindex video
4962@findex mh-compose-insertion 5235@findex mh-compose-insertion
4963@kindex C-c C-m C-i 5236@kindex C-c C-m C-i
4964@kindex C-c C-m i 5237@kindex C-c C-m i
5238@vindex mh-compose-insertion
4965 5239
4966Binaries, images, sound, and video can be inserted in your message 5240Binaries, images, sound, and video can be inserted in your message
4967with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You 5241with the command @kbd{C-c C-m C-i} (@code{mh-compose-insertion}). You
@@ -5004,7 +5278,9 @@ host and filename, the media type, and the content description.
5004@cindex MIME, @command{tar} 5278@cindex MIME, @command{tar}
5005@cindex Unix commands, @command{ftp} 5279@cindex Unix commands, @command{ftp}
5006@cindex Unix commands, @command{tar} 5280@cindex Unix commands, @command{tar}
5281@findex mh-mh-compose-anon-ftp
5007@findex mh-mh-compose-external-compressed-tar 5282@findex mh-mh-compose-external-compressed-tar
5283@kindex C-c C-m C-g
5008@kindex C-c C-m C-t 5284@kindex C-c C-m C-t
5009@kindex C-c C-m t 5285@kindex C-c C-m t
5010 5286
@@ -5065,6 +5341,9 @@ disposition=inline description="SETI@@home logo">
5065Typically, you send a message with attachments just like any other 5341Typically, you send a message with attachments just like any other
5066message (@pxref{Sending Message}). 5342message (@pxref{Sending Message}).
5067 5343
5344@findex mh-mml-to-mime
5345@kindex C-c C-m C-m
5346
5068However, you may take a sneak preview of the @sc{mime} encoding if you 5347However, you may take a sneak preview of the @sc{mime} encoding if you
5069wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}). 5348wish by running the command @kbd{C-c C-m C-m} (@code{mh-mml-to-mime}).
5070The following screen shows the @sc{mime} encoding specified by the 5349The following screen shows the @sc{mime} encoding specified by the
@@ -5097,15 +5376,19 @@ LyogWFBNICovCnN0YXRpYyBjaGFyICogc2V0aWF0aG9tZV94cG1bXSA9IHsKIjQ1IDQ1IDc2NCAy
5097@end cartouche 5376@end cartouche
5098@i{MH-E @sc{mime} draft ready to send} 5377@i{MH-E @sc{mime} draft ready to send}
5099 5378
5379@cindex undo effects of mh-mml-to-mime
5380
5100This action can be undone by running @kbd{C-_} (@code{undo}). 5381This action can be undone by running @kbd{C-_} (@code{undo}).
5101 5382
5102@cindex @command{mhbuild} 5383@cindex @command{mhbuild}
5103@cindex @command{mhn} 5384@cindex @command{mhn}
5104@cindex MH commands, @command{mhbuild} 5385@cindex MH commands, @command{mhbuild}
5105@cindex MH commands, @command{mhn} 5386@cindex MH commands, @command{mhn}
5387@cindex undo effects of mh-mh-to-mime
5106@findex mh-mh-to-mime 5388@findex mh-mh-to-mime
5107@findex mh-mh-to-mime-undo 5389@findex mh-mh-to-mime-undo
5108@kindex C-c C-e 5390@kindex C-c C-e
5391@kindex C-c C-m C-m
5109@kindex C-c C-m C-u 5392@kindex C-c C-m C-u
5110@kindex C-c C-m u 5393@kindex C-c C-m u
5111 5394
@@ -5120,6 +5403,7 @@ file. You are prompted to confirm this action, but you can avoid the
5120confirmation by adding an argument (for example, @kbd{C-u C-c C-m 5403confirmation by adding an argument (for example, @kbd{C-u C-c C-m
5121C-u}). 5404C-u}).
5122 5405
5406@kindex C-c C-e
5123@vindex mh-mh-to-mime-args 5407@vindex mh-mh-to-mime-args
5124 5408
5125If you wish to pass additional arguments to @command{mhbuild} 5409If you wish to pass additional arguments to @command{mhbuild}
@@ -5129,13 +5413,14 @@ check into the message by setting @code{mh-mh-to-mime-args} to
5129@samp{-check}. The recipient of your message can then run 5413@samp{-check}. The recipient of your message can then run
5130@samp{mhbuild -check} on the message---@command{mhbuild} 5414@samp{mhbuild -check} on the message---@command{mhbuild}
5131(@command{mhn}) will complain if the message has been corrupted on the 5415(@command{mhn}) will complain if the message has been corrupted on the
5132way. The command @kbd{C-c C-e} (@code{mh-mh-to-mime}) only consults 5416way. The command @kbd{C-c C-e} only consults this option when given a
5133this option when given a prefix argument (as in @kbd{C-u C-c C-e}). 5417prefix argument (as in @kbd{C-u C-c C-e}).
5134 5418
5419@kindex C-c C-e
5135@vindex mh-mh-to-mime-hook 5420@vindex mh-mh-to-mime-hook
5136 5421
5137The hook @code{mh-mh-to-mime-hook} is called after the message has 5422The hook @code{mh-mh-to-mime-hook} is called after the message has
5138been formatted by @kbd{C-c C-e} (@code{mh-mh-to-mime}) 5423been formatted by @kbd{C-c C-e}.
5139 5424
5140@node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts 5425@node Sending PGP, Checking Recipients, Adding Attachments, Editing Drafts
5141@section Signing and Encrypting Messages 5426@section Signing and Encrypting Messages
@@ -5185,6 +5470,7 @@ following tag:
5185@findex mh-mml-unsecure-message 5470@findex mh-mml-unsecure-message
5186@kindex C-c C-m C-n 5471@kindex C-c C-m C-n
5187@kindex C-c C-m n 5472@kindex C-c C-m n
5473@vindex mh-mml-method-default
5188 5474
5189This is used to sign and encrypt your message. In each of these cases, 5475This is used to sign and encrypt your message. In each of these cases,
5190a proper multipart message is created for you when you send the 5476a proper multipart message is created for you when you send the
@@ -5218,8 +5504,8 @@ See
5218@cite{The PGG Manual}}. 5504@cite{The PGG Manual}}.
5219@end ifhtml 5505@end ifhtml
5220 5506
5221@cindex @samp{Fcc:} header field
5222@cindex header field, @samp{Fcc:} 5507@cindex header field, @samp{Fcc:}
5508@cindex @samp{Fcc:} header field
5223@vindex pgg-encrypt-for-me 5509@vindex pgg-encrypt-for-me
5224 5510
5225In particular, I turn on the option @code{pgg-encrypt-for-me} so that 5511In particular, I turn on the option @code{pgg-encrypt-for-me} so that
@@ -5249,8 +5535,8 @@ whatnow Program} in the MH book.}.
5249@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts 5535@node Sending Message, Killing Draft, Checking Recipients, Editing Drafts
5250@section Sending a Message 5536@section Sending a Message
5251 5537
5252@cindex @samp{*MH-E Mail Delivery*}
5253@cindex buffers, @samp{*MH-E Mail Delivery*} 5538@cindex buffers, @samp{*MH-E Mail Delivery*}
5539@cindex @samp{*MH-E Mail Delivery*}
5254@cindex sending mail 5540@cindex sending mail
5255@findex mh-send-letter 5541@findex mh-send-letter
5256@kindex C-c C-c 5542@kindex C-c C-c
@@ -5263,6 +5549,8 @@ Delivery*} (@pxref{Miscellaneous}).
5263 5549
5264@cindex sending mail 5550@cindex sending mail
5265@cindex spell check 5551@cindex spell check
5552@findex ispell-message
5553@kindex C-c C-c
5266@vindex mh-before-send-letter-hook 5554@vindex mh-before-send-letter-hook
5267 5555
5268The hook @code{mh-before-send-letter-hook} is run at the beginning of 5556The hook @code{mh-before-send-letter-hook} is run at the beginning of
@@ -5381,12 +5669,14 @@ Hook run by @code{mh-alias-reload} after loading aliases (default:
5381@code{nil}). 5669@code{nil}).
5382@end vtable 5670@end vtable
5383 5671
5384@heading Adding Addresses to Draft 5672@subheading Adding Addresses to Draft
5385 5673
5386You can use aliases when you are adding recipients to a message. 5674You can use aliases when you are adding recipients to a message.
5387 5675
5388@findex minibuffer-complete 5676@findex minibuffer-complete
5389@kindex @key{TAB} 5677@kindex @key{TAB}
5678@vindex mh-alias-expand-aliases-flag
5679@vindex mh-compose-prompt-flag
5390 5680
5391In order to use minibuffer prompting for recipients and the subject 5681In order to use minibuffer prompting for recipients and the subject
5392line in the minibuffer, turn on the option 5682line in the minibuffer, turn on the option
@@ -5396,10 +5686,17 @@ line in the minibuffer, turn on the option
5396on the option @code{mh-alias-expand-aliases-flag} if you want these 5686on the option @code{mh-alias-expand-aliases-flag} if you want these
5397aliases to be expanded to their respective addresses in the draft. 5687aliases to be expanded to their respective addresses in the draft.
5398 5688
5689@findex mh-letter-complete
5690@findex mh-letter-complete-or-space
5691@kindex @key{SPC}
5692@kindex M-@key{TAB}
5693
5399Otherwise, you can complete aliases in the header of the draft with 5694Otherwise, you can complete aliases in the header of the draft with
5400@kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC} 5695@kbd{M-@key{TAB}} (@code{mh-letter-complete}) or @key{SPC}
5401(@code{mh-letter-complete-or-space}). 5696(@code{mh-letter-complete-or-space}).
5402 5697
5698@vindex mh-alias-completion-ignore-case-flag
5699
5403As MH ignores case in the aliases, so too does MH-E. However, you may 5700As MH ignores case in the aliases, so too does MH-E. However, you may
5404turn off the option @code{mh-alias-completion-ignore-case-flag} to 5701turn off the option @code{mh-alias-completion-ignore-case-flag} to
5405make case significant which can be used to segregate completion of 5702make case significant which can be used to segregate completion of
@@ -5418,6 +5715,11 @@ you'd get Mark's address. Note that this option affects completion
5418only. If you were to enter @kbd{Mark.Baushke}, it would still be 5715only. If you were to enter @kbd{Mark.Baushke}, it would still be
5419identified with your @samp{mark.baushke} alias. 5716identified with your @samp{mark.baushke} alias.
5420 5717
5718@findex mh-alias-minibuffer-confirm-address
5719@findex mh-letter-confirm-address
5720@vindex mh-alias-flash-on-comma
5721@vindex mh-compose-prompt-flag
5722
5421To verify that the alias you've entered is valid, the alias will be 5723To verify that the alias you've entered is valid, the alias will be
5422displayed in the minibuffer when you type a comma 5724displayed in the minibuffer when you type a comma
5423(@code{mh-letter-confirm-address} or 5725(@code{mh-letter-confirm-address} or
@@ -5431,7 +5733,7 @@ Alias}, and @samp{Don't Flash Nor Warn If No Alias}.
5431For another way to verify the alias expansion, see @ref{Checking 5733For another way to verify the alias expansion, see @ref{Checking
5432Recipients}. 5734Recipients}.
5433 5735
5434@heading Loading Aliases 5736@subheading Loading Aliases
5435 5737
5436@cindex @command{ali} 5738@cindex @command{ali}
5437@cindex @file{/etc/nmh/MailAliases} 5739@cindex @file{/etc/nmh/MailAliases}
@@ -5457,6 +5759,8 @@ These aliases have the form @samp{local.@var{first.last}} if a real
5457name is present in the password file. Otherwise, the alias will have 5759name is present in the password file. Otherwise, the alias will have
5458the form @samp{local.@var{login}}. 5760the form @samp{local.@var{login}}.
5459 5761
5762@vindex mh-alias-local-users-prefix
5763
5460The prefix @samp{local.} can be modified via the option 5764The prefix @samp{local.} can be modified via the option
5461@code{mh-alias-local-users-prefix}. This option can also be set to 5765@code{mh-alias-local-users-prefix}. This option can also be set to
5462@samp{Use Login}. 5766@samp{Use Login}.
@@ -5467,6 +5771,8 @@ For example, consider the following password file entry:
5467psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh 5771psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh
5468@end example 5772@end example
5469 5773
5774@vindex mh-alias-local-users-prefix
5775
5470The following settings of option @code{mh-alias-local-users-prefix} 5776The following settings of option @code{mh-alias-local-users-prefix}
5471will produce the associated aliases: 5777will produce the associated aliases:
5472 5778
@@ -5481,6 +5787,8 @@ peter.galbraith
5481psg 5787psg
5482@end table 5788@end table
5483 5789
5790@vindex mh-alias-passwd-gecos-comma-separator-flag
5791
5484In the example above, commas are used to separate different values 5792In the example above, commas are used to separate different values
5485within the so-called GECOS field. This is a fairly common usage. 5793within the so-called GECOS field. This is a fairly common usage.
5486However, in the rare case that the GECOS field in your password file 5794However, in the rare case that the GECOS field in your password file
@@ -5488,8 +5796,9 @@ is not separated by commas and whose contents may contain commas, you
5488can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag} 5796can turn the option @code{mh-alias-passwd-gecos-comma-separator-flag}
5489off. 5797off.
5490 5798
5491@cindex @samp{ypcat passwd}
5492@cindex NIS, obtaining local aliases from 5799@cindex NIS, obtaining local aliases from
5800@cindex @samp{ypcat passwd}
5801@vindex mh-alias-local-users
5493 5802
5494If you're on a system with thousands of users you don't know, and the 5803If you're on a system with thousands of users you don't know, and the
5495loading of local aliases slows MH-E down noticeably, then the local 5804loading of local aliases slows MH-E down noticeably, then the local
@@ -5498,18 +5807,25 @@ alias feature can be disabled by turning off the option
5498executed to generate the password file. For example, use @samp{ypcat 5807executed to generate the password file. For example, use @samp{ypcat
5499passwd} to obtain the NIS password file. 5808passwd} to obtain the NIS password file.
5500 5809
5810@findex mh-alias-reload
5811@kindex M-x mh-alias-reload
5812@vindex mh-alias-reloaded-hook
5813
5501Since aliases are updated frequently, MH-E reloads aliases 5814Since aliases are updated frequently, MH-E reloads aliases
5502automatically whenever an alias lookup occurs if an alias source has 5815automatically whenever an alias lookup occurs if an alias source has
5503changed. However, you can reload your aliases manually by calling the 5816changed. However, you can reload your aliases manually by calling the
5504command @kbd{M-x mh-alias-reload} directly. This command runs 5817command @kbd{M-x mh-alias-reload} directly. This command runs
5505@code{mh-alias-reloaded-hook} after the aliases have been loaded. 5818@code{mh-alias-reloaded-hook} after the aliases have been loaded.
5506 5819
5507@heading Adding Aliases 5820@subheading Adding Aliases
5508 5821
5509In the past, you have manually added aliases to your alias file(s) 5822In the past, you have manually added aliases to your alias file(s)
5510listed in your @samp{Aliasfile:} profile component. MH-E provides 5823listed in your @samp{Aliasfile:} profile component. MH-E provides
5511other methods for maintaining your alias file(s). 5824other methods for maintaining your alias file(s).
5512 5825
5826@findex mh-alias-add-alias
5827@kindex M-x mh-alias-add-alias
5828
5513You can use the @kbd{M-x mh-alias-add-alias} command which will prompt 5829You can use the @kbd{M-x mh-alias-add-alias} command which will prompt
5514you for the alias and address that you would like to add. If the alias 5830you for the alias and address that you would like to add. If the alias
5515exists already, you will have the choice of inserting the new alias 5831exists already, you will have the choice of inserting the new alias
@@ -5541,6 +5857,9 @@ Using prefixes instead of postfixes helps you explore aliases during
5541completion. If you forget the name of an old dive buddy, you can enter 5857completion. If you forget the name of an old dive buddy, you can enter
5542@samp{div} and then @key{SPC} to get a listing of all your dive buddies. 5858@samp{div} and then @key{SPC} to get a listing of all your dive buddies.
5543 5859
5860@kindex M-x mh-alias-add-address-under-point
5861@kindex M-x mh-alias-grab-from-field
5862
5544An alias for the sender of the current message is added automatically 5863An alias for the sender of the current message is added automatically
5545by clicking on the @samp{Grab From alias} tool bar button or by running 5864by clicking on the @samp{Grab From alias} tool bar button or by running
5546the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other 5865the @kbd{M-x mh-alias-grab-from-field} command. Aliases for other
@@ -5548,24 +5867,33 @@ recipients of the current message are added by placing your cursor
5548over the desired recipient and giving the @kbd{M-x 5867over the desired recipient and giving the @kbd{M-x
5549mh-alias-add-address-under-point} command. 5868mh-alias-add-address-under-point} command.
5550 5869
5870@vindex mh-alias-insert-file
5871@vindex mh-alias-insertion-location
5872
5551The options @code{mh-alias-insert-file} and 5873The options @code{mh-alias-insert-file} and
5552@code{mh-alias-insertion-location} controls how and where these aliases 5874@code{mh-alias-insertion-location} controls how and where these aliases
5553are inserted. 5875are inserted.
5554 5876
5555The default setting of this option is @samp{Use Aliasfile Profile 5877@vindex mh-alias-insert-file
5556Component}. This option can also hold the name of a file or a list a 5878
5557file names. If this option is set to a list of file names, or the 5879The default setting of option @code{mh-alias-insert-file} is @samp{Use
5558@samp{Aliasfile:} profile component contains more than one file name, 5880Aliasfile Profile Component}. This option can also hold the name of a
5559MH-E will prompt for one of them. 5881file or a list a file names. If this option is set to a list of file
5882names, or the @samp{Aliasfile:} profile component contains more than
5883one file name, MH-E will prompt for one of them.
5884
5885@vindex mh-alias-insertion-location
5560 5886
5561The option @code{mh-alias-insertion-location} is set to 5887The option @code{mh-alias-insertion-location} is set to
5562@samp{Alphabetical} by default. If you organize your alias file in 5888@samp{Alphabetical} by default. If you organize your alias file in
5563other ways, then the settings @samp{Top} and @samp{Bottom} might be 5889other ways, then the settings @samp{Top} and @samp{Bottom} might be
5564more appropriate. 5890more appropriate.
5565 5891
5566@heading Querying Aliases 5892@subheading Querying Aliases
5567 5893
5568@cindex regular expressions, @code{mh-alias-apropos} 5894@cindex regular expressions, @code{mh-alias-apropos}
5895@findex mh-alias-apropos
5896@kindex M-x mh-alias-apropos
5569 5897
5570If you can't quite remember an alias, you can use @kbd{M-x 5898If you can't quite remember an alias, you can use @kbd{M-x
5571mh-alias-apropos} to show all aliases or addresses that match a 5899mh-alias-apropos} to show all aliases or addresses that match a
@@ -5591,6 +5919,9 @@ MH-E supports the concept of multiple personalities or identities.
5591This means that you can easily have a different header and signature 5919This means that you can easily have a different header and signature
5592at home and at work. 5920at home and at work.
5593 5921
5922@cindex @samp{Identity} menu
5923@cindex menu, @samp{Identity}
5924
5594A couple of commands are used to insert identities in MH-Letter mode 5925A couple of commands are used to insert identities in MH-Letter mode
5595which are also found in the @samp{Identity} menu. 5926which are also found in the @samp{Identity} menu.
5596 5927
@@ -5639,6 +5970,8 @@ Some of the common header fields that people change depending on the
5639context are the @samp{From:} and @samp{Organization:} fields, as well 5970context are the @samp{From:} and @samp{Organization:} fields, as well
5640as the signature. 5971as the signature.
5641 5972
5973@vindex mh-identity-list
5974
5642This is done by customizing the option @code{mh-identity-list}. In the 5975This is done by customizing the option @code{mh-identity-list}. In the
5643customization buffer for this option, click on the @samp{INS} button 5976customization buffer for this option, click on the @samp{INS} button
5644and enter a label such as @samp{Home} or @samp{Work}. Then click on 5977and enter a label such as @samp{Home} or @samp{Work}. Then click on
@@ -5682,18 +6015,21 @@ Specify a different key to sign or encrypt messages.
5682 6015
5683@cindex Identity menu 6016@cindex Identity menu
5684@cindex menu, Identity 6017@cindex menu, Identity
6018@findex mh-insert-identity
6019@kindex C-c C-d
5685 6020
5686You can select the identities you have added via the menu called 6021You can select the identities you have added via the menu called
5687@samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c 6022@samp{Identity} in the MH-Letter buffer. You can also use @kbd{C-c
5688C-d} (@code{mh-insert-identity}). To clear the fields and signature 6023C-d} (@code{mh-insert-identity}). To clear the fields and signature
5689added by the identity, select the @samp{None} identity. 6024added by the identity, select the @samp{None} identity.
5690 6025
5691@cindex @samp{Identity > Save as Default} menu item 6026@cindex menu item, @samp{Identity > Customize Identities}
5692@cindex menu item, @samp{Identity > Save as Default} 6027@cindex menu item, @samp{Identity > Save as Default}
5693@cindex @samp{Identity > Set Default for Session} menu item
5694@cindex menu item, @samp{Identity > Set Default for Session} 6028@cindex menu item, @samp{Identity > Set Default for Session}
5695@cindex @samp{Identity > Customize Identities} menu item 6029@cindex @samp{Identity > Customize Identities} menu item
5696@cindex menu item, @samp{Identity > Customize Identities} 6030@cindex @samp{Identity > Save as Default} menu item
6031@cindex @samp{Identity > Set Default for Session} menu item
6032@vindex mh-identity-default
5697 6033
5698The @samp{Identity} menu contains two other items to save you from 6034The @samp{Identity} menu contains two other items to save you from
5699having to set the identity on every message. The menu item @samp{Set 6035having to set the identity on every message. The menu item @samp{Set
@@ -5706,6 +6042,7 @@ need to add another identity, the menu item @samp{Customize
5706Identities} is available for your convenience. 6042Identities} is available for your convenience.
5707 6043
5708@cindex regular expressions, @code{mh-auto-fields-list} 6044@cindex regular expressions, @code{mh-auto-fields-list}
6045@vindex mh-auto-fields-list
5709 6046
5710The option @code{mh-auto-fields-list} can also be used to set the 6047The option @code{mh-auto-fields-list} can also be used to set the
5711identity depending on the recipient to provide even more control. To 6048identity depending on the recipient to provide even more control. To
@@ -5754,6 +6091,10 @@ reply.
5754Other header fields may be added using this menu item. 6091Other header fields may be added using this menu item.
5755@end table 6092@end table
5756 6093
6094@findex mh-insert-auto-fields
6095@kindex C-c M-d
6096@vindex mh-auto-fields-prompt-flag
6097
5757These fields can only be added after the recipient is known. Because 6098These fields can only be added after the recipient is known. Because
5758you can continue to add recipients as you edit the draft, MH-E waits 6099you can continue to add recipients as you edit the draft, MH-E waits
5759until the message is sent to perform the auto-insertions. This seems 6100until the message is sent to perform the auto-insertions. This seems
@@ -5770,10 +6111,16 @@ the header contains one or more recipients, you may run the command
5770manually. However, if you use this command, the automatic insertion 6111manually. However, if you use this command, the automatic insertion
5771when the message is sent is disabled. 6112when the message is sent is disabled.
5772 6113
6114@vindex mh-auto-fields-list
6115@vindex mh-identity-list
6116
5773You should avoid using the same header field in 6117You should avoid using the same header field in
5774@code{mh-auto-fields-list} and @code{mh-identity-list} definitions 6118@code{mh-auto-fields-list} and @code{mh-identity-list} definitions
5775that may apply to the same message as the result is undefined. 6119that may apply to the same message as the result is undefined.
5776 6120
6121@vindex mh-identity-handlers
6122@vindex mh-identity-list
6123
5777The option @code{mh-identity-handlers} is used to change the way that 6124The option @code{mh-identity-handlers} is used to change the way that
5778fields, signatures, and attributions in @code{mh-identity-list} are 6125fields, signatures, and attributions in @code{mh-identity-list} are
5779added. To customize @code{mh-identity-handlers}, replace the name of 6126added. To customize @code{mh-identity-handlers}, replace the name of
@@ -5782,6 +6129,8 @@ change with the name of a function you have written. You can also
5782click on an @samp{INS} button and insert a field of your choice and 6129click on an @samp{INS} button and insert a field of your choice and
5783the name of the function you have written to handle it. 6130the name of the function you have written to handle it.
5784 6131
6132@vindex mh-identity-list
6133
5785The @samp{Field} field can be any field that you've used in your 6134The @samp{Field} field can be any field that you've used in your
5786@code{mh-identity-list}. The special fields @samp{:attribution-verb}, 6135@code{mh-identity-list}. The special fields @samp{:attribution-verb},
5787@samp{:signature}, or @samp{:pgg-default-user-id} are used for the 6136@samp{:signature}, or @samp{:pgg-default-user-id} are used for the
@@ -5802,6 +6151,10 @@ containing the value for the field is given.
5802 6151
5803@cindex folder navigation 6152@cindex folder navigation
5804@cindex speedbar 6153@cindex speedbar
6154@findex mh-visit-folder
6155@kindex F v
6156@kindex M-x speedbar
6157@kindex Mouse-2
5805 6158
5806You can also use the speedbar 6159You can also use the speedbar
5807@ifnothtml 6160@ifnothtml
@@ -5848,6 +6201,10 @@ you've added or deleted a folder, or want to update the unseen message
5848count before the next automatic update (@code{mh-speed-refresh}). 6201count before the next automatic update (@code{mh-speed-refresh}).
5849@end table 6202@end table
5850 6203
6204@findex delete-frame
6205@kindex C-x 5 0
6206@kindex Mouse-3
6207
5851You can click on @kbd{Mouse-3} to bring up a context menu that 6208You can click on @kbd{Mouse-3} to bring up a context menu that
5852contains these items. Dismiss the speedbar with @kbd{C-x 5 0} 6209contains these items. Dismiss the speedbar with @kbd{C-x 5 0}
5853(@code{delete-frame}). 6210(@code{delete-frame}).
@@ -5890,8 +6247,12 @@ Selected folder face when folder contains unread messages.
5890@node Menu Bar, Tool Bar, Speedbar, Top 6247@node Menu Bar, Tool Bar, Speedbar, Top
5891@chapter The Menu Bar 6248@chapter The Menu Bar
5892 6249
5893@cindex menu bar 6250@cindex @samp{Folder} menu
5894 6251@cindex @samp{Identity} menu
6252@cindex @samp{Letter} menu
6253@cindex @samp{Message} menu
6254@cindex @samp{Search} menu
6255@cindex @samp{Sequence} menu
5895@cindex Folder menu 6256@cindex Folder menu
5896@cindex Identity menu 6257@cindex Identity menu
5897@cindex Letter menu 6258@cindex Letter menu
@@ -5901,12 +6262,19 @@ Selected folder face when folder contains unread messages.
5901@cindex Message menu 6262@cindex Message menu
5902@cindex Search menu 6263@cindex Search menu
5903@cindex Sequence menu 6264@cindex Sequence menu
6265@cindex menu bar
5904@cindex menu, Folder 6266@cindex menu, Folder
5905@cindex menu, Identity 6267@cindex menu, Identity
5906@cindex menu, Letter 6268@cindex menu, Letter
5907@cindex menu, Message 6269@cindex menu, Message
5908@cindex menu, Search 6270@cindex menu, Search
5909@cindex menu, Sequence 6271@cindex menu, Sequence
6272@cindex menu, @samp{Folder}
6273@cindex menu, @samp{Identity}
6274@cindex menu, @samp{Letter}
6275@cindex menu, @samp{Message}
6276@cindex menu, @samp{Search}
6277@cindex menu, @samp{Sequence}
5910@cindex modes, MH-Folder 6278@cindex modes, MH-Folder
5911@cindex modes, MH-Letter 6279@cindex modes, MH-Letter
5912@cindex modes, MH-Search 6280@cindex modes, MH-Search
@@ -5940,8 +6308,6 @@ and you can also browse all of the items under the index entry
5940@chapter The Tool Bar 6308@chapter The Tool Bar
5941 6309
5942@cindex tool bar 6310@cindex tool bar
5943@cindex @samp{mh-tool-bar} customization group
5944@cindex customization group, @samp{mh-tool-bar}
5945 6311
5946Emacs also provides a graphical tool bar. For a description of the 6312Emacs also provides a graphical tool bar. For a description of the
5947tool bar, please 6313tool bar, please
@@ -5954,6 +6320,9 @@ see the section
5954Tool Bars} in @cite{The GNU Emacs Manual}. 6320Tool Bars} in @cite{The GNU Emacs Manual}.
5955@end ifhtml 6321@end ifhtml
5956 6322
6323@cindex @samp{mh-tool-bar} customization group
6324@cindex customization group, @samp{mh-tool-bar}
6325
5957MH-E adds several icons to this tool bar; you can modify the MH-E 6326MH-E adds several icons to this tool bar; you can modify the MH-E
5958aspects of the tool bar via the @samp{mh-tool-bar} customization group. 6327aspects of the tool bar via the @samp{mh-tool-bar} customization group.
5959 6328
@@ -5981,6 +6350,9 @@ In GNU Emacs, icons for some of MH-E's functions are added to the tool
5981bar. In XEmacs, you have the opportunity to create a separate tool bar for 6350bar. In XEmacs, you have the opportunity to create a separate tool bar for
5982the MH-E icons. 6351the MH-E icons.
5983 6352
6353@vindex mh-tool-bar-folder-buttons
6354@vindex mh-tool-bar-letter-buttons
6355
5984In either case, you can select which of these functions you'd like to 6356In either case, you can select which of these functions you'd like to
5985see by customizing the options @code{mh-tool-bar-folder-buttons} and 6357see by customizing the options @code{mh-tool-bar-folder-buttons} and
5986@code{mh-tool-bar-letter-buttons}. As you probably guessed, the former 6358@code{mh-tool-bar-letter-buttons}. As you probably guessed, the former
@@ -5989,18 +6361,25 @@ mode. Both of these options present you with a list of functions;
5989check the functions whose icons you want to see and clear the check 6361check the functions whose icons you want to see and clear the check
5990boxes for those you don't. 6362boxes for those you don't.
5991 6363
6364@findex mh-search
6365@vindex mh-tool-bar-search-function
6366
5992The function associated with the searching icon can be set via the 6367The function associated with the searching icon can be set via the
5993option @code{mh-tool-bar-search-function}. By default, this is set to 6368option @code{mh-tool-bar-search-function}. By default, this is set to
5994@code{mh-search}. @xref{Searching}. You can also choose @samp{Other 6369@code{mh-search}. @xref{Searching}. You can also choose @samp{Other
5995Function} from the @samp{Value Menu} and enter a function of your own 6370Function} from the @samp{Value Menu} and enter a function of your own
5996choosing. 6371choosing.
5997 6372
6373@vindex mh-xemacs-use-tool-bar-flag
6374
5998XEmacs provides a couple of extra options. The first, 6375XEmacs provides a couple of extra options. The first,
5999@code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E 6376@code{mh-xemacs-use-tool-bar-flag}, controls whether to show the MH-E
6000icons at all. By default, this option is turned on if the window 6377icons at all. By default, this option is turned on if the window
6001system supports tool bars. If your system doesn't support tool bars, 6378system supports tool bars. If your system doesn't support tool bars,
6002then you won't be able to turn on this option. 6379then you won't be able to turn on this option.
6003 6380
6381@vindex mh-xemacs-tool-bar-position
6382
6004The second extra option is @code{mh-xemacs-tool-bar-position} which 6383The second extra option is @code{mh-xemacs-tool-bar-position} which
6005controls the placement of the tool bar along the four edges of the 6384controls the placement of the tool bar along the four edges of the
6006frame. You can choose from one of @samp{Same As Default Tool Bar}, 6385frame. You can choose from one of @samp{Same As Default Tool Bar},
@@ -6012,8 +6391,9 @@ bars will be displayed: the MH-E tool bar and the default tool bar.
6012@node Searching, Threading, Tool Bar, Top 6391@node Searching, Threading, Tool Bar, Top
6013@chapter Searching Through Messages 6392@chapter Searching Through Messages
6014 6393
6394@cindex @samp{Search} menu
6395@cindex menu, @samp{Search}
6015@cindex searching 6396@cindex searching
6016
6017@findex mh-search 6397@findex mh-search
6018@kindex F s 6398@kindex F s
6019 6399
@@ -6157,12 +6537,18 @@ The following face is available.
6157Folder heading face in MH-Folder buffers created by searches. 6537Folder heading face in MH-Folder buffers created by searches.
6158@end vtable 6538@end vtable
6159 6539
6540@findex mh-search-folder
6541@kindex F s
6542
6160The command @kbd{F s} (@code{mh-search-folder}) helps you find 6543The command @kbd{F s} (@code{mh-search-folder}) helps you find
6161messages in your entire corpus of mail. You can search for messages to 6544messages in your entire corpus of mail. You can search for messages to
6162or from a particular person or about a particular subject. In fact, 6545or from a particular person or about a particular subject. In fact,
6163you can also search for messages containing selected strings in any 6546you can also search for messages containing selected strings in any
6164arbitrary header field or any string found within the messages. 6547arbitrary header field or any string found within the messages.
6165 6548
6549@cindex @command{pick}
6550@cindex MH commands, @command{pick}
6551
6166Out of the box, MH-E uses @command{pick} to find messages. With a 6552Out of the box, MH-E uses @command{pick} to find messages. With a
6167little extra effort, you can set an indexing program which rewards you 6553little extra effort, you can set an indexing program which rewards you
6168with extremely quick results. The drawback is that sometimes the index 6554with extremely quick results. The drawback is that sometimes the index
@@ -6229,26 +6615,25 @@ kosciusko
6229@end group 6615@end group
6230@end smallexample 6616@end smallexample
6231 6617
6618@findex mh-to-field
6619@kindex C-c C-f C-t
6620
6232As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f 6621As with MH-Letter mode, MH-Search provides commands like @kbd{C-c C-f
6233C-t} (@code{mh-to-field}) to help you fill in the blanks. 6622C-t} (@code{mh-to-field}) to help you fill in the blanks.
6234@xref{Editing Message}. 6623@xref{Editing Message}.
6235 6624
6625@kindex F s
6626@vindex mh-search-mode-hook
6627
6236If you find that you do the same thing over and over when editing the 6628If you find that you do the same thing over and over when editing the
6237search template, you may wish to bind some shortcuts to keys. This can 6629search template, you may wish to bind some shortcuts to keys. This can
6238be done with the variable @code{mh-search-mode-hook}, which is called 6630be done with the variable @code{mh-search-mode-hook}, which is called
6239when @kbd{F s} is run on a new pattern. 6631when @kbd{F s} is run on a new pattern.
6240 6632
6241@cindex @samp{+mhe-index}
6242@cindex folders, @samp{+mhe-index}
6243@findex mh-index-do-search 6633@findex mh-index-do-search
6244@findex mh-index-next-folder
6245@findex mh-index-previous-folder
6246@findex mh-pick-do-search 6634@findex mh-pick-do-search
6247@kindex @key{TAB}
6248@kindex C-c C-c 6635@kindex C-c C-c
6249@kindex F s 6636@kindex C-c C-p
6250@kindex S-@key{TAB}
6251@vindex mh-search-folder
6252 6637
6253To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}). 6638To perform the search, type @kbd{C-c C-c} (@code{mh-index-do-search}).
6254Sometimes you're searching for text that is either not indexed, or 6639Sometimes you're searching for text that is either not indexed, or
@@ -6256,6 +6641,14 @@ hasn't been indexed yet. In this case you can override the default
6256method with the pick method by running the command @kbd{C-c C-p} 6641method with the pick method by running the command @kbd{C-c C-p}
6257(@code{mh-pick-do-search}). 6642(@code{mh-pick-do-search}).
6258 6643
6644@cindex folders, @samp{+mhe-index}
6645@cindex @samp{+mhe-index}
6646@findex mh-index-next-folder
6647@findex mh-index-previous-folder
6648@kindex @key{TAB}
6649@kindex S-@key{TAB}
6650@vindex mh-search-folder
6651
6259The messages that are found are put in a temporary sub-folder of 6652The messages that are found are put in a temporary sub-folder of
6260@samp{+mhe-index} and are displayed in an MH-Folder buffer. This 6653@samp{+mhe-index} and are displayed in an MH-Folder buffer. This
6261buffer is special because it displays messages from multiple folders; 6654buffer is special because it displays messages from multiple folders;
@@ -6266,6 +6659,11 @@ headings using the commands @kbd{@key{TAB}}
6266(@code{mh-index-next-folder}) and @kbd{S-@key{TAB}} 6659(@code{mh-index-next-folder}) and @kbd{S-@key{TAB}}
6267(@code{mh-index-previous-folder}). 6660(@code{mh-index-previous-folder}).
6268 6661
6662@findex mh-index-visit-folder
6663@findex mh-rescan-folder
6664@kindex F r
6665@kindex v
6666
6269In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be 6667In addition, the command @kbd{v} (@code{mh-index-visit-folder}) can be
6270used to visit the folder of the message at point. Initially, only the 6668used to visit the folder of the message at point. Initially, only the
6271messages that matched the search criteria are displayed in the folder. 6669messages that matched the search criteria are displayed in the folder.
@@ -6275,10 +6673,15 @@ command @kbd{v} is useful to find the actual message number of an
6275interesting message, or to view surrounding messages with the command 6673interesting message, or to view surrounding messages with the command
6276@kbd{F r} @code{mh-rescan-folder}. @xref{Folders}. 6674@kbd{F r} @code{mh-rescan-folder}. @xref{Folders}.
6277 6675
6676@findex mh-kill-folder
6677@kindex F k
6678
6278Because this folder is temporary, you'll probably get in the habit of 6679Because this folder is temporary, you'll probably get in the habit of
6279killing it when you're done with @kbd{F k} (@code{mh-kill-folder}). 6680killing it when you're done with @kbd{F k} (@code{mh-kill-folder}).
6280@xref{Folders}. 6681@xref{Folders}.
6281 6682
6683@kindex F s
6684
6282You can regenerate the results by running @kbd{F s} with a prefix 6685You can regenerate the results by running @kbd{F s} with a prefix
6283argument. 6686argument.
6284 6687
@@ -6434,7 +6837,7 @@ Use the following command line to generate the swish index. Run this
6434daily from cron: 6837daily from cron:
6435 6838
6436@smallexample 6839@smallexample
6437 swish-e -c /home/user/Mail/.swish/config 6840swish-e -c /home/user/Mail/.swish/config
6438@end smallexample 6841@end smallexample
6439 6842
6440@subsection mairix 6843@subsection mairix
@@ -6536,6 +6939,10 @@ header field. Other ways to organize messages in a folder include
6536limiting (@pxref{Limits}) or using full-text indexed searches 6939limiting (@pxref{Limits}) or using full-text indexed searches
6537(@pxref{Searching}). 6940(@pxref{Searching}).
6538 6941
6942@cindex root, in threads
6943@cindex siblings, in threads
6944@cindex ancestor, in threads
6945
6539A thread begins with a single message called a @dfn{root}. All replies 6946A thread begins with a single message called a @dfn{root}. All replies
6540to the same message are @dfn{siblings} of each other. Any message that 6947to the same message are @dfn{siblings} of each other. Any message that
6541has replies to it is an @dfn{ancestor} of those replies. 6948has replies to it is an @dfn{ancestor} of those replies.
@@ -6581,6 +6988,9 @@ Display previous sibling (@code{mh-thread-previous-sibling}).
6581Display ancestor of current message (@code{mh-thread-ancestor}). 6988Display ancestor of current message (@code{mh-thread-ancestor}).
6582@end table 6989@end table
6583 6990
6991@cindex @samp{mh-thread} customization group
6992@cindex customization group, @samp{mh-thread}
6993
6584The @samp{mh-thread} customization group contains one option. 6994The @samp{mh-thread} customization group contains one option.
6585 6995
6586@vtable @code 6996@vtable @code
@@ -6588,6 +6998,11 @@ The @samp{mh-thread} customization group contains one option.
6588On means new folders start in threaded mode (default: @samp{off}). 6998On means new folders start in threaded mode (default: @samp{off}).
6589@end vtable 6999@end vtable
6590 7000
7001@findex mh-toggle-threads
7002@kindex T t
7003@vindex mh-large-folder
7004@vindex mh-show-threads-flag
7005
6591Threading large number of messages can be time consuming so the option 7006Threading large number of messages can be time consuming so the option
6592@code{mh-show-threads-flag} is turned off by default. If you turn on 7007@code{mh-show-threads-flag} is turned off by default. If you turn on
6593this option, then threading will be done only if the number of 7008this option, then threading will be done only if the number of
@@ -6595,6 +7010,13 @@ messages being threaded is less than @code{mh-large-folder}. In any
6595event, threading can be turned on (and off) with the command @kbd{T t} 7010event, threading can be turned on (and off) with the command @kbd{T t}
6596(@code{mh-toggle-threads}). 7011(@code{mh-toggle-threads}).
6597 7012
7013@findex mh-thread-ancestor
7014@findex mh-thread-next-sibling
7015@findex mh-thread-previous-sibling
7016@kindex T n
7017@kindex T p
7018@kindex T u
7019
6598There are a few commands to help you navigate threads. If you do not 7020There are a few commands to help you navigate threads. If you do not
6599care for the way a particular thread has turned, you can move up the 7021care for the way a particular thread has turned, you can move up the
6600chain of messages with the command @kbd{T u} 7022chain of messages with the command @kbd{T u}
@@ -6604,6 +7026,13 @@ chain of messages with the command @kbd{T u}
6604sibling, skipping the sub-threads. The command @kbd{T u} can also take 7026sibling, skipping the sub-threads. The command @kbd{T u} can also take
6605a prefix argument to jump to the message that started everything. 7027a prefix argument to jump to the message that started everything.
6606 7028
7029@findex mh-delete-subject-or-thread
7030@findex mh-thread-delete
7031@findex mh-thread-refile
7032@kindex k
7033@kindex T d
7034@kindex T o
7035
6607There are threaded equivalents for the commands that delete and refile 7036There are threaded equivalents for the commands that delete and refile
6608messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the 7037messages. For example, @kbd{T o} (@code{mh-thread-refile}) refiles the
6609current message and all its children. Similarly, the command @kbd{T d} 7038current message and all its children. Similarly, the command @kbd{T d}
@@ -6612,11 +7041,13 @@ children. These commands do not refile or delete sibling messages.
6612@xref{Navigating}, for a description of the similar command @kbd{k} 7041@xref{Navigating}, for a description of the similar command @kbd{k}
6613(@code{mh-delete-subject-or-thread}). 7042(@code{mh-delete-subject-or-thread}).
6614 7043
7044@vindex mh-large-folder
7045
6615If you find that threading is too slow, it may be that you have 7046If you find that threading is too slow, it may be that you have
6616@code{mh-large-folder} set too high. Threading is one of the few 7047@code{mh-large-folder} set too high. Also, threading is one of the few
6617features of MH-E that really benefits from compiling. If you haven't 7048features of MH-E that really benefits from compiling. If you haven't
6618compiled MH-E, I encourage you to do so@footnote{If you're not sure 7049compiled MH-E, I encourage you to do so@footnote{If you're not sure if
6619if MH-E has been byte-compiled, you could try running @samp{locate 7050MH-E has been byte-compiled, you could try running @samp{locate
6620mh-thread.elc} or otherwise find MH-E on your system and ensure that 7051mh-thread.elc} or otherwise find MH-E on your system and ensure that
6621@file{mh-thread.elc} exists. If you have multiple versions and you 7052@file{mh-thread.elc} exists. If you have multiple versions and you
6622find that one is compiled but the other is not, then go into your 7053find that one is compiled but the other is not, then go into your
@@ -6695,18 +7126,32 @@ All of the limiting commands above refine the display in some way.
6695 7126
6696@cindex @command{pick} 7127@cindex @command{pick}
6697@cindex MH commands, @command{pick} 7128@cindex MH commands, @command{pick}
7129@findex mh-narrow-to-cc
7130@findex mh-narrow-to-from
7131@findex mh-narrow-to-subject
7132@findex mh-narrow-to-to
7133@kindex / c
7134@kindex / m
7135@kindex / s
7136@kindex / t
6698 7137
6699The commands @kbd{/ c}, @code{/ m}, @code{/ s}, and @code{/ t} 7138The commands @kbd{/ c} (@code{mh-narrow-to-cc}), @kbd{/ m}
6700restrict the display to messages matching the content of the 7139(@code{mh-narrow-to-from}), @kbd{/ s} (@code{mh-narrow-to-subject}),
6701respective field in the current message. However, you can give any of 7140and @kbd{/ t} (@code{mh-narrow-to-to}) restrict the display to
6702these a prefix argument to edit the @command{pick} expression used to 7141messages matching the content of the respective field in the current
6703narrow the view@footnote{See @command{pick}(1) or the section 7142message. However, you can give any of these a prefix argument to edit
7143the @command{pick} expression used to narrow the view@footnote{See
7144@command{pick}(1) or the section
6704@uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in 7145@uref{@value{MH-BOOK-HOME}/finpic.htm, Finding Messages with pick} in
6705the MH book.}. 7146the MH book.}.
6706 7147
6707@cindex @samp{tick} sequence 7148@cindex @samp{tick} sequence
6708@cindex sequence, @samp{tick} 7149@cindex sequence, @samp{tick}
6709@cindex ticked messages, viewing 7150@cindex ticked messages, viewing
7151@findex mh-narrow-to-range
7152@findex mh-narrow-to-tick
7153@kindex / '
7154@kindex / g
6710 7155
6711You can also limit the display to messages in the @samp{tick} sequence 7156You can also limit the display to messages in the @samp{tick} sequence
6712with the command @kbd{/ '} (@code{mh-narrow-to-tick}). 7157with the command @kbd{/ '} (@code{mh-narrow-to-tick}).
@@ -6714,12 +7159,17 @@ with the command @kbd{/ '} (@code{mh-narrow-to-tick}).
6714@samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range}) 7159@samp{tick} sequence. Use the @kbd{/ g} (@code{mh-narrow-to-range})
6715command to limit the display to messages in a range (@pxref{Ranges}). 7160command to limit the display to messages in a range (@pxref{Ranges}).
6716 7161
7162@findex mh-widen
7163@kindex / w
7164
6717Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen}) 7165Each limit can be undone in turn with the @kbd{/ w} (@code{mh-widen})
6718command. Give this command a prefix argument to remove all limits. 7166command. Give this command a prefix argument to remove all limits.
6719 7167
6720@node Sequences, Junk, Limits, Top 7168@node Sequences, Junk, Limits, Top
6721@chapter Using Sequences 7169@chapter Using Sequences
6722 7170
7171@cindex @samp{Sequence} menu
7172@cindex menu, @samp{Sequence}
6723@cindex sequences 7173@cindex sequences
6724 7174
6725For the whole scoop on MH sequences, refer to 7175For the whole scoop on MH sequences, refer to
@@ -6835,6 +7285,8 @@ Hook run after the unseen sequence has been updated (default: @code{nil}).
6835 7285
6836@cindex @command{pick} 7286@cindex @command{pick}
6837@cindex MH commands, @command{pick} 7287@cindex MH commands, @command{pick}
7288@findex mh-put-msg-in-seq
7289@kindex S p
6838 7290
6839To place a message in a sequence, use @kbd{S p} 7291To place a message in a sequence, use @kbd{S p}
6840(@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all 7292(@code{mh-put-msg-in-seq}). Give @kbd{S p} a range and you can add all
@@ -6844,11 +7296,18 @@ S p SourceSequence @key{RET} DestSequence @key{RET}}, @pxref{Ranges}).
6844@cindex @samp{tick} sequence 7296@cindex @samp{tick} sequence
6845@cindex sequence, @samp{tick} 7297@cindex sequence, @samp{tick}
6846@cindex ticking messages 7298@cindex ticking messages
7299@findex mh-index-ticked-messages
7300@findex mh-toggle-tick
7301@kindex '
7302@kindex F '
7303@kindex S p
6847 7304
6848One specific use of the @kbd{S p} command is @kbd{'} 7305One specific use of the @kbd{S p} command is @kbd{'}
6849(@code{mh-toggle-tick}) which adds messages to the @samp{tick} 7306(@code{mh-toggle-tick}) which adds messages to the @samp{tick}
6850sequence. This sequence can be viewed later with the @kbd{F '} command 7307sequence. This sequence can be viewed later with the @kbd{F '}
6851(@pxref{Folders}). 7308(@code{mh-index-ticked-messages}) command (@pxref{Folders}).
7309
7310@vindex mh-tick-seq
6852 7311
6853You can customize the option @code{mh-tick-seq} if you already use the 7312You can customize the option @code{mh-tick-seq} if you already use the
6854@samp{tick} sequence for your own use. You can also disable all of the 7313@samp{tick} sequence for your own use. You can also disable all of the
@@ -6857,6 +7316,12 @@ there isn't much advantage to that.
6857 7316
6858@cindex MH-Folder mode 7317@cindex MH-Folder mode
6859@cindex modes, MH-Folder 7318@cindex modes, MH-Folder
7319@findex mh-narrow-to-seq
7320@findex mh-narrow-to-tick
7321@findex mh-widen
7322@kindex S '
7323@kindex S n
7324@kindex S w
6860 7325
6861Once you've placed some messages in a sequence, you may wish to narrow 7326Once you've placed some messages in a sequence, you may wish to narrow
6862the field of view to just those messages in the sequence you've 7327the field of view to just those messages in the sequence you've
@@ -6869,8 +7334,12 @@ sequence, use @kbd{S '} (@code{mh-narrow-to-tick}). When you want to
6869widen the view to all your messages again, use @kbd{S w} 7334widen the view to all your messages again, use @kbd{S w}
6870(@code{mh-widen}). 7335(@code{mh-widen}).
6871 7336
6872@cindex @samp{*MH-E Sequences*}
6873@cindex buffers, @samp{*MH-E Sequences*} 7337@cindex buffers, @samp{*MH-E Sequences*}
7338@cindex @samp{*MH-E Sequences*}
7339@findex mh-list-sequences
7340@findex mh-msg-is-in-seq
7341@kindex S l
7342@kindex S s
6874 7343
6875You can see which sequences in which a message appears with the 7344You can see which sequences in which a message appears with the
6876command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to 7345command @kbd{S s} (@code{mh-msg-is-in-seq}). Use a prefix argument to
@@ -6880,11 +7349,12 @@ folder (default is current folder) with @kbd{S l}
6880(@code{mh-list-sequences}). The list appears in a buffer named 7349(@code{mh-list-sequences}). The list appears in a buffer named
6881@samp{*MH-E Sequences*} (@pxref{Miscellaneous}). 7350@samp{*MH-E Sequences*} (@pxref{Miscellaneous}).
6882 7351
6883@cindex @samp{Previous-Sequence:} MH profile component
6884@cindex @samp{cur} sequence
6885@cindex MH profile component, @samp{Previous-Sequence:} 7352@cindex MH profile component, @samp{Previous-Sequence:}
6886@cindex sequence, @samp{Previous-Sequence} 7353@cindex @samp{cur} sequence
7354@cindex @samp{Previous-Sequence:} MH profile component
6887@cindex sequence, @samp{cur} 7355@cindex sequence, @samp{cur}
7356@cindex sequence, @samp{Previous-Sequence}
7357@vindex mh-refile-preserves-sequences-flag
6888 7358
6889If a message is in any sequence (except 7359If a message is in any sequence (except
6890@samp{Previous-Sequence:}@footnote{See @samp{mh-profile}(5)).} and 7360@samp{Previous-Sequence:}@footnote{See @samp{mh-profile}(5)).} and
@@ -6892,6 +7362,12 @@ If a message is in any sequence (except
6892sequences in the destination folder. If this behavior is not desired, 7362sequences in the destination folder. If this behavior is not desired,
6893then turn off the option @code{mh-refile-preserves-sequences-flag}. 7363then turn off the option @code{mh-refile-preserves-sequences-flag}.
6894 7364
7365@findex mh-delete-msg-from-seq
7366@findex mh-delete-seq
7367@kindex d
7368@kindex S d
7369@kindex S k
7370
6895If you want to remove a message (or range, @pxref{Ranges}) from a 7371If you want to remove a message (or range, @pxref{Ranges}) from a
6896sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want 7372sequence, use @kbd{S d} (@code{mh-delete-msg-from-seq}). If you want
6897to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In 7373to delete an entire sequence, use @kbd{S k} (@code{mh-delete-seq}). In
@@ -6901,8 +7377,18 @@ you want to delete the messages, use @kbd{C-u d} (@pxref{Reading
6901Mail}). 7377Mail}).
6902 7378
6903@cindex @samp{Unseen-Sequence:} MH profile component 7379@cindex @samp{Unseen-Sequence:} MH profile component
7380@cindex @samp{cur} sequence
7381@cindex @samp{tick} sequence
6904@cindex MH profile component, @samp{Unseen-Sequence:} 7382@cindex MH profile component, @samp{Unseen-Sequence:}
6905@cindex sequence, @samp{Unseen-Sequence} 7383@cindex sequence, @samp{Unseen-Sequence}
7384@cindex sequence, @samp{cur}
7385@cindex sequence, @samp{tick}
7386@findex mh-update-sequences
7387@kindex M-x mh-update-sequences
7388@kindex q
7389@kindex x
7390@vindex mh-tick-seq
7391@vindex mh-update-sequences-after-mh-show-flag
6906 7392
6907Three sequences are maintained internally by MH-E and pushed out to MH 7393Three sequences are maintained internally by MH-E and pushed out to MH
6908when a message is shown. They include the sequence specified by your 7394when a message is shown. They include the sequence specified by your
@@ -6923,6 +7409,8 @@ from the unseen sequence.
6923 7409
6924@cindex @command{mark} 7410@cindex @command{mark}
6925@cindex MH commands, @command{mark} 7411@cindex MH commands, @command{mark}
7412@kindex S n
7413@kindex S w
6926 7414
6927With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH 7415With the exceptions of @kbd{S n} and @kbd{S w}, the underlying MH
6928command dealing with sequences is @command{mark}@footnote{See the 7416command dealing with sequences is @command{mark}@footnote{See the
@@ -7005,6 +7493,8 @@ away. This chapter describes briefly how to configure these programs
7005to work well with MH-E and how to use MH-E's interface that provides 7493to work well with MH-E and how to use MH-E's interface that provides
7006continuing education for these programs. 7494continuing education for these programs.
7007 7495
7496@vindex mh-junk-program
7497
7008The default setting of the option @code{mh-junk-program} is 7498The default setting of the option @code{mh-junk-program} is
7009@samp{Auto-detect} which means that MH-E will automatically choose one 7499@samp{Auto-detect} which means that MH-E will automatically choose one
7010of SpamAssassin, bogofilter, or SpamProbe in that order. If, for 7500of SpamAssassin, bogofilter, or SpamProbe in that order. If, for
@@ -7012,6 +7502,10 @@ example, you have both SpamAssassin and bogofilter installed and you
7012want to use bogofilter, then you can set this option to 7502want to use bogofilter, then you can set this option to
7013@samp{Bogofilter}. 7503@samp{Bogofilter}.
7014 7504
7505@findex mh-junk-blacklist
7506@kindex J b
7507@vindex mh-junk-disposition
7508
7015The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam 7509The command @kbd{J b} (@code{mh-junk-blacklist}) trains the spam
7016program in use with the content of the range (@pxref{Ranges}) and then 7510program in use with the content of the range (@pxref{Ranges}) and then
7017handles the message(s) as specified by the option 7511handles the message(s) as specified by the option
@@ -7019,11 +7513,16 @@ handles the message(s) as specified by the option
7019@samp{Delete Spam} but you can also specify the name of the folder 7513@samp{Delete Spam} but you can also specify the name of the folder
7020which is useful for building a corpus of spam for training purposes. 7514which is useful for building a corpus of spam for training purposes.
7021 7515
7516@findex mh-junk-whitelist
7517@kindex J w
7518
7022In contrast, the command @kbd{J w} (@code{mh-junk-whitelist}) 7519In contrast, the command @kbd{J w} (@code{mh-junk-whitelist})
7023reclassifies a range of messages (@pxref{Ranges}) as ham if it were 7520reclassifies a range of messages (@pxref{Ranges}) as ham if it were
7024incorrectly classified as spam. It then refiles the message into the 7521incorrectly classified as spam. It then refiles the message into the
7025@file{+inbox} folder. 7522@file{+inbox} folder.
7026 7523
7524@vindex mh-junk-background
7525
7027By default, the programs are run in the foreground, but this can be 7526By default, the programs are run in the foreground, but this can be
7028slow when junking large numbers of messages. If you have enough memory 7527slow when junking large numbers of messages. If you have enough memory
7029or don't junk that many messages at the same time, you might try 7528or don't junk that many messages at the same time, you might try
@@ -7035,7 +7534,10 @@ MH-E can work with.
7035@cindex @file{.procmailrc} 7534@cindex @file{.procmailrc}
7036@cindex files, @file{.procmailrc} 7535@cindex files, @file{.procmailrc}
7037 7536
7038@heading SpamAssassin 7537@subheading SpamAssassin
7538
7539@cindex Spamassassin
7540@cindex spam filters, Spamassassin
7039 7541
7040SpamAssassin is one of the more popular spam filtering programs. Get 7542SpamAssassin is one of the more popular spam filtering programs. Get
7041it from your local distribution or from the 7543it from your local distribution or from the
@@ -7088,6 +7590,11 @@ the @samp{+spam} folder for later review. The major weakness of
7088rules-based filters is a plethora of false positives so it is 7590rules-based filters is a plethora of false positives so it is
7089worthwhile to check. 7591worthwhile to check.
7090 7592
7593@findex mh-junk-blacklist
7594@findex mh-junk-whitelist
7595@kindex J b
7596@kindex J w
7597
7091If SpamAssassin classifies a message incorrectly, or is unsure, you can 7598If SpamAssassin classifies a message incorrectly, or is unsure, you can
7092use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and 7599use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and
7093@kbd{J w} (@code{mh-junk-whitelist}). 7600@kbd{J w} (@code{mh-junk-whitelist}).
@@ -7133,7 +7640,10 @@ done by adding the following to your @file{crontab}:
71330 * * * * sa-learn --rebuild > /dev/null 2>&1 76400 * * * * sa-learn --rebuild > /dev/null 2>&1
7134@end smallexample 7641@end smallexample
7135 7642
7136@heading Bogofilter 7643@subheading Bogofilter
7644
7645@cindex bogofilter
7646@cindex spam filters, bogofilter
7137 7647
7138Bogofilter is a Bayesian spam filtering program. Get it from your 7648Bogofilter is a Bayesian spam filtering program. Get it from your
7139local distribution or from the 7649local distribution or from the
@@ -7179,6 +7689,11 @@ spam/.
7179spam/unsure/. 7689spam/unsure/.
7180@end smallexample 7690@end smallexample
7181 7691
7692@findex mh-junk-blacklist
7693@findex mh-junk-whitelist
7694@kindex J b
7695@kindex J w
7696
7182If bogofilter classifies a message incorrectly, or is unsure, you can 7697If bogofilter classifies a message incorrectly, or is unsure, you can
7183use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J 7698use the MH-E commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J
7184w} (@code{mh-junk-whitelist}) to update bogofilter's training. 7699w} (@code{mh-junk-whitelist}) to update bogofilter's training.
@@ -7195,7 +7710,10 @@ mv wordlist.db.new wordlist.db
7195The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune 7710The @cite{Bogofilter tuning HOWTO} describes how you can fine-tune
7196bogofilter. 7711bogofilter.
7197 7712
7198@heading SpamProbe 7713@subheading SpamProbe
7714
7715@cindex SpamProbe
7716@cindex spam filters, SpamProbe
7199 7717
7200SpamProbe is a Bayesian spam filtering program. Get it from your local 7718SpamProbe is a Bayesian spam filtering program. Get it from your local
7201distribution or from the @uref{http://spamprobe.sourceforge.net, 7719distribution or from the @uref{http://spamprobe.sourceforge.net,
@@ -7222,11 +7740,16 @@ SCORE=| spamprobe receive
7222spam/. 7740spam/.
7223@end smallexample 7741@end smallexample
7224 7742
7743@findex mh-junk-blacklist
7744@findex mh-junk-whitelist
7745@kindex J b
7746@kindex J w
7747
7225If SpamProbe classifies a message incorrectly, you can use the MH-E 7748If SpamProbe classifies a message incorrectly, you can use the MH-E
7226commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w} 7749commands @kbd{J b} (@code{mh-junk-blacklist}) and @kbd{J w}
7227(@code{mh-junk-whitelist}) to update SpamProbe's training. 7750(@code{mh-junk-whitelist}) to update SpamProbe's training.
7228 7751
7229@heading Other Things You Can Do 7752@subheading Other Things You Can Do
7230 7753
7231There are a couple of things that you can add to @file{~/.procmailrc} 7754There are a couple of things that you can add to @file{~/.procmailrc}
7232in order to filter out a lot of spam and viruses. The first is to 7755in order to filter out a lot of spam and viruses. The first is to
@@ -7286,10 +7809,11 @@ Display version information about MH-E and the MH mail handling
7286system. 7809system.
7287@end ftable 7810@end ftable
7288 7811
7289@cindex @samp{*MH-E Info*}
7290@cindex MH-E version
7291@cindex buffers, @samp{*MH-E Info*} 7812@cindex buffers, @samp{*MH-E Info*}
7813@cindex MH-E version
7814@cindex @samp{*MH-E Info*}
7292@cindex version 7815@cindex version
7816@kindex M-x mh-version
7293 7817
7294One command worth noting is @kbd{M-x mh-version}. You can compare the 7818One command worth noting is @kbd{M-x mh-version}. You can compare the
7295version this command prints to the latest release (@pxref{Getting 7819version this command prints to the latest release (@pxref{Getting
@@ -7297,7 +7821,7 @@ MH-E}). The output of @kbd{M-x mh-version}, found in a buffer named
7297@samp{*MH-E Info*}, should usually be included with any bug report you 7821@samp{*MH-E Info*}, should usually be included with any bug report you
7298submit (@pxref{Bug Reports}). 7822submit (@pxref{Bug Reports}).
7299 7823
7300@heading MH-E Buffers 7824@subheading MH-E Buffers
7301 7825
7302Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates 7826Besides the MH-Folder, MH-Show, and MH-Letter buffers, MH-E creates
7303several other buffers. They are: 7827several other buffers. They are:
@@ -7354,7 +7878,7 @@ This buffer contains the output of @kbd{S l}
7354@c ------------------------- 7878@c -------------------------
7355@cindex @samp{*mh-temp*} 7879@cindex @samp{*mh-temp*}
7356@cindex buffers, @samp{*mh-temp*} 7880@cindex buffers, @samp{*mh-temp*}
7357@item *mh-temp 7881@item *mh-temp*
7358This is a scratch, ephemeral, buffer used by MH-E functions. Note that 7882This is a scratch, ephemeral, buffer used by MH-E functions. Note that
7359it is hidden because the first character in the name is a space. 7883it is hidden because the first character in the name is a space.
7360You'll generally not have any need for this buffer. 7884You'll generally not have any need for this buffer.
@@ -7389,9 +7913,7 @@ Specifies the format file to pass to the scan program (default:
7389Program used to scan messages (default: @code{"scan"}). 7913Program used to scan messages (default: @code{"scan"}).
7390@end vtable 7914@end vtable
7391 7915
7392@findex mh-set-cmd-note
7393@vindex mh-adaptive-cmd-note-flag 7916@vindex mh-adaptive-cmd-note-flag
7394@vindex mh-scan-format-file
7395 7917
7396There are a couple of caveats when creating your own scan format file. 7918There are a couple of caveats when creating your own scan format file.
7397First, MH-E will not work if your scan lines do not include message 7919First, MH-E will not work if your scan lines do not include message
@@ -7401,6 +7923,9 @@ the option @code{mh-adaptive-cmd-note-flag} or the threading features
7401(@pxref{Threading}). 7923(@pxref{Threading}).
7402 7924
7403@cindex message numbers 7925@cindex message numbers
7926@findex mh-set-cmd-note
7927@vindex mh-adaptive-cmd-note-flag
7928@vindex mh-scan-format-file
7404 7929
7405If you've created your own format to handle long message numbers, 7930If you've created your own format to handle long message numbers,
7406you'll be pleased to know you no longer need it since MH-E adapts its 7931you'll be pleased to know you no longer need it since MH-E adapts its
@@ -7411,8 +7936,10 @@ and call @code{mh-set-cmd-note} with the width specified by your
7411format file (see @code{mh-scan-format-file}). For example, the default 7936format file (see @code{mh-scan-format-file}). For example, the default
7412width is 4, so you would use @samp{(mh-set-cmd-note 4)}. 7937width is 4, so you would use @samp{(mh-set-cmd-note 4)}.
7413 7938
7414@vindex mh-scan-format-nmh 7939@vindex mh-adaptive-cmd-note-flag
7940@vindex mh-scan-format-file
7415@vindex mh-scan-format-mh 7941@vindex mh-scan-format-mh
7942@vindex mh-scan-format-nmh
7416 7943
7417The default setting for @code{mh-scan-format-file} is @samp{Use MH-E 7944The default setting for @code{mh-scan-format-file} is @samp{Use MH-E
7418scan Format}. This means that the format string will be taken from the 7945scan Format}. This means that the format string will be taken from the
@@ -7425,6 +7952,10 @@ shell. If you have a format file that you want MH-E to use but not MH,
7425you can set this option to @samp{Specify a scan Format File} and enter 7952you can set this option to @samp{Specify a scan Format File} and enter
7426the name of your format file. 7953the name of your format file.
7427 7954
7955@vindex mh-scan-format-file
7956@vindex mh-scan-format-mh
7957@vindex mh-scan-format-nmh
7958
7428The scan format that MH-E uses when @code{mh-scan-format-file} is set 7959The scan format that MH-E uses when @code{mh-scan-format-file} is set
7429to its default of @samp{Use MH-E scan Format} is held in the variables 7960to its default of @samp{Use MH-E scan Format} is held in the variables
7430@code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on 7961@code{mh-scan-format-nmh} and @code{mh-scan-format-mh} depending on
@@ -7448,8 +7979,9 @@ The value of @code{mh-scan-format-nmh} is:
7448 "%(decode@{subject@})%<@{body@}<<%@{body@}%>") 7979 "%(decode@{subject@})%<@{body@}<<%@{body@}%>")
7449@end smallexample 7980@end smallexample
7450 7981
7451@cindex RFC 2047, decoding
7452@cindex decoding RFC 2047 7982@cindex decoding RFC 2047
7983@cindex RFC 2047, decoding
7984@vindex mh-scan-format-mh
7453 7985
7454The setting for @code{mh-scan-format-mh} is similar, except that MH 7986The setting for @code{mh-scan-format-mh} is similar, except that MH
7455doesn't have the function @code{decode} (which is used to decode RFC 7987doesn't have the function @code{decode} (which is used to decode RFC
@@ -7484,6 +8016,8 @@ produce a different type of listing@footnote{See the section
7484pick Ranges Sequences} in the MH book.}. 8016pick Ranges Sequences} in the MH book.}.
7485 8017
7486@cindex regular expressions, scan line formats 8018@cindex regular expressions, scan line formats
8019@findex mh-set-cmd-note
8020@findex setq
7487 8021
7488If you change the format of the scan lines you'll need to tell MH-E 8022If you change the format of the scan lines you'll need to tell MH-E
7489how to parse the new format. As you will see, quite a lot of variables 8023how to parse the new format. As you will see, quite a lot of variables
@@ -7521,8 +8055,6 @@ prev} in the MH book.} or @command{scan} (default: @code{"^ *[0-9]"}).
7521 8055
7522Next, many variables control how the scan lines are parsed. 8056Next, many variables control how the scan lines are parsed.
7523 8057
7524@vindex mh-folder-font-lock-keywords
7525
7526@vtable @code 8058@vtable @code
7527@vindex mh-folder-body 8059@vindex mh-folder-body
7528@vindex mh-folder-font-lock-keywords 8060@vindex mh-folder-font-lock-keywords
@@ -7693,6 +8225,8 @@ Finally, there are a slew of variables that control how MH-E annotates
7693the scan lines. 8225the scan lines.
7694 8226
7695@vtable @code 8227@vtable @code
8228@findex mh-set-cmd-note
8229@vindex mh-adaptive-cmd-note-flag
7696@item mh-cmd-note 8230@item mh-cmd-note
7697Column for notations (default: 4). This variable should be set with 8231Column for notations (default: 4). This variable should be set with
7698the function @code{mh-set-cmd-note}. This variable may be updated 8232the function @code{mh-set-cmd-note}. This variable may be updated
@@ -7704,10 +8238,12 @@ Emacs start with 0.
7704Messages that have been copied are marked by this character (default: 8238Messages that have been copied are marked by this character (default:
7705@code{?C}). 8239@code{?C}).
7706@c ------------------------- 8240@c -------------------------
8241@vindex mh-scan-cur-msg-number-regexp
7707@item mh-note-cur 8242@item mh-note-cur
7708The current message (in MH, not in MH-E) is marked by this character 8243The current message (in MH, not in MH-E) is marked by this character
7709(default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}. 8244(default: @code{?+}). See also @code{mh-scan-cur-msg-number-regexp}.
7710@c ------------------------- 8245@c -------------------------
8246@vindex mh-scan-deleted-msg-regexp
7711@item mh-note-deleted 8247@item mh-note-deleted
7712Messages that have been deleted are marked by this character (default: 8248Messages that have been deleted are marked by this character (default:
7713@code{?D}). See also @code{mh-scan-deleted-msg-regexp}. 8249@code{?D}). See also @code{mh-scan-deleted-msg-regexp}.
@@ -7724,6 +8260,7 @@ Messages that have been forwarded are marked by this character
7724Messages that have been printed are marked by this character (default: 8260Messages that have been printed are marked by this character (default:
7725@code{?P}). 8261@code{?P}).
7726@c ------------------------- 8262@c -------------------------
8263@vindex mh-scan-refiled-msg-regexp
7727@item mh-note-refiled 8264@item mh-note-refiled
7728Messages that have been refiled are marked by this character (default: 8265Messages that have been refiled are marked by this character (default:
7729@code{?^}). See also @code{mh-scan-refiled-msg-regexp}. 8266@code{?^}). See also @code{mh-scan-refiled-msg-regexp}.
@@ -7747,6 +8284,8 @@ message according to MH; it also uses that column for notations.
7747%20(decode(friendly@{from@})) %50(decode@{subject@}) %4(msg)%<(cur)+%| %> 8284%20(decode(friendly@{from@})) %50(decode@{subject@}) %4(msg)%<(cur)+%| %>
7748@end example 8285@end example
7749 8286
8287@vindex mh-adaptive-cmd-note-flag
8288@vindex mh-scan-format-file
7750@vindex mh-scan-format-file, example 8289@vindex mh-scan-format-file, example
7751 8290
7752The first thing you have to do is tell MH-E to use this file. 8291The first thing you have to do is tell MH-E to use this file.
@@ -7931,9 +8470,10 @@ Select the @samp{Several files in a directory} value, check the
7931@samp{Path} box and enter @file{~/Mail} to tell Gnus where to find 8470@samp{Path} box and enter @file{~/Mail} to tell Gnus where to find
7932your mail. 8471your mail.
7933@c ------------------------- 8472@c -------------------------
8473@vindex mail-user-agent
7934@item message-mail-user-agent 8474@item message-mail-user-agent
7935In order to send mail within Gnus using MH-E, set this option to 8475In order to send mail within Gnus using MH-E, set this option to
7936@samp{mail-user-agent} and set the @samp{mail-user-agent} option to 8476@samp{mail-user-agent} and set the @code{mail-user-agent} option to
7937@samp{Emacs interface to MH}. 8477@samp{Emacs interface to MH}.
7938@c ------------------------- 8478@c -------------------------
7939@item nnmail-keep-last-article 8479@item nnmail-keep-last-article
@@ -7981,8 +8521,9 @@ I also point out some additional sources of information.
7981@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends 8521@node Bug Reports, Mailing Lists, Odds and Ends, Odds and Ends
7982@appendixsec Bug Reports 8522@appendixsec Bug Reports
7983 8523
7984@cindex SourceForge
7985@cindex bugs 8524@cindex bugs
8525@cindex SourceForge
8526@kindex M-x mh-version
7986 8527
7987Bug reports should be filed at 8528Bug reports should be filed at
7988@uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You 8529@uref{https://sourceforge.net/bugs/?group_id=13357, SourceForge}. You
@@ -8040,7 +8581,6 @@ distribution in @file{miscellany/mh-e}.
8040@cindex change log 8581@cindex change log
8041@cindex release notes 8582@cindex release notes
8042 8583
8043@c intentionally wordy to avoid overfull hbox
8044New MH-E releases are always available for downloading at 8584New MH-E releases are always available for downloading at
8045@uref{https://sourceforge.net/project/showfiles.php?group_id=13357, 8585@uref{https://sourceforge.net/project/showfiles.php?group_id=13357,
8046SourceForge} before they appear in an Emacs release. You can read the 8586SourceForge} before they appear in an Emacs release. You can read the
@@ -8050,11 +8590,12 @@ change log to see if you are interested in what the given release of
8050MH-E has to offer (although we have no doubt that you will be 8590MH-E has to offer (although we have no doubt that you will be
8051extremely interested in all new releases). 8591extremely interested in all new releases).
8052 8592
8053@cindex @samp{MH-E-NEWS}
8054@cindex @samp{README}
8055@cindex files, @samp{MH-E-NEWS} 8593@cindex files, @samp{MH-E-NEWS}
8056@cindex files, @samp{README} 8594@cindex files, @samp{README}
8057@cindex news 8595@cindex news
8596@cindex @samp{MH-E-NEWS}
8597@cindex @samp{README}
8598@kindex M-x mh-version
8058 8599
8059After you download and extract the MH-E tarball, read the 8600After you download and extract the MH-E tarball, read the
8060@file{README} file and @file{MH-E-NEWS}. These correspond to the 8601@file{README} file and @file{MH-E-NEWS}. These correspond to the
@@ -8247,20 +8788,24 @@ was incorporated into @w{Emacs 19.29}.
8247After a long break, Stephen handed the reins over to me in 2000. I 8788After a long break, Stephen handed the reins over to me in 2000. I
8248moved the project to a new site called SourceForge and organized a 8789moved the project to a new site called SourceForge and organized a
8249great team of developers. Our first release in late 2001 was version 8790great team of developers. Our first release in late 2001 was version
82506. It appeared in Emacs 21.2 and had menus and tool bar buttons. 87916. It appeared around the time of Emacs 21.2 and had menus and tool
8792bar buttons.
8251 8793
8252Then, indexed searches, improved MIME handling, a speedbar, multiple 8794Then, indexed searches, improved MIME handling, a speedbar, multiple
8253identities, alias completion, an index view of unseen messages, spam 8795identities, alias completion, an index view of unseen messages, spam
8254software support, Face and X-Image-URL header field support, Fcc 8796software support, Face and X-Image-URL header field support, Fcc
8255completion, arbitrary range handling, and draft form editing were 8797completion, arbitrary range handling, and draft form editing were
8256introduced in the version 7 series in Emacs 21.4 (2004). 8798introduced in the version 7 series around the time of Emacs 21.4
8799(2004). Still, Emacs itself contained version 5 of MH-E released back
8800in 1994.
8257 8801
8258Version 8 development was mostly driven by the rewrite of the manual. 8802Version 8 development was mostly driven by the rewrite of the manual.
8259It also brought mailutils support, S/MIME support, picon support, and 8803It also brought mailutils support, S/MIME support, picon support, and
8260an improved interface for hiding header fields. The CVS repository was 8804an improved interface for hiding header fields. The CVS repository was
8261migrated from SourceForge to Savannah (only for those files that were 8805migrated from SourceForge to Savannah (only for those files that were
8262already part of Emacs) and the software was completely reorganized to 8806already part of Emacs) and the software was completely reorganized to
8263push back two decades of entropy. It appeared in Emacs 22.1 (2006). 8807push back two decades of entropy. Version 8 will appear in Emacs 22.1,
8808expected to be released in 2006.
8264 8809
8265Bill Wohler, February 2006 8810Bill Wohler, February 2006
8266 8811