X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmhshow.man1;h=9b6465da3dbd5f983dae3d812d8cde5ddbebdf4c;hb=55e1d8c654ee0f7c45b9361ce34617983b454c32;hp=57bfa311bf6eec363aab35a3972863f77b8cd8d9;hpb=31dc797eb5178970d68962ca8939da3fd9a8efda;p=mmh diff --git a/man/mhshow.man1 b/man/mhshow.man1 index 57bfa31..9b6465d 100644 --- a/man/mhshow.man1 +++ b/man/mhshow.man1 @@ -20,10 +20,6 @@ mhshow \- display MIME messages \&... .RB [ \-form .IR formfile ] -.RB [ \-rcache -.IR policy ] -.RB [ \-wcache -.IR policy ] .RB [ \-version ] .RB [ \-help ] .ad @@ -115,10 +111,6 @@ name of the content, e.g., \*(lqaudio\*(rq. To specify a specific subtype, separate the two with a slash, e.g., \*(lqaudio/basic\*(rq. Note that regardless of the values given to the `\-type' switch, a multipart content (of any subtype listed above) is always acted upon. -Further note that if the `\-type' switch is used, and it is desirable to -act on a message/external-body content, then the `\-type' switch must -be used twice: once for message/external-body and once for the content -externally referenced. .SS "Unseen Sequence" If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty, then @@ -261,12 +253,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: @@ -398,100 +384,10 @@ Check the man page for .BR mhstore (1) for details. .SS "External Access" -For contents of type message/external-body, -.B mhshow -supports these access-types: -.PP -.IP \(bu 4 -afs -.IP \(bu 4 -anon-ftp -.IP \(bu 4 -ftp -.IP \(bu 4 -local-file -.IP \(bu 4 -mail-server -.PP -For the \*(lqanon-ftp\*(rq and \*(lqftp\*(rq access types, -.B mhshow -will look for the \*(lqnmh-access-ftp\*(rq -profile entry, e.g., -.PP -.RS 5 -nmh-access-ftp: myftp.sh -.RE -.PP -to determine the pathname of a program to perform the FTP retrieval. -.PP -This program is invoked with these arguments: -.PP -.RS 5 -.nf -domain name of FTP-site -username -password -remote directory -remote filename -local filename -\*(lqascii\*(rq or \*(lqbinary\*(rq -.fi -.RE -.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). +.B Mhshow +does not automatically retrieve message/external-body parts (anymore), +but prints the relevant information to enable the user to retrieve +the files manually. .SS "User Environment" Because the display environment in which .B mhshow @@ -545,9 +441,6 @@ 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 -^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 @@ -561,9 +454,7 @@ mhbuild(1), mhl(1), mhlist(1), mhstore(1), sendfiles(1) .RB ` +folder "' defaults to the current folder" .RB ` msgs "' defaults to cur" .RB ` \-form \ mhl.headers' -.RB ` \-rcache \ ask' .RB ` \-noverbose ' -.RB ` \-wcache \ ask' .fi .SH CONTEXT