# HG changeset patch # User Bill Wohler # Date 1145916933 0 # Node ID 4d2e0eb216a262ee7c929b5e1db4629fbd0c9b32 # Parent 4f34f2ecee373f32da0eb3681be387213fe092dd (Getting Started): Made it more explicit that you need to install MH, and also included pointers to current MH implementations. diff -r 4f34f2ecee37 -r 4d2e0eb216a2 man/ChangeLog --- a/man/ChangeLog Mon Apr 24 21:59:03 2006 +0000 +++ b/man/ChangeLog Mon Apr 24 22:15:33 2006 +0000 @@ -1,3 +1,8 @@ +2006-04-24 Bill Wohler + + * mh-e.texi (Getting Started): Made it more explicit that you need + to install MH, and also included pointers to current MH implementations. + 2006-04-23 Richard Stallman * emacs.texi [TeX]: Use xresmini.texi instead of xresources.texi. diff -r 4f34f2ecee37 -r 4d2e0eb216a2 man/mh-e.texi --- a/man/mh-e.texi Mon Apr 24 21:59:03 2006 +0000 +++ b/man/mh-e.texi Mon Apr 24 22:15:33 2006 +0000 @@ -11,8 +11,8 @@ @set VERSION 7.94 @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 2006-04-21 +@set EDITION , 2nd Edition +@set UPDATED 2006-04-24 @set UPDATE-MONTH April, 2006 @c Other variables. @@ -245,6 +245,8 @@ the individual MH commands. When the name is not obvious, I'll guide you to a relevant MH manual page that describes the action more fully. +@cindex @cite{MH & nmh: Email for Users & Programmers} +@cindex MH book @cindex info @kindex C-h i @@ -536,12 +538,49 @@ installing MH-E. If the @code{mh-version} command displays @samp{No MH variant -detected}, then you need to install MH or tell MH-E where to find -MH@footnote{In very old versions of MH-E, you may get the error +detected}@footnote{In very old versions of MH-E, you may get the error message, @samp{Cannot find the commands `inc' and `mhl' and the file `components'} if MH-E can't find MH. In this case, you need to update MH-E, and you may need to install MH too. However, newer versions of -MH-E are better at finding MH if it is on your system.}. +MH-E are better at finding MH if it is on your system.}, then you need +to install MH or tell MH-E where to find MH. + +@cindex Debian +@cindex nmh +@cindex GNU mailutils + +If you don't have MH on your system already, you must install a +variant of MH. The Debian mh-e package does this for you automatically +(@pxref{Getting MH-E}). Most people use +@uref{http://www.nongnu.org/nmh/, nmh}, but you may be interested in +trying out @uref{http://www.gnu.org/software/mailutils/, GNU +mailutils}, which supports IMAP. Your GNU/Linux distribution probably +has packages for both of these. + +@cindex @command{install-mh} +@cindex MH commands, @command{install-mh} +@cindex MH book + +If you've never run MH before, you need to run @command{install-mh} +from the shell before you continue. This sets up your personal MH +environment@footnote{See the section +@uref{@value{MH-BOOK-HOME}/../overall/setup.htm, Setting Up MH} in the +MH book.}. If you don't, you'll be greeted with the error message: +@samp{Install MH and run install-mh before running MH-E}. This is all +you need to know about MH to use MH-E, but the more you know about MH, +the more you can leverage its power. See the +@uref{@value{MH-BOOK-HOME}, MH book} to learn more about MH. + +@cindex @samp{Path:} MH profile component +@cindex MH profile +@cindex MH profile component +@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 +profile components}. For example, the @samp{Path:} MH profile +component contains the path to your mail directory, which is +@file{~/Mail} by default. @cindex @command{mhparam} @cindex MH commands, @command{mhparam} @@ -551,8 +590,9 @@ @vindex mh-variant @vindex mh-variant-in-use -The option @code{mh-variant} specifies the variant used by MH-E -(@pxref{Options}). The default setting of this option is +There are several options MH-E uses to interact with your MH +installation. The option @code{mh-variant} specifies the variant used +by MH-E (@pxref{Options}). The default setting of this option is @samp{Auto-detect} which means that MH-E will automatically choose the first of nmh, MH, or GNU mailutils that it finds in the directories listed in @code{mh-path} (which you can customize), @@ -585,27 +625,6 @@ @end quotation @sp 1 -@cindex @command{install-mh} -@cindex MH commands, @command{install-mh} - -If you've never run MH before, you need to run @command{install-mh} -from the shell before you continue. This sets up your personal MH -environment@footnote{See the section -@uref{@value{MH-BOOK-HOME}/../overall/setup.htm, Setting Up MH} in the -MH book.}. If you don't, you'll be greeted with the error message: -@samp{Install MH and run install-mh before running MH-E}. - -@cindex @samp{Path:} MH profile component -@cindex MH profile -@cindex MH profile component -@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 -profile components}. For example, the @samp{Path:} MH profile -component contains the path to your mail directory, which is -@file{~/Mail} by default. - @cindex MH profile component, @samp{Draft-Folder:} @cindex MH profile component, @samp{Path:} @cindex MH profile component, @samp{Previous-Sequence:} @@ -8609,6 +8628,12 @@ MH-E has to offer (although we have no doubt that you will be extremely interested in all new releases). +@cindex Debian + +If you use Debian, you can install the Debian +@uref{http://packages.debian.org/unstable/mail/mh-e, mh-e package} +instead. + @cindex files, @samp{MH-E-NEWS} @cindex files, @samp{README} @cindex news