@c %**end of header
@c Version of the software and manual.
-@set VERSION 8.0.3+CVS
+@set VERSION 8.1
@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-03-16
-@set UPDATE-MONTH March, 2008
+@set UPDATED 2009-01-02
+@set UPDATE-MONTH January, 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
+Copyright @copyright{} 1995, 2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009
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
* 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
them.
The MH-E package is distributed with GNU Emacs@footnote{Version
-@value{VERSION} of MH-E will appear in GNU Emacs 22.1. It is supported
-in GNU Emacs 21, as well as XEmacs 21 (except for versions
+@value{VERSION} of MH-E will appear in GNU Emacs 23.1. It is supported
+in GNU Emacs 21 and 22, as well as XEmacs 21 (except for versions
21.5.9-21.5.16). It is compatible with MH versions 6.8.4 and higher,
all versions of nmh, and GNU mailutils 1.0 and higher.}, so you
shouldn't have to do anything special to use it. Gnus is also
@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.
To: wohler
cc:
Subject: Test
-X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
+X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
--------
This is a test message to get the wheels churning...#
-:%% @{+inbox/select@} 4 msgs (1-4) Bot L4 (MH-Folder Show)---------
To: wohler
Subject: Test
-X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
+X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
Date: Fri, 17 Mar 2006 10:49:11 -0800
From: Bill Wohler <wohler@@stop.mail-abuse.org>
References: <31054.1142621351@@stop.mail-abuse.org>
Comments: In-reply-to Bill Wohler <wohler@@stop.mail-abuse.org>
message dated "Fri, 17 Mar 2006 10:49:11 -0800."
-X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
+X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
--------
#
--:-- @{draft@} All L10 (MH-Letter)----------------------------------
To: wohler
Subject: Test
-X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
+X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
Date: Fri, 17 Mar 2006 10:49:11 -0800
From: Bill Wohler <wohler@@stop.mail-abuse.org>
@cindex Unix commands, @command{xbuffy}
You can use @command{xbuffy} to automate the incorporation of this
-mail using the Emacs 22 command @command{emacsclient} as follows:
+mail using the Emacs 23 command @command{emacsclient} as follows:
@smallexample
box ~/mail/mh-e
To: wohler
cc:
Subject: Test of MIME
-X-Mailer: MH-E 8.0; nmh 1.1; GNU Emacs 22.1
+X-Mailer: MH-E 8.1; nmh 1.1; GNU Emacs 23.1
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
--------
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
support, and an improved interface for hiding header fields. The CVS
repository was migrated from SourceForge to Savannah (only for those
files that were already part of Emacs) and the software was completely
-reorganized to push back two decades of entropy. Version 8 will appear
-in Emacs 22.1, expected to be released in 2006.
+reorganized to push back two decades of entropy. Version 8 appeared in
+Emacs 22.1 in 2006.
-Bill Wohler, February 2006
+Development was then quiet for a couple of years. Emacs 23.1, which is
+due out in 2009, will contain version 8.1. This version includes a few
+new features and several bug fixes.
-@node GFDL, Key Index, History, Top
-@appendix GNU FREE DOCUMENTATION LICENSE
+Bill Wohler, August 2008
+
+@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