X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/9850eff524bd0747a9561f3b4c90dfc3749f4ecb..2a1cf2b9aad0bc5685d1ea3c3e85afd212c659d3:/doc/misc/mh-e.texi diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi index 77c774cc08..b9739620f3 100644 --- a/doc/misc/mh-e.texi +++ b/doc/misc/mh-e.texi @@ -8,12 +8,12 @@ @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 @@ -24,20 +24,34 @@ 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 @@ -48,7 +62,6 @@ developing GNU and promoting software freedom.'' @end direntry @c Title Page -@setchapternewpage odd @titlepage @title The MH-E Manual @subtitle Version @value{VERSION}@value{EDITION} @@ -107,6 +120,7 @@ developing GNU and promoting software freedom.'' * 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 @@ -563,7 +577,8 @@ the more you can leverage its power. See the @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. @@ -2651,7 +2666,7 @@ documentation for the Gnus command @kbd{W h} (see section @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. @@ -3397,6 +3412,10 @@ Hook run by @code{mh-folder-mode} when visiting a new folder (default: 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 ------------------------- @@ -3713,6 +3732,13 @@ to rescan the folder, which is useful to grab all messages in your 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 @@ -8025,8 +8051,11 @@ Program used to scan messages (default: @code{"scan"}). 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 @@ -8928,11 +8957,15 @@ new features and several bug fixes. 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