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 1b54e0f12a6771f965dd3295d7eaa47785da899a..4ef473e7b595a4cbda3d6f20ba1181eee47c894a 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 1e0c0c39f706524fa210cdfe0d542dd5f027de37..bf172f67c9a7c9f872fc88d193361794f79cad16 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 05ed1d320ffbd2dc2f84ef643ebb6122e4eaecf5..6510b12b545dcbdfa7a3680d856325737a9b37fc 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 bb80a28f3a440a33970cf3803569e466b51c71ad..cac4d9e70d678386321ecac852223243b5fdaf84 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 352bcfca5e62529b733dcea033ab4669055d497a..1cfccd328938eb6a51a176fd6094bef3067e11fa 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 9216bf66c2ba8a610d92716e271ec629165eb6f8..691abac60e773dac2f1c792493f863066ba8423b 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 04d89914277c935e9b2550bde70aef3d8d1b6656..f6065fb9760f79eff4beebfa6950c85e4c31f3a2 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