In mhshow, copy result of call to norm_charmap() and get_charset()

[nmh] / man / mhlist.man

diff --git a/man/mhlist.man b/man/mhlist.man
index 12d09fc2b14101409ae3b4c5fec8631203f91e56..69394fec7b80489d0b37acf556a12625c3e59e87 100644 (file)
--- a/man/mhlist.man
+++ b/man/mhlist.man
@@ -1,12 +1,12 @@
+.TH MHLIST %manext1% "February 12, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH MHLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mhlist \- list information about MIME messages
 .SH SYNOPSIS
 .HP 5
+.na
 .B mhlist
 .RI [ +folder ]
 .RI [ msgs ]
@@ -25,8 +25,12 @@ mhlist \- list information about MIME messages
 .RB [ \-wcache
 .IR policy ]
 .RB [ \-check " | " \-nocheck ]
+.RB [ \-changecur " | " \-nochangecur ]
+.RB [ \-verbose " | " \-noverbose ]
+.RB [ \-disposition " | " \-nodisposition ]
 .RB [ \-version ]
 .RB [ \-help ]
+.ad
 .SH DESCRIPTION
 The
 .B mhlist
@@ -36,8 +40,8 @@ MIME (multi-media) messages.
 .PP
 .B mhlist
 manipulates MIME (multi-media messages) as specified
-in RFC\-2045 thru RFC\-2049 (See
-.BR mhbuild (1)).
+in RFC 2045 to RFC 2049 (See
+.IR mhbuild (1)).
 .PP
 The
 .B \-headers
@@ -58,6 +62,11 @@ switch is present, then the listing will show
 any \*(lqextra\*(rq information that is present in the message,
 such as comments in the \*(lqContent-Type\*(rq header.
 .PP
+If the
+.B \-disposition
+switch is present, then the listing will show any relevant information from
+the \*(lqContent-Disposition\*(rq header.
+.PP
 The option
 .B \-file
 .I file
@@ -78,7 +87,7 @@ be in mail drop format (to convert a file in mail drop format to
 a folder of
 .B nmh
 messages, see
-.BR inc (1)).
+.IR inc (1)).
 .PP
 By default,
 .B mhlist
@@ -104,7 +113,7 @@ switch will not prevent the content from being acted upon.
 .PP
 A content specification consists of a content type and a subtype.
 The initial list of \*(lqstandard\*(rq content types and subtypes can
-be found in RFC\-2046.
+be found in RFC 2046.
 .PP
 A list of commonly used contents is briefly reproduced here:
 .PP
@@ -140,6 +149,10 @@ act on a message/external-body content, then the
 switch must
 be used twice: once for message/external-body and once for the content
 externally referenced.
+.PP
+The parts of a multipart/alternative part are listed in the reverse
+order of their placement in the message.  The listing therefore is
+in decreasing order of preference, as defined in RFC 1521.
 .SS "Checking the Contents"
 The
 .B \-check
@@ -151,14 +164,12 @@ Content-MD5 header field), then
 .B mhlist
 will attempt to verify the
 integrity of the content.
-
 .SH FILES
 .fc ^ ~
 .nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
+.ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -167,10 +178,10 @@ integrity of the content.
 ^Path:~^To determine the user's nmh directory
 ^Current\-Folder:~^To find the default current folder
 .fi
-
 .SH "SEE ALSO"
-mhbuild(1), mhshow(1), mhstore(1), sendfiles(1)
-
+.IR mhbuild (1),
+.IR mhshow (1),
+.IR mhstore (1)
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
@@ -178,11 +189,14 @@ mhbuild(1), mhshow(1), mhstore(1), sendfiles(1)
 .RB ` \-nocheck '
 .RB ` \-headers '
 .RB ` \-realsize '
-.RB ` \-rcache ask '
-.RB ` \-wcache ask '
+.RB ` \-rcache\ ask '
+.RB ` \-wcache\ ask '
+.RB ` \-changecur '
 .RB ` \-noverbose '
+.RB ` \-nodisposition '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  The last
-message selected will become the current message.
+message selected will become the current message, unless the
+.B \-nochangecur
+option is specified.