.TH MHSTORE %manext1% 2015-02-06 "%nmhversion%"
-.\"
+.
.\" %nmhwarning%
-.\"
+.
.SH NAME
mhstore \- store contents of nmh MIME messages into files
.SH SYNOPSIS
.RB [ \-prefer
.IR content ]
\&...
+.RB [ \-noprefer ]
.RB [ \-auto " | " \-noauto ]
.RB [ \-clobber
.IR always " | " auto " | " suffix " | " ask " | " never ]
file, or input from standard input, should be a validly formatted
message, just like any other
.B nmh
-message. It should NOT be in mail drop format (to convert a file in
+message. It should
+.I not
+be in mail drop format (to convert a file in
mail drop format to a folder of
.B nmh
messages, see
and
.B mhstore
to make common part-numbering possible across all three programs.
+The last of multiple
+.B \-prefer
+switches will have the highest priority. This allows the command line
+switches to override profile entries.
See
.IR mhlist (1)
and
.IR mhshow (1)
for more information on
-.BR \-prefer.
+.BR \-prefer .
+.PP
+The
+.B \-noprefer
+switch will cancel any previous
+.B \-prefer
+switches.
.SS "Checking the Contents"
The
.B \-check
to determine the program to use to perform the HTTP retrieval. This program
is invoked with one argument: the URL of the content to retrieve. The program
should write the content to standard out, and should terminate with a status
-of zero if the retrieval is successful and a non\-zero exit status otherwise.
+of zero if the retrieval is successful and a non-zero exit status otherwise.
.SS "The Content Cache"
When
.B mhstore
.fc ^ ~
.nf
.ta \w'%nmhetcdir%/ExtraBigFileName 'u
-^$HOME/\&.mh\(ruprofile~^The user profile
+^$HOME/.mh_profile~^The user profile
^$MHSTORE~^Additional profile entries
^%nmhetcdir%/mhn.defaults~^System default MIME profile entries
.fi