X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/df02833a36f5525edb5b274fb67ca46aa4e5e6c5..64f5cda4610fa3de39a9d69aeda2d8a26f147f2e:/man/mhstore.man diff --git a/man/mhstore.man b/man/mhstore.man index 984b1428..fbdd3702 100644 --- a/man/mhstore.man +++ b/man/mhstore.man @@ -1,4 +1,4 @@ -.TH MHSTORE %manext1% "March 1, 2014" "%nmhversion%" +.TH MHSTORE %manext1% "March 2, 2014" "%nmhversion%" .\" .\" %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" -The .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 -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 @@ -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 -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 @@ -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 -will attempt to consult one other additional -user profile, e.g., +will attempt to consult .PP .RS 5 -%etcdir%/mhn.defaults +%nmhetcdir%/mhn.defaults .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 @@ -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 -.RI \*(lq %etcdir% \*(rq +.RI \*(lq %nmhetcdir% \*(rq 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 -^%etcdir%/mhn.defaults~^System default MIME profile entries +^%nmhetcdir%/mhn.defaults~^System default MIME profile entries .fi .SH "PROFILE COMPONENTS" .fc ^ ~