Added BUGS section to mh-tailor man file to note that failure to open

[nmh] / man / mhparam.man

diff --git a/man/mhparam.man b/man/mhparam.man
index 00f38ac0b0941f48100e6d31462d2acc22267dff..93d9c902e465d3931f270def66c25c91c8974fa6 100644 (file)
--- a/man/mhparam.man
+++ b/man/mhparam.man
@@ -1,11 +1,11 @@
 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .TH MHPARAM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 .\"
 .TH MHPARAM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME

-mhparam \- print nmh profile components
+mhparam \- print nmh profile and context components

 .SH SYNOPSIS
 .SH SYNOPSIS

+.HP 5

 .na
 .B mhparam
 .RI [ components ]
 .na
 .B mhparam
 .RI [ components ]


@@ -15,7 +15,7 @@ mhparam \- print nmh profile components
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION

-.B Mhparam
+.B mhparam

 writes the value of the specified profile component to the
 standard output separated by newlines.  If the profile component is not
 present, the default value (or nothing if there is no default) is printed.
 writes the value of the specified profile component to the
 standard output separated by newlines.  If the profile component is not
 present, the default value (or nothing if there is no default) is printed.


@@ -53,7 +53,7 @@ Mail
 % mhparam mhlproc
 %libdir%/mhl
 
 % mhparam mhlproc
 %libdir%/mhl
 

-% mhparam \-component path
+% mhparam \-component Path

 Path: Mail
 
 % mhparam AliasFile rmmproc
 Path: Mail
 
 % mhparam AliasFile rmmproc


@@ -63,24 +63,41 @@ rmmproc: rmmproc
 % mhparam \-nocomponent AliasFile rmmproc
 aliases
 rmmproc
 % mhparam \-nocomponent AliasFile rmmproc
 aliases
 rmmproc

+
+% mhparam path nonexistent context
+Path: Mail
+context: context

 .fi
 .RE
 .PP
 .fi
 .RE
 .PP

-.B Mhparam
+.B mhparam

 is also useful in back\-quoted operations:
 .PP
 .RS 5
 .nf
 % fgrep cornell.edu `mhpath +`/`mhparam aliasfile`
 .fi
 is also useful in back\-quoted operations:
 .PP
 .RS 5
 .nf
 % fgrep cornell.edu `mhpath +`/`mhparam aliasfile`
 .fi

-.RE
-.PP
+
+.SH "EXIT STATUS"
+.B mhparam
+returns the number of components that were not found.

 
 .SH FILES
 .fc ^ ~
 .nf
 
 .SH FILES
 .fc ^ ~
 .nf

-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+.ta \w'%etcdir%/ExtraBigFileName  'u
+^$HOME/.mh_profile~^The user profile
+^or $MH~^Rather than the standard profile
+^<mh-dir>/context~^The user context
+^or $MHCONTEXT~^Rather than the standard context
+.fi
+
+.SH "PROFILE COMPONENTS"
+.fc ^ ~
+.nf
+.ta 2.4i
+.ta \w'ExtraBigProfileName  'u
+^context:~^To determine the context file

 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"