diplodocus.org Git - nmh/blob - man/mhparam.man

   1 .TH MHPARAM %manext1% "November 6, 2012" "%nmhversion%"
   2 .\"
   3 .\" %nmhwarning%
   4 .\"
   5 .SH NAME
   6 mhparam \- print nmh profile and context components
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B mhparam
  11 .RI [ components ]
  12 .RB [ \-all ]
  13 .RB [ \-component " | " \-nocomponent ]
  14 .RB [ \-version ]
  15 .RB [ \-help ]
  16 .RB [ \-debug ]
  17 .ad
  18 .SH DESCRIPTION
  19 .B mhparam
  20 writes the value of the specified profile component to the standard
  21 output separated by newlines.  Component name matching is
  22 case-insensitive.  If the profile component is not present, the
  23 default value (or nothing if there is no default) is printed.
  24 .PP
  25 If the switch
  26 .B \-component
  27 is given, then the component name is displayed
  28 along with the profile components value.  This can be disabled with the
  29 switch
  30 .BR \-nocomponent .
  31 .PP
  32 If more than one component is specified in the
  33 .I components
  34 list, then
  35 the switch
  36 .B \-component
  37 is on by default.  If only one component is
  38 specified, then the switch
  39 .B \-nocomponent
  40 is on by default.
  41 .PP
  42 If
  43 .B \-all
  44 is specified, then all components in the nmh profile are
  45 displayed and other arguments are ignored.
  46 .PP
  47 .BR mhparam
  48 can provide other information, such as
  49 the locations of the nmh
  50 .I etcdir
  51 and
  52 .I libdir
  53 install directories, all
  54 .I proc
  55 settings, and the locking method with which the
  56 .B nmh
  57 installation was configured.  The
  58 .B \-debug
  59 switch displays all such other information available from
  60 .BR mhparam .
  61 .PP
  62 Examples:
  63 .PP
  64 .RS 5
  65 .nf
  66 .ta \w'AliasFile:'u+2n
  67 % mhparam path
  68 Mail
  69
  70 % mhparam mhlproc
  71 %libdir%/mhl
  72
  73 % mhparam \-component Path
  74 Path: Mail
  75
  76 % mhparam AliasFile rmmproc
  77 AliasFile: aliases
  78 rmmproc: rmmproc
  79
  80 % mhparam \-nocomponent AliasFile rmmproc
  81 aliases
  82 rmmproc
  83
  84 % mhparam path nonexistent context
  85 Path: Mail
  86 context: context
  87
  88 % mhparam etcdir
  89 %etcdir%
  90
  91 % mhparam libdir
  92 %libdir%
  93
  94 % mhparam lockmethod
  95 fcntl
  96 .fi
  97 .RE
  98 .PP
  99 .B mhparam
 100 is also useful in backquoted operations:
 101 .PP
 102 .RS 5
 103 .nf
 104 % fgrep cornell.edu `mhpath +`/`mhparam aliasfile`
 105 .fi
 106 .SH "EXIT STATUS"
 107 .B mhparam
 108 returns the number of components that were not found.
 109 .SH FILES
 110 .fc ^ ~
 111 .nf
 112 .ta \w'%etcdir%/ExtraBigFileName  'u
 113 ^$HOME/.mh_profile~^The user profile
 114 ^or $MH~^Rather than the standard profile
 115 ^<mh-dir>/context~^The user context
 116 ^or $MHCONTEXT~^Rather than the standard context
 117 .fi
 118 .SH "PROFILE COMPONENTS"
 119 .fc ^ ~
 120 .nf
 121 .ta 2.4i
 122 .ta \w'ExtraBigProfileName  'u
 123 ^context:~^To determine the context file
 124 .fi
 125 .SH "SEE ALSO"
 126 .IR mh-profile (5)
 127 .SH DEFAULTS
 128 .nf
 129 .RB ` \-nocomponent "' if only one component is specified"
 130 .RB ` \-component "' if more than one component is specified"
 131 .RB ` components "' defaults to none"
 132 .fi
 133 .SH CONTEXT
 134 None