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