Added mhfixmsg to nmh man page.

[nmh] / man / mhstore.man

diff --git a/man/mhstore.man b/man/mhstore.man
index 7e6f850651460577b33b368f5f12f10b4edf5124..6fb6008bd7c825af8cc3143dfd4d60a65cc14e92 100644 (file)
--- a/man/mhstore.man
+++ b/man/mhstore.man
@@ -1,4 +1,4 @@
-.TH MHSTORE %manext1% "March 21, 2013" "%nmhversion%"
+.TH MHSTORE %manext1% "March 2, 2014" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
@@ -28,6 +28,7 @@ mhstore \- store contents of MIME messages into files
 .RB [ \-wcache
 .IR policy ]
 .RB [ \-check " | " \-nocheck ]
+.RB [ \-verbose " | " \-noverbose ]
 .RB [ \-version ]
 .RB [ \-help ]
 .ad
@@ -169,12 +170,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 '%'.  For the sake of security, this switch is not the
-default, and it is recommended that you do NOT put the
-.B \-auto
-switch in your
-.I \&.mh\(ruprofile
-file.
+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
@@ -210,15 +210,17 @@ folder.
 If the formatting string consists solely of a \*(lq-\*(rq character,
 then the content is sent to the standard output.
 .PP
-If the formatting string starts with a '|', then the display string
-will represent a command for
+If the formatting string starts with a '|', then it represents
+a command for
 .B mhstore
 to execute which should
 ultimately store the content.  The content will be passed to the
 standard input of the command.  Before the command is executed,
 .B mhstore
 will change to the appropriate directory, and any
-escapes (given below) in the display string will be expanded.
+escapes (given below) in the formatting string will be expanded.
+The use of the \*(lq%a\*(rq sequence is not recommended because
+the user has no control over the Content-Type parameter data.
 .PP
 Otherwise the formatting string will represent a pathname in which
 to store the content.  If the formatting string starts with a '/',
@@ -236,7 +238,7 @@ listed above) content, the p-escapes are ignored.
 .RS 5
 .nf
 .ta \w'%P  'u
-%a     Parameters from Content-type  (only valid with command)
+%a     Parameters from Content-Type  (only valid with command)
 %m     Insert message number
 %P     Insert part number with leading dot
 %p     Insert part number without leading dot
@@ -275,6 +277,15 @@ mhstore-store-application/PostScript: %m%P.ps
 .fi
 .RE
 .PP
+The
+.B \-verbose
+switch directs
+.B mhstore
+to print out the names of files that it stores.  For backward
+compatibility, it is the default.  The
+.B \-noverbose
+switch suppresses these printouts.
+.PP
 .SS "Overwriting Existing Files"
 The
 .B \-clobber
@@ -495,7 +506,7 @@ nmh-private-cache: .cache
 .PP
 (which is the default value).
 .SS "User Environment"
-Because the display environment in which
+Because the environment in which
 .B mhstore
 operates may vary for
 different machines,
@@ -563,6 +574,7 @@ is checked.
 .RB ` \-nocheck '
 .RB ` \-rcache\ ask '
 .RB ` \-wcache\ ask '
+.RB ` \-verbose '
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last
 message selected will become the current message.