X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhshow.man1;h=8ebc7ba3e773d5bb8e2ee63c501875b1db4cdd49;hp=5c49255f6c8fdf46b444fead2ddda0852d330753;hb=94c80042eae3383c812d9552089953f9846b1bb6;hpb=0c4214ea2aec6497d0d67b436bbee9bc1d225f1e diff --git a/man/mhshow.man1 b/man/mhshow.man1 index 5c49255..8ebc7ba 100644 --- a/man/mhshow.man1 +++ b/man/mhshow.man1 @@ -18,14 +18,8 @@ mhshow \- display MIME messages .RB [ \-type .IR content ] \&... -.RB [ \-serialonly " | " \-noserialonly ] .RB [ \-form .IR formfile ] -.RB [ \-rcache -.IR policy ] -.RB [ \-wcache -.IR policy ] -.RB [ \-check " | " \-nocheck ] .RB [ \-version ] .RB [ \-help ] .ad @@ -127,22 +121,9 @@ non\-empty, then .B mhshow will remove each of the messages shown from each sequence named by the profile entry. -.SS "Checking the Contents" -The -.B \-check -switch tells -.B mhshow -to check each content for an -integrity checksum. If a content has such a checksum (specified as a -Content-MD5 header field), then -.B mhshow -will attempt to verify the -integrity of the content. .SS "Showing the Contents" -The headers of each message are displayed with the -.I mhlproc -(usually -.BR mhl ), +The headers of each message are displayed with +.B mhl using the standard format file .IR mhl.headers . You may specify an alternate format file with the @@ -276,12 +257,6 @@ multipart (without a profile entry), will be treated as multipart/mixed. .PP If none of these apply, then .B mhshow -will check to see if the message -has an application/octet-stream content with parameter \*(lqtype=tar\*(rq. -If so, -.B mhshow -will use an appropriate command. If not, -.B mhshow will complain. .PP Example entries might be: @@ -300,16 +275,14 @@ the shell of any funny characters that might be present in the filename. .PP Finally, .B mhshow -will process each message serially\0--\0it won't start +will process each message serially \- it won't start showing the next message until all the commands executed to display the current message have terminated. In the case of a multipart content (of any subtype listed above), the content contains advice indicating if the parts should be displayed serially or in parallel. Because this may -cause confusion, particularly on uni-window displays, the -.B \-serialonly -switch can be given to tell +cause confusion, particularly on uni-window displays, .B mhshow -to never display parts in parallel. +will never display parts in parallel. .SS "Showing Alternate Character Sets" Because a content of type text might be in a non-ASCII character set, when @@ -457,58 +430,6 @@ local filename .PP The program should terminate with an exit status of zero if the retrieval is successful, and a non-zero exit status otherwise. -.SS "The Content Cache" -When -.B mhshow -encounters an external content containing a -\*(lqContent-ID:\*(rq field, and if the content allows caching, then -depending on the caching behavior of -.BR mhshow , -the content might be read from or written to a cache. -.PP -The caching behavior of -.B mhshow -is controlled with the -.B \-rcache -and -.B \-wcache -switches, which define the policy for reading from, -and writing to, the cache, respectively. One of four policies may be -specified: \*(lqpublic\*(rq, indicating that -.B mhshow -should make use -of a publically-accessible content cache; \*(lqprivate\*(rq, indicating -that -.B mhshow -should make use of the user's private content cache; -\*(lqnever\*(rq, indicating that -.B mhshow -should never make use of -caching; and, \*(lqask\*(rq, indicating that -.B mhshow -should ask the user. -.PP -There are two directories where contents may be cached: the profile entry -\*(lqnmh-cache\*(rq names a directory containing world-readable contents, and, -the profile entry \*(lqnmh-private-cache\*(rq names a directory containing -private contents. The former should be an absolute (rooted) directory -name. -.PP -For example, -.PP -.RS 5 -nmh-cache: /tmp -.RE -.PP -might be used if you didn't care that the cache got wiped after each -reboot of the system. The private cache is interpreted relative to the user's -mail storage, if not rooted, e.g., -.PP -.RS 5 -nmh-private-cache: .cache -.RE -.PP -(which is the default value). .SS "User Environment" Because the display environment in which .B mhshow @@ -562,10 +483,7 @@ installation. ^Path:~^To determine the user's mail storage ^Current\-Folder:~^To find the default current folder ^Unseen\-Sequence:~^To name sequences denoting unseen messages -^mhlproc:~^Default program to display message headers ^nmh-access-ftp:~^Program to retrieve contents via FTP -^nmh-cache~^Public directory to store cached external contents -^nmh-private-cache~^Personal directory to store cached external contents ^mhshow-charset-~^Template for environment to render character sets ^mhshow-show-*~^Template for displaying contents ^Pager:~^Default program to display text/plain content @@ -578,13 +496,8 @@ mhbuild(1), mhl(1), mhlist(1), mhstore(1), sendfiles(1) .nf .RB ` +folder "' defaults to the current folder" .RB ` msgs "' defaults to cur" -.RB ` \-nocheck ' -.RB ` \-form mhl.headers ' -.RB ` \-rcache ask ' -.RB ` \-realsize ' -.RB ` \-noserialonly ' +.RB ` \-form \ mhl.headers' .RB ` \-noverbose ' -.RB ` \-wcache ask ' .fi .SH CONTEXT