INSTALL-MH(%manext1%)

NAME
install-mh - initialize the nmh environment

SYNOPSIS

%libdir%/install-mh [-auto] [-check] [-version] [-help]

DESCRIPTION
Install-mh is the nmh program to create the initial setup for a first-time nmh user. Install-mh lives in two places for historical reasons.

The -auto option does things as automatically as possible and makes install-mh less chatty.

The user is asked for the name of the directory that will be designated as the user's 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''. Install-mh writes an initial .mh_profile for the user.

As with all nmh commands, install-mh first checks for the existence of the $MH environment variable since that gives the profile path if set. If it isn't set, the $HOME environment variable is consulted to determine the user's home directory. If $HOME is not set, then the /etc/passwd file is consulted.

When creating the users initial .mh_profile, install-mh will check for the existence of a global profile %etcdir%/mh.profile. If found, this will be used to initialize the new .mh_profile.

The -check 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.

FILES
^$HOME/.mh_profile~^The user profile
^%etcdir%/mh.profile~^Used to initialize user profile

PROFILE COMPONENTS
^Path:~^To set the user's nmh directory

CONTEXT
With -auto, the current folder is changed to “inbox”.