Went through the sources and checked where etcpath() is

used, and added/cloned an explanatory bit of text from the
fmttest man page to the files section for all affected
programs.

diff --git a/man/ali.man b/man/ali.man
index 1b54e0f..4ef473e 100644 (file)
--- a/man/ali.man
+++ b/man/ali.man
@@ -1,4 +1,4 @@
-.TH ALI %manext1% "January 1, 2001" "%nmhversion%"
+.TH ALI %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -59,6 +59,18 @@ switch will be read.  Each
 is processed as described in
 .IR mh\-alias (5).
 .SH FILES
+Alias files are looked up in multiple locations: if the pathname is
+absolute or starts with
+.RI \*(lq . \*(rq
+or
+.RI \*(lq .. \*(rq
+then it's accessed directly; otherwise tilde expansion is done on
+usernames, then files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .TP 20
 $HOME/.mh\-profile
 The user's profile.

diff --git a/man/forw.man b/man/forw.man
index 1e0c0c3..bf172f6 100644 (file)
--- a/man/forw.man
+++ b/man/forw.man
@@ -1,4 +1,4 @@
-.TH FORW %manext1% "February 28, 2012" "%nmhversion%"
+.TH FORW %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -395,6 +395,15 @@ section of the
 .B nmh
 User's Manual for more information on making digests.
 .SH FILES
+.B forw
+looks for format and filter files in multiple locations: absolute
+pathnames are accessed directly, tilde expansion is done on usernames,
+and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .PD 0
 .TP 25
 %etcdir%/forwcomps

diff --git a/man/mhbuild.man b/man/mhbuild.man
index 05ed1d3..6510b12 100644 (file)
--- a/man/mhbuild.man
+++ b/man/mhbuild.man
@@ -1,4 +1,4 @@
-.TH MHBUILD %manext1% "January 4, 2013" "%nmhversion%"
+.TH MHBUILD %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -654,6 +654,15 @@ line         ::=     "##" text EOL
 .fi
 .RE
 .SH FILES
+.B mhbuild
+looks for additional user profile files and mhn.defaults in multiple
+locations: absolute pathnames are accessed directly, tilde expansion
+is done on usernames, and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u

diff --git a/man/mhfixmsg.man b/man/mhfixmsg.man
index bb80a28..cac4d9e 100644 (file)
--- a/man/mhfixmsg.man
+++ b/man/mhfixmsg.man
@@ -1,4 +1,4 @@
-.TH MHFIXMSG %manext1% "March 18, 2013" "%nmhversion%"
+.TH MHFIXMSG %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -249,6 +249,15 @@ STORE = %libdir%/rcvstore
 .RE
 .PP
 .SH FILES
+.B mhfixmsg
+looks for mhn.defaults in multiple locations: absolute pathnames are
+accessed directly, tilde expansion is done on usernames, and files are
+searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/mhn.defaults  'u

diff --git a/man/mhshow.man b/man/mhshow.man
index 352bcfc..1cfccd3 100644 (file)
--- a/man/mhshow.man
+++ b/man/mhshow.man
@@ -1,4 +1,4 @@
-.TH MHSHOW %manext1% "April 30, 2012" "%nmhversion%"
+.TH MHSHOW %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -561,6 +561,15 @@ which is created automatically during
 .B nmh
 installation.
 .SH FILES
+.B mhshow
+looks for all format files and mhn.defaults in multiple locations:
+absolute pathnames are accessed directly, tilde expansion is done on
+usernames, and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u

diff --git a/man/mhstore.man b/man/mhstore.man
index 9216bf6..691abac 100644 (file)
--- a/man/mhstore.man
+++ b/man/mhstore.man
@@ -1,4 +1,4 @@
-.TH MHSTORE %manext1% "March 20, 2013" "%nmhversion%"
+.TH MHSTORE %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -514,6 +514,15 @@ which is created automatically during
 .B nmh
 installation.
 .SH FILES
+.B mhstore
+looks for additional profile files in multiple locations: absolute
+pathnames are accessed directly, tilde expansion is done on usernames,
+and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u

diff --git a/man/repl.man b/man/repl.man
index 04d8991..f6065fb 100644 (file)
--- a/man/repl.man
+++ b/man/repl.man
@@ -1,4 +1,4 @@
-.TH REPL %manext1% "July 1, 2012" "%nmhversion%"
+.TH REPL %manext1% "March 21, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -484,6 +484,15 @@ The same caveats apply to this option as to the
 .B \-build
 switch.
 .SH FILES
+.B repl
+looks for all format, filter and template files in multiple locations:
+absolute pathnames are accessed directly, tilde expansion is done on
+usernames, and files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %etcdir% \*(rq
+is checked.
+.PP
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u