X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/125748e4eb5137dae49ed218cd728d988b1e4468..ec173fd2c:/man/mhshow.man?ds=inline

diff --git a/man/mhshow.man b/man/mhshow.man
index 3ad02bd4..4cbbd191 100644
--- a/man/mhshow.man
+++ b/man/mhshow.man
@@ -23,6 +23,7 @@ mhshow \- display nmh MIME messages
 .RB [ \-prefer
 .IR content ]
 \&...
+.RB [ \-noprefer ]
 .RB [ \-concat " | " \-noconcat ]
 .RB [ \-textonly " | " \-notextonly ]
 .RB [ \-inlineonly " | " \-noinlineonly ]
@@ -72,7 +73,7 @@ or
 switches will override the default settings of
 .B \-textonly
 and
-.BR \-inlineonly.
+.BR \-inlineonly .
 .PP
 The
 .B \-header
@@ -108,7 +109,9 @@ will accept the source message on the standard input.  Note that the
 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
@@ -204,7 +207,7 @@ In the absence of
 will select the "best" displayable subpart from multipart/alternative
 content.  The
 .B \-prefer
-switch can be used (one or more times, in order of descending
+switch can be used (one or more times, in order of ascending
 preference) to let MH know which content types from a
 multipart/alternative MIME part are preferred by the user, in order to
 override the default selection for display.  For example, mail is
@@ -228,6 +231,16 @@ faithful" position.  Thus, when viewed by
 the ordering of multipart/alternative parts will appear to change when
 invoked with or without various
 .B \-prefer
+switches.  Since the last of multiple 
+.B \-prefer
+options "wins", a
+.B \-prefer
+on the command line will override any in a profile entry.
+.PP
+The
+.B \-noprefer
+switch will cancel any previous
+.B \-prefer
 switches.
 .SS "Unseen Sequence"
 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
@@ -298,6 +311,9 @@ mhshow-suffix-application/PostScript: .ps
 .PP
 to automatically append a suffix to the temporary files.
 .PP
+The matching with the content type identifier is case-insensitive, both in
+mhshow-suffix-<type> and mhshow-show-<type> (below) profile entries.
+.PP
 The method used to display the different contents in the messages bodies
 will be determined by a \*(lqdisplay string\*(rq.  To find the display
 string,
@@ -344,14 +360,14 @@ for the current display string to finish execution before executing
 the next display string.
 .PP
 The {parameter} escape is typically used in a command line argument
-that should only be present if it has a non-null value.  Its value
-will be wrapped with single quotes if the escape is not so wrapped.
+that should only be present if it has a non-null value.  It is highly
+recommended that the entire escape be wrapped in double quotes.
 Shell parameter expansion can construct the argument only when it is
 non-null, e.g.,
 .PP
 .RS 5
 .nf
-mhshow-show-text/html: charset=%{charset};
+mhshow-show-text/html: charset="%{charset}";
   w3m ${charset:+-I $charset} -T text/html %F
 .fi
 .RE
@@ -424,9 +440,9 @@ If
 was built with
 .IR iconv (3),
 then all text/plain parts of the message(s) will be displayed using
-the character set of the current locale.  See the
+the character set of the current locale.  See
 .IR mhparam (1)
-man page for how to determine whether your
+for how to determine whether your
 .B nmh
 installation includes
 .IR iconv (3)