X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/34b792b0953b6104cc21eb88c2e34f3cc53f71b6..7f71991d47a863a1cb3f66a1d5df87f3bacb7828:/man/mh-profile.man

diff --git a/man/mh-profile.man b/man/mh-profile.man
index f34ac4ba..cdd78128 100644
--- a/man/mh-profile.man
+++ b/man/mh-profile.man
@@ -1,4 +1,4 @@
-.TH MH-PROFILE %manext5% "April 18, 2014" "%nmhversion%"
+.TH MH-PROFILE %manext5% "December 21, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -44,6 +44,15 @@ context, and indicates what the default value is.  Note that a profile
 component can only appear once.  Multiple appearances with trigger a
 warning that all appearances after the first are ignored.
 .PP
+Some MH programs, including
+.BR mhbuild ,
+.BR mhshow ,
+and
+.BR mhstore ,
+have specific profile components that are described in their respective
+man pages.  Each component name begins with the name of the program and
+is followed by a dash.
+.PP
 .BR Path :
 Mail
 .RS 5
@@ -545,7 +554,7 @@ It is used to retrieve an external-body with access-type `mail-server'
 .RE
 .PP
 .BR mhlproc :
-%libdir%/mhl
+%nmhlibexecdir%/mhl
 .RS 5
 This is the program used to filter messages in various ways.  It
 is used by
@@ -597,7 +606,7 @@ Currently not used.
 .RE
 .PP
 .BR postproc :
-%libdir%/post
+%nmhlibexecdir%/post
 .RS 5
 This is the program used by
 .BR send ,
@@ -645,7 +654,7 @@ to process and display non-text (MIME) messages.
 .RE
 .PP
 .BR showproc :
-%libdir%/mhl
+%nmhlibexecdir%/mhl
 .RS 5
 This is the program used by
 .B show
@@ -672,26 +681,17 @@ This is the program used by
 to determine to whom a message would be sent.
 .RE
 .SS "Profile Lookup"
-Some
-.B nmh
-programs will look in more than just the user's 
-.I \&.mh\(ruprofile
-for profile entries.  In particular, 
-.BR mhbuild ,
-.BR mhshow ,
-.BR mhstore ,
-and
-.BR mhn 
-will also all look in a file specified by a program-specific
-environment variable (see below), and after that in 
-the system-installed profile (%etcdir%/mhn.defaults).  (The
-.B mhfixmsg
-program is similar, but doesn't consult an environment variable.)
-The first match found for a particular component will be used,
-allowing user-supplied entries to override those that are system-supplied.
-A profile component with a blank value field will "hide" any later
-occurrences of the component, and will make the entry appear to be
-absent.
+After consulting .mh_profile,
+some programs read an optional profile specified by a
+program-specific environment variable,
+and then the system-wide profile %nmhetcdir%/mhn.defaults.
+These programs are mhbuild, mhshow, mhstore, and mhn.
+mhfixmsg is similar, but has no optional profile.
+
+The first occurrence of a component is used,
+e.g.\& .mh_profile's trumps $MHSHOW's.
+A component with no value still stops further occurrences being used,
+but is considered absent.
 .SS "Environment Variables"
 The operation of
 .B nmh
@@ -764,7 +764,7 @@ additional user profile (file) to be read by
 .BR mhn ,
 in addition to the mhn.defaults profile.
 .B mhn
-is deprecated, so this support for this variable will
+is deprecated, so support for this variable will
 be removed from a future nmh release.
 .RE
 .PP
@@ -887,6 +887,13 @@ will emit debugging information.
 If this variable is set to a non-null value,
 .B pick
 will emit a representation of the search pattern.
+.B $MHPDEBUG
+is deprecated, so support for this variable will
+be removed from a future nmh release.  Instead,
+.B pick
+now supports a
+.B \-debug
+switch.
 .RE
 .PP
 .B $MHWDEBUG
@@ -1037,7 +1044,7 @@ if annotations are to occur.
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^or $MH~^Rather than the standard profile
 ^<mh\-dir>/context~^The user context
@@ -1047,6 +1054,9 @@ if annotations are to occur.
 .SH "SEE ALSO"
 .IR environ (5),
 .IR mh-sequence (5),
+.IR mhbuild (1),
+.IR mhshow (1),
+.IR mhstore (1),
 .IR nmh (7)
 .SH HISTORY
 The