.TH INSTALL-MH 8mh 2002-11-18 "nmh-1.7.1" . .\" THIS FILE HAS BEEN AUTOMATICALLY GENERATED. DO NOT EDIT. . .SH NAME install-mh \- initialize the nmh environment .SH SYNOPSIS .HP 5 .na .B /usr/lib/mh/install\-mh .RB [ \-help ] .RB [ \-version ] .RB [ \-auto ] .RB [ \-check ] .ad .SH DESCRIPTION .B install\-mh creates the initial setup for a first-time .B nmh user. .B install\-mh is installed in two locations for historical reasons. .PP The \fB\-auto\fP switch does things as automatically as possible and makes \fBinstall\-mh\fP less chatty. .PP The user is prompted for the name of the directory to be designated as the user's .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 \fI`Mail'\fP. .B install\-mh writes an initial .I \&.mh_profile 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, if set, gives the profile path. 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 user's .IR \&.mh_profile , .B install\-mh will check for the existence of a global profile at .IR /etc/nmh/mh.profile . If found, this will be used to initialize the new .IR \&.mh_profile . .PP The \fB\-check\fP switch checks if .B nmh is installed. (This can be used by other programs to determine if .B nmh has been installed.) .SH FILES .PD 0 .TP 20 $HOME/.mh_profile The user's profile. .TP /etc/nmh/mh.profile Used to initialize user's profile. .PD .SH "PROFILE COMPONENTS" .TP 20 Path: To set the user's nmh directory. .SH CONTEXT With .BR \-auto , the current folder is changed to .RI \*(lq inbox \*(rq. .SH "UNDOING THE INSTALLATION" If you only ran install-mh to try out .B nmh briefly, you might like to remove the configuration files it creates. (This is not obligatory -- .B install-mh creates only a few small files so simply leaving them in place will not cause problems.) Most .B nmh configuration information lives in the user's .B nmh directory; you can print its name by running .B mhpath + Basically all plain files in the .B nmh directory are configuration files and can be removed. .I Attention: The .B nmh directory holds not just configuration files! Its subdirectories contain all the emails you have written or received with .B nmh. Don't delete the .B nmh directory without carefully checking that there are no mail files that you might want later! The only configuration file that lives outside the .B nmh directory is your profile file. You can print its name by running .B echo "${MH:-$HOME/.mh-profile}" If you aren't using nmh any more you can delete this file, too.