X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Finstall-mh.man;h=ce1f61da4922ecbff1791d29b70ff1b879edd1fd;hp=c00f678e6b4840103621b6175b16bdf18668defc;hb=d8916ff5d389de5ab225cd6f40aeda1b285d0f28;hpb=1691e80890e5d8ba258c51c214a3e91880e1db2b

diff --git a/man/install-mh.man b/man/install-mh.man
index c00f678..ce1f61d 100644
--- a/man/install-mh.man
+++ b/man/install-mh.man
@@ -2,48 +2,90 @@
 .\" %nmhwarning%
 .\" $Id$
 .\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.TH INSTALL-MH %manext8% MH.6.8 [%nmhversion%]
+.TH INSTALL-MH %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 install-mh \- initialize the nmh environment
 .SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/install\-mh
-\%[\-auto]
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.na
+.B install\-mh
+.RB [ \-auto ]
+.RB [ \-check ]
+.RB [ \-version ]
+.RB [ \-help ]
+.ad
 .SH DESCRIPTION
-\fIInstall\-mh\fR is the \fInmh\fR program to create the initial setup
-for a first\-time \fInmh\fR user.  It is typically invoked by other
-\fInmh\fR commands, and should NOT be directly invoked by the user.
-
-When a user runs any \fInmh\fR program for the first time, the program
-will invoke \fIinstall\-mh\fR (with the `\-auto' switch) to query
-the user for the initial \fInmh\fR environment.  The user is asked
+.B Install\-mh
+is the
+.B nmh
+program to create the initial setup
+for a first\-time
+.B nmh
+user.
+.B Install\-mh
+lives in two places for historical reasons.
+.PP
+The \fB\-auto\fP option does things as automatically as possible and
+makes \fBinstall\-mh\fP less chatty.
+.PP
+The user is asked
 for the name of the directory that will be designated as the user's
-\fInmh\fR directory.  If this directory does not exist, the user is
+.B nmh
+directory.  If this directory does not exist, the user is
 asked if it should be created.  Normally, this directory should be
-under the user's home directory, and has the default name of Mail/.
-After \fIinstall\-mh\fR has written the initial \&.mh\(ruprofile for
-the user, control returns to the original \fInmh\fR program.
-
-As with all \fInmh\fR commands, \fIinstall\-mh\fR first consults the
-\fB$HOME\fR environment variable to determine the user's home directory.
-If \fB$HOME\fR is not set, then the \fI/etc/passwd\fR file is consulted.
+under the user's home directory, and has the default name of
+\fI``Mail''\fP.
+.B Install\-mh
+writes an initial
+.I \&.mh\(ruprofile
+for the user.
+.PP
+As with all
+.B nmh
+commands,
+.B install\-mh
+first checks for the existence of the \fB$MH\fP environment variable
+since that gives the profile path if set.
+If it isn't set, the
+.B $HOME
+environment variable is consulted to determine the user's home directory.
+If
+.B $HOME
+is not set, then the
+.I /etc/passwd
+file is consulted.
+.PP
+When creating the users initial
+.IR \&.mh\(ruprofile ,
+.B install\-mh
+will check for the existence of a global profile
+.IR %etcdir%/mh.profile .
+If found, this will be used to initialize the new
+.IR \&.mh\(ruprofile .
+.PP
+The \fB\-check\fP option can be used to check whether or not nmh has
+been installed.
+This can be used by other programs to determine whether or not nmh has
+been installed without their having to know the internals of nmh.
 
-When creating the users initial \&.mh\(ruprofile, \fIinstall\-mh\fR will
-check for the existence of a global profile %etcdir%/mh.profile.  If
-found, this will be used to initialize the new \&.mh\(ruprofile.
-.Fi
+.SH FILES
+.fc ^ ~
+.nf
+.ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^%etcdir%/mh.profile~^Used to initialize user profile
-.Pr
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName  'u
 ^Path:~^To set the user's nmh directory
-.Co
-With `\-auto', the current folder is changed to \*(lqinbox\*(rq.
-.En
+.fi
+
+.SH CONTEXT
+With
+.BR \-auto ,
+the current folder is changed to
+.RI \*(lq inbox \*(rq.