mhshow/mhstore: Removed support for retrieving message/external-body parts.

[mmh] / man / mhshow.man1

diff --git a/man/mhshow.man1 b/man/mhshow.man1
index bce55c1..9b6465d 100644 (file)
--- a/man/mhshow.man1
+++ b/man/mhshow.man1
@@ -18,14 +18,8 @@ mhshow \- display MIME messages
 .RB [ \-type
 .IR content ]
 \&...
 .RB [ \-type
 .IR content ]
 \&...

-.RB [ \-serialonly " | " \-noserialonly ]

 .RB [ \-form
 .IR formfile ]
 .RB [ \-form
 .IR formfile ]

-.RB [ \-rcache
-.IR policy ]
-.RB [ \-wcache
-.IR policy ]
-.RB [ \-check " | " \-nocheck ]

 .RB [ \-version ]
 .RB [ \-help ]
 .ad
 .RB [ \-version ]
 .RB [ \-help ]
 .ad

@@ -117,32 +111,15 @@ 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.
 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
 .B mhshow
 will remove each of the messages shown
 from each sequence named by the profile entry.
 .SS "Unseen Sequence"
 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
 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"
 .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
 using the standard format file
 .IR mhl.headers .
 You may specify an alternate format file with the

@@ -257,12 +234,12 @@ redirected from the terminal to the content.
 .PP
 If a display string is not found,
 .B mhshow
 .PP
 If a display string is not found,
 .B mhshow

-has several default values:
+has the following default values:

 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf

-mhshow-show-text/plain: %lmoreproc '%F'
-mhshow-show-message/rfc822: %lshow -file '%F'
+mhshow-show-text/plain: %l<defaultpager> '%F'
+mhshow-show-message/rfc822: %lshow \-file '%F'

 .fi
 .RE
 .PP
 .fi
 .RE
 .PP

@@ -276,12 +253,6 @@ multipart (without a profile entry), will be treated as multipart/mixed.
 .PP
 If none of these apply, then
 .B mhshow
 .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:
 will complain.
 .PP
 Example entries might be:

@@ -300,16 +271,14 @@ the shell of any funny characters that might be present in the filename.
 .PP
 Finally,
 .B mhshow
 .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
 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
 .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
 .SS "Showing Alternate Character Sets"
 Because a content of type text might be in a non-ASCII character
 set, when

@@ -394,9 +363,9 @@ determining whether a character is \*(lqnormal\*(rq, \*(lqcontrol\*(lq,
 or \*(lqbinary\*(rq.  The second line tells
 .B less
 not to warn you
 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
 set the

-.I moreproc
+.I Pager

 profile entry to
 .BR less ,
 and it will get
 profile entry to
 .BR less ,
 and it will get

@@ -415,105 +384,10 @@ Check the man page for
 .BR mhstore (1)
 for details.
 .SS "External Access"
 .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.
-.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).
+.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
 .SS "User Environment"
 Because the display environment in which
 .B mhshow

@@ -567,13 +441,9 @@ 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
 ^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-<charset>~^Template for environment to render character sets
 ^mhshow-show-<type>*~^Template for displaying contents
 ^mhshow-charset-<charset>~^Template for environment to render character sets
 ^mhshow-show-<type>*~^Template for displaying contents

-^moreproc:~^Default program to display text/plain content
+^Pager:~^Default program to display text/plain content

 .fi
 
 .SH "SEE ALSO"
 .fi
 
 .SH "SEE ALSO"

@@ -583,13 +453,8 @@ mhbuild(1), mhl(1), mhlist(1), mhstore(1), sendfiles(1)
 .nf
 .RB ` +folder "' defaults to the current folder"
 .RB ` msgs "' defaults to cur"
 .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 ` \-noverbose '

-.RB ` \-wcache ask '

 .fi
 
 .SH CONTEXT
 .fi
 
 .SH CONTEXT