X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/8e0f9bd3daae9d05dec58026d5a5924367e4e874..b0aa8cdb1c264e42d4931ca24968689c73381278:/man/mh-profile.man diff --git a/man/mh-profile.man b/man/mh-profile.man index 8cb85260..0bf8cc84 100644 --- a/man/mh-profile.man +++ b/man/mh-profile.man @@ -1,4 +1,4 @@ -.TH MH-PROFILE %manext5% "December 21, 2014" "%nmhversion%" +.TH MH-PROFILE %manext5% "October 19, 2016" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -62,6 +62,21 @@ transactions in directory \*(lqMail\*(rq. This is the only mandatory profile entry. (profile, no default) .RE .PP +.BR locale : +locale +.RS 5 +Set the locale for all +.B nmh +programs except +.BR post , +.BR install-mh , +and +.BR slocal . +See the LC_ALL, LC_CTYPE, and LANG variables in the "ENVIRONMENT" +section below for a reference on how the locale is set if this profile +component is not used. +.RE +.PP .BR context : context .RS 5 @@ -100,7 +115,7 @@ no such sequences are defined. Otherwise, for each name given, the sequence is first zero'd and then each message is added to the sequence. Read the .IR mh\-sequence (5) -man page for the details about this sequence. (profile, no default) +man page for the details about this sequence. (profile, no default) .RE .PP .BR Sequence\-Negation : @@ -316,7 +331,7 @@ and .BR repl . Read the .IR mh\-draft (5) -man page for details. (profile, no default) +man page for details. (profile, no default) .RE .PP .BI digest\-issue\- list : @@ -377,8 +392,10 @@ supersedes all of this. (profile, no default) .RS 5 Indicates how the username and password credentials will be retrieved for access to external servers, such as those that provide SMTP or POP -service. The supported entry values are \*(lqlegacy\*(rq and -.RI \*(lqfile: netrc \*(rq. +service. The supported entry values are \*(lqlegacy\*(rq, +.RI \*(lqfile: netrc \*(rq, +and +.RI \*(lqfile\-nopermcheck: netrc \*(rq. With \*(lqlegacy\*(rq, or if there is no credentials entry, the username is the first of: .RS 5 @@ -466,8 +483,44 @@ with your own account information: This .I netrc file must be owned and readable only by you. +.PP +The +.RI \*(lqfile\-nopermcheck: netrc \*(rq +.B credentials +entry is identical in behavior to the \*(lqfile\*(rq entry, with the +exception that the permission checks done by +\*(lqfile\*(rq are not performed. This entry should be used with +caution and only when absolutely necessary. (profile, default: legacy) .RE +.PP +.BR Welcome : +disable +.RS 5 +If the Welcome component is not present, or its value is not +.RI \*(lq disable \*(rq, +a welcome message will be displayed the first time that an interactive +.B nmh +program is run after updating the +.B nmh +installation. +The user must press the Enter key to continue. +.PP +If the MHCONTEXT environment variable is set and non-empty (and +the Welcome component is not +.RI \*(lq disable \*(rq), +the welcome message is only displayed if the context file contains a version +reference, and that reference is older than the installed +.B nmh +version. The version reference is of the form: +.PP +.RS 5 +.nf +Version: %nmhversion% +.fi +.RE +.PP +.RE .SS "Process Profile Entries" The following profile elements are used whenever an .B nmh @@ -757,15 +810,19 @@ program as the .IR whatnowproc , including one of the standard shells. As a result, it's not possible to pass -information via an argument list. The convention is that environment +information via an argument list. The convention is that environment variables whose names are all upper-case are user-settable; those whose names are lower-case only are used internally by nmh and should not generally be set by the user. .TP +LC_ALL, LC_CTYPE, and LANG +These variables are used to set the locale, see locale(1). +The \*(lqlocale\*(rq profile entry supersedes these. +.TP MAILDROP This variable tells .B inc -the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry. +the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry. .TP MAILHOST This variable tells @@ -882,7 +939,7 @@ This variable tells .B send and .B post -your mail signature. This supersedes the \*(lqSignature\*(rq profile entry, +your mail signature. This supersedes the \*(lqSignature\*(rq profile entry, and is not used when the \*(lqLocal\-Mailbox\*(rq profile component is set. .TP USER