@c %**end of header
@c Version of the software and manual.
-@set VERSION 8.1
+@set VERSION 8.2
@c Edition of the manual. It is either empty for the first edition or
@c has the form ", nth Edition" (without the quotes).
@set EDITION
-@set UPDATED 2008-08-18
-@set UPDATE-MONTH August, 2008
+@set UPDATED 2009-06-13
+@set UPDATE-MONTH June, 2009
@c Other variables.
@set MH-BOOK-HOME http://rand-mh.sourceforge.net/book/mh
This is version @value{VERSION}@value{EDITION} of @cite{The MH-E
Manual}, last updated @value{UPDATED}.
-Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007, 2008
-Free Software Foundation, Inc.
+Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007, 2008,
+ 2009, 2010 Free Software Foundation, Inc.
+
+@c This dual license has been agreed upon by the FSF.
@quotation
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
-and with the Back-Cover Texts as in (a) below. A copy of the license
-is included in the section entitled ``GNU Free Documentation License.''
+under the terms of either:
+
+@enumerate a
+@item
+the GNU Free Documentation License, Version 1.3 or any later version
+published by the Free Software Foundation; with no Invariant Sections,
+with the Front-Cover texts being ``A GNU Manual,'' and with the
+Back-Cover Texts as in (a) below. A copy of the license is included in
+the section entitled ``GNU Free Documentation License.''
(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
-modify this GNU manual. Buying copies from the FSF supports it in
+modify this GNU manual. Buying copies from the FSF supports it in
developing GNU and promoting software freedom.''
+
+@item
+the GNU General Public License as published by the Free Software
+Foundation; either version 3, or (at your option) any later version. A
+copy of the license is included in the section entitled ``GNU General
+Public License.''
+@end enumerate
+
@end quotation
@end copying
@c Info Directory Entry
@dircategory Emacs
@direntry
-* MH-E: (mh-e). Emacs interface to the MH mail system.
+* MH-E: (mh-e). Emacs interface to the MH mail system.
@end direntry
@c Title Page
-@setchapternewpage odd
@titlepage
@title The MH-E Manual
@subtitle Version @value{VERSION}@value{EDITION}
* Odds and Ends:: Odds and Ends
* History:: History of MH-E
* GFDL:: GNU Free Documentation License
+* GPL:: GNU General Public License
* Key Index:: Key (Character) Index
* Command Index:: Command Index
* Option Index:: Option (Variable) Index
@cindex MH profile component, @samp{Path:}
Your MH environment includes your @dfn{MH profile} which is found in
-the file @file{~/.mh_profile}. This file contains a number of @dfn{MH
+the file @file{~/.mh_profile}, or the file named in the environment
+variable @samp{$MH}. This file contains a number of @dfn{MH
profile components}. For example, the @samp{Path:} MH profile
component contains the path to your mail directory, which is
@file{~/Mail} by default.
@findex browse-url-at-mouse
@kindex S-Mouse-2
-A useful key binding that you can add to to @file{~/.emacs} is the
+A useful key binding that you can add to @file{~/.emacs} is the
following which displays an HTML link or textual URL in an external
browser when clicked with @kbd{S-mouse-2}. This binding works in any
buffer, including HTML buffers.
Abnormal hook run at the beginning of @code{mh-kill-folder} (default:
@code{'mh-search-p}).
@c -------------------------
+@item mh-pack-folder-hook
+Hook run by @code{mh-pack-folder} after renumbering the messages
+(default: @code{nil}).
+@c -------------------------
@item mh-quit-hook
Hook run by q after quitting MH-E (default: @code{nil}).
@c -------------------------
you don't want to rescan the entire folder, the commands @kbd{F r} or
@kbd{F p} will accept a range (@pxref{Ranges}).
+@kindex F p
+@vindex mh-pack-folder-hook
+
+The command @kbd{F p} runs @code{mh-pack-folder-hook} after
+renumbering the messages. A variable that is useful with this hook
+is @code{mh-current-folder}.
+
@kindex @key{TAB}
@vindex mh-recursive-folders-flag
# are subfolders within the folder
mh=archive...:inbox:drafts:news:sent:trash
-vfolder_format=raw
-database=/home/user/Mail/mairix/database
+vfolder_format=mh
+database=/home/user/Mail/.mairix/database
@end group
@end smallexample
@smallexample
mknmz -f /home/user/Mail/.namazu/mknmzrc -O /home/user/Mail/.namazu \
- /home/user/Mail
+ -q /home/user/Mail
@end smallexample
@subsection pick
done by adding the following to your @file{crontab}:
@smallexample
-0 * * * * sa-learn --rebuild > /dev/null 2>&1
+0 * * * * sa-learn --rebuild > /dev/null 2>&1
@end smallexample
@subheading Bogofilter
There are a couple of caveats when creating your own scan format file.
First, MH-E will not work if your scan lines do not include message
numbers. It will work poorly if you don't dedicate a column for
-showing the current message and notations. You won't be able to use
-the option @code{mh-adaptive-cmd-note-flag} or the threading features
+showing the current message and notations. It is also best to keep the
+first column empty to make room for the cursor and so that text isn't
+obscured by the current message's overlay arrow when running in a
+terminal. You won't be able to use the option
+@code{mh-adaptive-cmd-note-flag} or the threading features
(@pxref{Threading}).
@cindex message numbers
Bill Wohler, August 2008
-@node GFDL, Key Index, History, Top
-@appendix GNU FREE DOCUMENTATION LICENSE
+@node GFDL, GPL, History, Top
+@appendix GNU Free Documentation License
@include doclicense.texi
-@node Key Index, Command Index, GFDL, Top
+@node GPL, Key Index, GFDL, Top
+@appendix GNU General Public License
+@include gpl.texi
+
+@node Key Index, Command Index, GPL, Top
@unnumbered Key (Character) Index
@printindex ky