]> diplodocus.org Git - nmh/blobdiff - man/mhstore.man
Always initialize those two variables made static in commit
[nmh] / man / mhstore.man
index 984b14280825797e36999ecc2226ac6c3417095e..fbdd37023cd6f13436cdf34132ba6294b536a995 100644 (file)
@@ -1,4 +1,4 @@
-.TH MHSTORE %manext1% "March 1, 2014" "%nmhversion%"
+.TH MHSTORE %manext1% "March 2, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"
@@ -141,7 +141,6 @@ as a Content-MD5 header field), then
 will attempt to
 verify the integrity of the content.
 .SS "Storing the Contents"
 will attempt to
 verify the integrity of the content.
 .SS "Storing the Contents"
-The
 .B mhstore
 will store the contents of the named messages in
 \*(lqnative\*(rq (decoded) format.  Two things must be determined:
 .B mhstore
 will store the contents of the named messages in
 \*(lqnative\*(rq (decoded) format.  Two things must be determined:
@@ -170,7 +169,11 @@ specified as the \*(lqfilename\*(rq attribute in the
 attribute in the \*(lqContent-Type\*(rq header for the content you are
 storing.  For security reasons, this filename will be ignored if it
 begins with the character '/', '.', '|', or '!', or if it contains the
 attribute in the \*(lqContent-Type\*(rq header for the content you are
 storing.  For security reasons, this filename will be ignored if it
 begins with the character '/', '.', '|', or '!', or if it contains the
-character '%'.
+character '%'.  We also recommend using a \*(lqnmh-storage\*(rq profile
+entry or a
+.B \-clobber
+switch setting other than the default of \*(lqalways\*(rq to avoid
+overwriting existing files.
 .PP
 If the
 .B \-auto
 .PP
 If the
 .B \-auto
@@ -442,7 +445,7 @@ For the \*(lqurl\*(rq access types,
 will look for the \*(lqnmh-access-url\*(rq profile entry, e.g.,
 .PP
 .RS 5
 will look for the \*(lqnmh-access-url\*(rq profile entry, e.g.,
 .PP
 .RS 5
-nmh-access-url: curl -l
+nmh-access-url: curl -L
 .RE
 .PP
 to determine the program to use to perform the HTTP retrieval.  This program
 .RE
 .PP
 to determine the program to use to perform the HTTP retrieval.  This program
@@ -515,16 +518,19 @@ particular machine, this environment variable should be set to
 refer to a file containing definitions useful for that machine.
 Finally,
 .B mhstore
 refer to a file containing definitions useful for that machine.
 Finally,
 .B mhstore
-will attempt to consult one other additional
-user profile, e.g.,
+will attempt to consult
 .PP
 .RS 5
 .PP
 .RS 5
-%etcdir%/mhn.defaults
+%nmhetcdir%/mhn.defaults
 .RE
 .PP
 which is created automatically during
 .B nmh
 installation.
 .RE
 .PP
 which is created automatically during
 .B nmh
 installation.
+.PP
+See "Profile Lookup" in
+.IR mh-profile (5)
+for the profile search order, and for how duplicate entries are treated.
 .SH FILES
 .B mhstore
 looks for additional profile files in multiple locations: absolute
 .SH FILES
 .B mhstore
 looks for additional profile files in multiple locations: absolute
@@ -532,15 +538,15 @@ 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
 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
+.RI \*(lq %nmhetcdir% \*(rq
 is checked.
 .PP
 .fc ^ ~
 .nf
 is checked.
 .PP
 .fc ^ ~
 .nf
-.ta \w'%etcdir%/ExtraBigFileName  'u
+.ta \w'%nmhetcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^$MHSTORE~^Additional profile entries
 ^$HOME/\&.mh\(ruprofile~^The user profile
 ^$MHSTORE~^Additional profile entries
-^%etcdir%/mhn.defaults~^System default MIME profile entries
+^%nmhetcdir%/mhn.defaults~^System default MIME profile entries
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .fi
 .SH "PROFILE COMPONENTS"
 .fc ^ ~