update man pages for new mhshow message separator header

[nmh] / man / mh-profile.man

diff --git a/man/mh-profile.man b/man/mh-profile.man
index f34ac4ba8e497829e4800256cc0ee746c93c146f..cdd7812837af4b48d5659a4d89a238d689ae8427 100644 (file)
--- 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%
 .\"
 .\"
 .\" %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
 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
 .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 :
 .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
 .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 :
 .RE
 .PP
 .BR postproc :

-%libdir%/post
+%nmhlibexecdir%/post

 .RS 5
 This is the program used by
 .BR send ,
 .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 :
 .RE
 .PP
 .BR showproc :

-%libdir%/mhl
+%nmhlibexecdir%/mhl

 .RS 5
 This is the program used by
 .B show
 .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"
 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
 .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
 .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
 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.
 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
 .RE
 .PP
 .B $MHWDEBUG


@@ -1037,7 +1044,7 @@ if annotations are to occur.
 .SH FILES
 .fc ^ ~
 .nf
 .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
 ^$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),
 .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
 .IR nmh (7)
 .SH HISTORY
 The