X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhlist.man1;h=90f46cc82b17fb2cb46c31b5d7a1376b29f42b0e;hp=14912a25c378f4e8e4d43a58c1a33255ae249f86;hb=18591f8e001ecedbee48a51c1d1f08ebaa1c15c8;hpb=eea4d1cb63d62652e6413edfae2eaf5d4944d80f diff --git a/man/mhlist.man1 b/man/mhlist.man1 index 14912a2..90f46cc 100644 --- a/man/mhlist.man1 +++ b/man/mhlist.man1 @@ -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