Added full output test to test-scan.

[nmh] / man / mhshow.man

diff --git a/man/mhshow.man b/man/mhshow.man
index 93225290531fd46236080eb970479f624a563852..4cbbd191502c4287a8bae591c792fd8535dd6d42 100644 (file)
--- 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
@@ -206,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
@@ -230,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
@@ -300,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,
@@ -346,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