Factor trim format function out
[mmh] / man / mhlist.man1
index 14912a2..90f46cc 100644 (file)
@@ -18,15 +18,8 @@ mhlist \- list information about MIME messages
 .RB [ \-type
 .IR content ]
 \&...
-.RB [ \-headers " | " \-noheaders ]
-.RB [ \-realsize " | " \-norealsize ]
-.RB [ \-rcache
-.IR policy ]
-.RB [ \-wcache
-.IR policy ]
-.RB [ \-check " | " \-nocheck ]
 .RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .ad
 .SH DESCRIPTION
@@ -41,24 +34,15 @@ manipulates MIME (multi-media messages) as specified
 in RFC\-2045 thru RFC\-2049 (See
 .BR mhbuild (1)).
 .PP
-The
-.B \-headers
-switch indicates that a one-line banner should be
-displayed above the listing.
-.PP
-The
-.B \-realsize
-switch tells
-.B mhlist
-to evaluate the
-\*(lqnative\*(rq (decoded) format of each content prior to listing.
+A one-line banner is displayed above the listing.
+The size of the
+`native' (decoded) format of each content is evaluated.
 This provides an accurate count at the expense of a small delay.
-.PP
 If the
 .B \-verbose
 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.
+any `extra' information that is present in the message,
+such as comments in the `Content-Type' header.
 .PP
 The option
 .B \-file
@@ -67,18 +51,18 @@ directs
 .B mhlist
 to use the specified
 file as the source message, rather than a message from a folder.
-If you specify this file as \*(lq-\*(rq, then
+If you specify this file as `-', then
 .B mhlist
 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
+.B mh
 message.  It should
 .B NOT
 be in mail drop format (to convert a file in mail drop format to
 a folder of
-.B nmh
+.B mh
 messages, see
 .BR inc (1)).
 .PP
@@ -105,7 +89,7 @@ kind of content, or if the part is itself another multipart content, the
 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
+The initial list of `standard' content types and subtypes can
 be found in RFC\-2046.
 .PP
 A list of commonly used contents is briefly reproduced here:
@@ -128,31 +112,12 @@ video     mpeg
 A legal MIME message must contain a subtype specification.
 .PP
 To specify a content, regardless of its subtype, just use the
-name of the content, e.g., \*(lqaudio\*(rq.  To specify a specific
-subtype, separate the two with a slash, e.g., \*(lqaudio/basic\*(rq.
+name of the content, e.g., `audio'.  To specify a specific
+subtype, separate the two with a slash, e.g., `audio/basic'.
 Note that regardless of the values given to the
 .B \-type
 switch, a
 multipart content (of any subtype listed above) is always acted upon.
-Further note that if the
-.B \-type
-switch is used, and it is desirable to
-act on a message/external-body content, then the
-.B \-type
-switch must
-be used twice: once for message/external-body and once for the content
-externally referenced.
-.SS "Checking the Contents"
-The
-.B \-check
-switch tells
-.B mhlist
-to check each content for an
-integrity checksum.  If a content has such a checksum (specified as a
-Content-MD5 header field), then
-.B mhlist
-will attempt to verify the
-integrity of the content.
 
 .SH FILES
 .fc ^ ~
@@ -171,17 +136,12 @@ integrity of the content.
 .fi
 
 .SH "SEE ALSO"
-mhbuild(1), mhshow(1), mhstore(1), sendfiles(1)
+mhbuild(1), show(1), mhstore(1), sendfiles(1)
 
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
-.RB ` msgs "' defaults to cur"
-.RB ` \-nocheck '
-.RB ` \-headers '
-.RB ` \-realsize '
-.RB ` \-rcache \ ask'
-.RB ` \-wcache \ ask'
+.RB ` msgs "' defaults to the current message"
 .RB ` \-noverbose '
 .fi