NAME

       install-mh - initialize the nmh environment

SYNOPSIS

       /usr/lib/mh/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 /etc/nmh/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's profile.
       /etc/nmh/mh.profile Used to initialize user's profile.

PROFILE COMPONENTS

       Path:               To set the user's nmh directory.

CONTEXT

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

UNDOING THE INSTALLATION

       If  you  only  ran  install-mh  to  try  out  nmh  briefly,  you  might like to remove the
       configuration files it creates. (This is not obligatory -- install-mh creates only  a  few
       small files so simply leaving them in place will not cause problems.)

       Most  nmh  configuration  information lives in the user's nmh directory; you can print its
       name by running

       mhpath +

       Basically all plain files in the nmh directory are configuration files and can be removed.

       Attention: The nmh directory  holds  not  just  configuration  files!  Its  subdirectories
       contain  all  the  emails  you  have  written  or received with nmh.  Don't delete the nmh
       directory without carefully checking that there are no mail  files  that  you  might  want
       later!

       The only configuration file that lives outside the nmh directory is your profile file. You
       can print its name by running

       echo ${MH:-$HOME/.mh-profile}

       If you aren't using nmh any more you can delete this file, too.