X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhshow.man1;h=8ebc7ba3e773d5bb8e2ee63c501875b1db4cdd49;hp=bce55c15df7bb9ed075062f829c4bd6336e3eab6;hb=94c80042eae3383c812d9552089953f9846b1bb6;hpb=a4605f68e8ff04d4539e402a6fb00ff188944e1c diff --git a/man/mhshow.man1 b/man/mhshow.man1 index bce55c1..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 @@ -257,12 +238,12 @@ redirected from the terminal to the content. .PP If a display string is not found, .B mhshow -has several default values: +has the following default values: .PP .RS 5 .nf -mhshow-show-text/plain: %lmoreproc '%F' -mhshow-show-message/rfc822: %lshow -file '%F' +mhshow-show-text/plain: %l '%F' +mhshow-show-message/rfc822: %lshow \-file '%F' .fi .RE .PP @@ -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 @@ -394,9 +367,9 @@ determining whether a character is \*(lqnormal\*(rq, \*(lqcontrol\*(lq, or \*(lqbinary\*(rq. The second line tells .B less not to warn you -if it encounters a file that has non-ASCII characters. Then, simply +if it encounters a file that has non-ASCII characters. Then, set the -.I moreproc +.I Pager profile entry to .BR less , and it will get @@ -457,63 +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. -.PP -If this entry is not provided, then -.B mhshow -will use a simple -built-in FTP client to perform the retrieval. -.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 @@ -567,13 +483,10 @@ 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 -^moreproc:~^Default program to display text/plain content +^Pager:~^Default program to display text/plain content .fi .SH "SEE ALSO" @@ -583,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