<commit_before>.TH MHPARAM %manext1% "May 21, 2016" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.SH NAME
mhparam \- print nmh profile and context components
.SH SYNOPSIS
.HP 5
.na
.B mhparam
.RI [ components ]
.RB [ \-all ]
.RB [ \-component " | " \-nocomponent ]
.RB [ \-version ]
.RB [ \-help ]
.RB [ \-debug ]
.ad
.SH DESCRIPTION
.B mhparam
writes the value of the specified profile component to the standard
output separated by newlines.  Component name matching is
case-insensitive.  If the profile component is not present, the
default value (or nothing if there is no default) is printed.
.PP
If the switch
.B \-component
is given, then the component name is displayed
along with the profile components value.  This can be disabled with the
switch
.BR \-nocomponent .
.PP
If more than one component is specified in the
.I components
list, then
the switch
.B \-component
is on by default.  If only one component is
specified, then the switch
.B \-nocomponent
is on by default.
.PP
If
.B \-all
is specified, then all components in the nmh profile are
displayed and other arguments are ignored.
.PP
.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 docdir
install directories, all
.I proc
settings, and the
.I datalocking
method described in the
.IR mh\-profile (5)
man page.  Information about the configuration of the
.B nmh
installation is also available, including the default mail spool
locking method.  To test whether the configuration includes
support for SASL, TLS, and
.IR iconv (3),
the following commands, respectively, will output a non-null string to
indicate support:
.PP
.RS 5
.nf
mhparam\0sasl
mhparam\0tls
mhparam\0iconv
.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
.nf
.ta \w'AliasFile:'u+2n
% mhparam path
Mail

% mhparam mhlproc
%nmhlibexecdir%/mhl

% mhparam \-component Path
Path: Mail

% mhparam AliasFile rmmproc
AliasFile: aliases
rmmproc: rmmproc

% mhparam \-nocomponent AliasFile rmmproc
aliases
rmmproc

% mhparam path nonexistent context
Path: Mail
context: context

% mhparam version
%nmhversion%

% mhparam etcdir
%nmhetcdir%

% mhparam libexecdir
%nmhlibexecdir%

% mhparam spoollocking
%default_locking%

% mhparam datalocking
fcntl

% mhparam sasl
cyrus_sasl

% mhparam tls
tls

% mhparam iconv
iconv
.fi
.RE
.PP
.B mhparam
is also useful in backquoted operations:<commit_msg>Added oauth to mhparam examples.<commit_after>.TH MHPARAM %manext1% "May 21, 2016" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
.SH NAME
mhparam \- print nmh profile and context components
.SH SYNOPSIS
.HP 5
.na
.B mhparam
.RI [ components ]
.RB [ \-all ]
.RB [ \-component " | " \-nocomponent ]
.RB [ \-version ]
.RB [ \-help ]
.RB [ \-debug ]
.ad
.SH DESCRIPTION
.B mhparam
writes the value of the specified profile component to the standard
output separated by newlines.  Component name matching is
case-insensitive.  If the profile component is not present, the
default value (or nothing if there is no default) is printed.
.PP
If the switch
.B \-component
is given, then the component name is displayed
along with the profile components value.  This can be disabled with the
switch
.BR \-nocomponent .
.PP
If more than one component is specified in the
.I components
list, then
the switch
.B \-component
is on by default.  If only one component is
specified, then the switch
.B \-nocomponent
is on by default.
.PP
If
.B \-all
is specified, then all components in the nmh profile are
displayed and other arguments are ignored.
.PP
.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 docdir
install directories, all
.I proc
settings, and the
.I datalocking
method described in the
.IR mh\-profile (5)
man page.  Information about the configuration of the
.B nmh
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
.nf
.ta \w'AliasFile:'u+2n
% mhparam path
Mail

% mhparam mhlproc
%nmhlibexecdir%/mhl

% mhparam \-component Path
Path: Mail

% mhparam AliasFile rmmproc
AliasFile: aliases
rmmproc: rmmproc

% mhparam \-nocomponent AliasFile rmmproc
aliases
rmmproc

% mhparam path nonexistent context
Path: Mail
context: context

% mhparam version
%nmhversion%

% mhparam etcdir
%nmhetcdir%

% mhparam libexecdir
%nmhlibexecdir%

% mhparam spoollocking
%default_locking%

% mhparam datalocking
fcntl

% mhparam sasl
cyrus_sasl

% mhparam tls
tls

% mhparam iconv
iconv

% mhparam oauth
oauth
.fi
.RE
.PP
.B mhparam
is also useful in backquoted operations:
{'fraction_non_alphanumeric': 0.07628042135851798, 'fraction_numerical': 0.00599346167816927, 'mean_word_length': 3.7970383275261326, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2044957', 'n_tokens_mistral': 1927, 'n_tokens_neox': 1827, 'n_words': 798}