Generalized condition for support of parameter value tests.

[nmh] / man / mhparam.man

diff --git a/man/mhparam.man b/man/mhparam.man
index bf7c40a3ffde8b1fc2c1a125c7f3088731d37d08..07da4ccd31d0f7f0276663f5d2d2c9b6e1650676 100644 (file)
--- a/man/mhparam.man
+++ b/man/mhparam.man
@@ -1,4 +1,4 @@
-.TH MHPARAM %manext1% "February 26, 2014" "%nmhversion%"
+.TH MHPARAM %manext1% "May 21, 2016" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -8,11 +8,11 @@ mhparam \- print nmh profile and context components
 .HP 5
 .na
 .B mhparam
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ components ]
 .RB [ \-all ]
 .RB [ \-component " | " \-nocomponent ]
-.RB [ \-version ]
-.RB [ \-help ]
 .RB [ \-debug ]
 .ad
 .SH DESCRIPTION
@@ -44,21 +44,51 @@ If
 is specified, then all components in the nmh profile are
 displayed and other arguments are ignored.
 .PP
-.BR mhparam
-can provide other information, such as
-the locations of the nmh
-.I etcdir
+.B mhparam
+can provide other information, such as the
+.B nmh
+version identifier, the locations of the nmh
+.IR bindir ,
+.IR libexecdir ,
+.IR etcdir ,
 and
-.I libdir
+.I docdir
 install directories, all
 .I proc
-settings, and the default locking method with which the
+settings, and the
+.I datalocking
+method described in the
+.IR mh\-profile (5)
+man page.  Information about the configuration of the
 .B nmh
-installation was configured.  The
+installation is also available, including the default mail spool
+locking method.  To test whether the configuration includes
+support for SASL, TLS,
+.IR iconv (3),
+and oauth, the following commands, respectively, will output a non-null
+string to indicate support:
+.PP
+.RS 5
+.nf
+mhparam\0sasl
+mhparam\0tls
+mhparam\0iconv
+mhparam\0oauth
+.fi
+.RE
+.PP
+Conversely, no output means that the specified support is not included.
+The
 .B \-debug
 switch displays all such other information available from
 .BR mhparam .
 .PP
+Note that the internal
+.B libdir
+component has been replaced by
+.BR libexecdir .
+The old form is deprecated and will be removed in a future release.
+.PP
 Examples:
 .PP
 .RS 5
@@ -68,7 +98,7 @@ Examples:
 Mail
 
 % mhparam mhlproc
-%libdir%/mhl
+%nmhlibexecdir%/mhl
 
 % mhparam \-component Path
 Path: Mail
@@ -85,17 +115,32 @@ rmmproc
 Path: Mail
 context: context
 
+% mhparam version
+%nmhversion%
+
 % mhparam etcdir
-%etcdir%
+%nmhetcdir%
 
-% mhparam libdir
-%libdir%
+% mhparam libexecdir
+%nmhlibexecdir%
+
+% mhparam spoollocking
+%default_locking%
 
 % mhparam datalocking
 fcntl
 
-% mhparam spoollocking
-flock
+% mhparam sasl
+cyrus_sasl
+
+% mhparam tls
+tls
+
+% mhparam iconv
+iconv
+
+% mhparam oauth
+oauth
 .fi
 .RE
 .PP
@@ -112,7 +157,7 @@ returns the number of components that were not found.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'ExtraBigProfileName  'u
 ^$HOME/.mh_profile~^The user profile
 ^or $MH~^Rather than the standard profile
 ^<mh-dir>/context~^The user context