b1903518494e72c96995ca76a9e191f0bf95ef46
[mmh] / man / mhparam.man
1 .\"
2 .\" %nmhwarning%
3 .\" $Id$
4 .\"
5 .TH MHPARAM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 .SH NAME
7 mhparam \- print nmh profile components
8 .SH SYNOPSIS
9 .na
10 .B mhparam
11 .RI [ components ]
12 .RB [ \-all ]
13 .RB [ \-component " | " \-nocomponent ]
14 .RB [ \-version ]
15 .RB [ \-help ]
16 .ad
17 .SH DESCRIPTION
18 .B Mhparam
19 writes the value of the specified profile component to the
20 standard output separated by newlines.  If the profile component is not
21 present, the default value (or nothing if there is no default) is printed.
22 .PP
23 If the switch
24 .B \-component
25 is given, then the component name is displayed
26 along with the profile components value.  This can be disabled with the
27 switch
28 .BR \-nocomponent .
29 .PP
30 If more than one component is specified in the
31 .I components
32 list, then
33 the switch
34 .B \-component
35 is on by default.  If only one component is
36 specified, then the switch
37 .B \-nocomponent
38 is on by default.
39 .PP
40 If
41 .B \-all
42 is specified, then all components in the nmh profile are
43 displayed and other arguments are ignored.
44 .PP
45 Examples:
46 .PP
47 .RS 5
48 .nf
49 .ta \w'AliasFile:'u+2n
50 % mhparam path
51 Mail
52
53 % mhparam mhlproc
54 %libdir%/mhl
55
56 % mhparam \-component path
57 Path: Mail
58
59 % mhparam AliasFile rmmproc
60 AliasFile: aliases
61 rmmproc: rmmproc
62
63 % mhparam \-nocomponent AliasFile rmmproc
64 aliases
65 rmmproc
66 .fi
67 .RE
68 .PP
69 .B Mhparam
70 is also useful in back\-quoted operations:
71 .PP
72 .RS 5
73 .nf
74 % fgrep cornell.edu `mhpath +`/`mhparam aliasfile`
75 .fi
76 .RE
77 .PP
78
79 .SH FILES
80 .fc ^ ~
81 .nf
82 .ta \w'%etcdir%/ExtraBigFileName  'u
83 ^$HOME/\&.mh\(ruprofile~^The user profile
84 .fi
85
86 .SH "SEE ALSO"
87 mh-profile(5)
88
89 .SH DEFAULTS
90 .nf
91 .RB ` \-nocomponent "' if only one component is specified"
92 .RB ` \-component "' if more than one component is specified"
93 .RB ` components "' defaults to none"
94 .fi
95
96 .SH CONTEXT
97 None