X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/39a9d9d85d0f2289d8c1257251311b7cf959c700..62b9266aa31b2baced3252987b256b4e43ec9573:/man/mhstore.man diff --git a/man/mhstore.man b/man/mhstore.man index 9c99f515..333a8731 100644 --- a/man/mhstore.man +++ b/man/mhstore.man @@ -25,14 +25,10 @@ mhstore \- store contents of nmh MIME messages into files .RB [ \-prefer .IR content ] \&... +.RB [ \-noprefer ] .RB [ \-auto " | " \-noauto ] .RB [ \-clobber .IR always " | " auto " | " suffix " | " ask " | " never ] -.RB [ \-rcache -.IR policy ] -.RB [ \-wcache -.IR policy ] -.RB [ \-check " | " \-nocheck ] .RB [ \-verbose " | " \-noverbose ] .ad .SH DESCRIPTION @@ -121,7 +117,7 @@ Type Subtypes ---- -------- text plain, enriched multipart mixed, alternative, digest, parallel -message rfc822, partial, external-body +message rfc822, external-body application octet-stream, postscript image jpeg, gif, png audio basic @@ -158,22 +154,22 @@ but is also implemented in and .B mhstore to make common part-numbering possible across all three programs. +The last of multiple +.B \-prefer +switches will have the highest priority. This allows the command line +switches to override profile entries. See .IR mhlist (1) and .IR mhshow (1) for more information on -.BR \-prefer. -.SS "Checking the Contents" +.BR \-prefer . +.PP The -.B \-check -switch tells -.B mhstore -to check each content for an integrity checksum. -If a content has such a checksum (specified as a Content-MD5 header -field), then -.B mhstore -will attempt to verify the integrity of the content. +.B \-noprefer +switch will cancel any previous +.B \-prefer +switches. .SS "Storing the Contents" .B mhstore will store the contents of the named messages in @@ -297,7 +293,6 @@ Example profile entries might be: .nf mhstore-store-text: %m%P.txt mhstore-store-text: +inbox -mhstore-store-message/partial: + mhstore-store-audio/basic: | raw2audio -e ulaw -s 8000 -c 1 > %m%P.au mhstore-store-image/jpeg: %m%P.jpg mhstore-store-application/PostScript: %m%P.ps @@ -378,50 +373,6 @@ terminal, .I ask behaves the same as .IR always . -.SS "Reassembling Messages of Type message/partial" -.B mhstore -is also able to reassemble messages that have been -split into multiple messages of type \*(lqmessage/partial\*(rq. -.PP -When asked to store a content containing a partial message, -.B mhstore -will try to locate all of the portions and combine them accordingly. -The default is to store the combined parts as a new message in the -current folder, although this can be changed using formatting -strings as discussed above. Thus, if someone has sent you a -message in several parts (such as the output from -.BR sendfiles ), -you can easily reassemble them into a single message in the -following fashion: -.PP -.RS 5 -.nf -% mhlist 5-8 - msg part type/subtype size description - 5 message/partial 47K part 1 of 4 - 6 message/partial 47K part 2 of 4 - 7 message/partial 47K part 3 of 4 - 8 message/partial 18K part 4 of 4 -% mhstore 5-8 -reassembling partials 5,6,7,8 to folder inbox as message 9 -% mhlist -verbose 9 - msg part type/subtype size description - 9 application/octet-stream 118K - (extract with uncompress | tar xvpf -) - type=tar - conversions=compress -.fi -.RE -.PP -This will store exactly one message, containing the sum of the -parts. It doesn't matter whether the partials are specified in -order, since -.B mhstore -will sort the partials, so that they are combined in the correct -order. But if -.B mhstore -can not locate every partial necessary to reassemble the message, -it will not store anything. .SS "External Access" For contents of type message/external-body, \fImhstore\fR supports these access-types: @@ -477,56 +428,6 @@ to determine the program to use to perform the HTTP retrieval. This program is invoked with one argument: the URL of the content to retrieve. The program should write the content to standard out, and should terminate with a status of zero if the retrieval is successful and a non-zero exit status otherwise. -.SS "The Content Cache" -When -.B mhstore -encounters an external content containing a -\*(lqContent-ID:\*(rq field, and if the content allows caching, then -depending on the caching behavior of -.BR mhstore , -the content might be read from or written to a cache. -.PP -The caching behavior of -.B mhstore -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 mhstore -should make use -of a publicly-accessible content cache; \*(lqprivate\*(rq, indicating that -.B mhstore -should make use of the user's private content cache; -\*(lqnever\*(rq, indicating that -.B mhstore -should never make use of caching; and, \*(lqask\*(rq, indicating that -.B mhstore -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 latter is interpreted relative to the user's -nmh directory, if not rooted, e.g., -.PP -.RS 5 -nmh-private-cache: .cache -.RE -.PP -(which is the default value). .SS "User Environment" Because the environment in which .B mhstore @@ -594,8 +495,6 @@ is checked. ^Current\-Folder:~^To find the default current folder ^nmh-access-ftp:~^Program to retrieve contents via FTP ^nmh-access-url:~^Program to retrieve contents via HTTP -^nmh-cache~^Public directory to store cached external contents -^nmh-private-cache~^Personal directory to store cached external contents ^nmh-storage~^Directory to store contents ^mhstore-store-*~^Template for storing contents .fi @@ -612,8 +511,6 @@ is checked. .RB ` \-noauto ' .RB ` \-clobber\ always ' .RB ` \-nocheck ' -.RB ` \-rcache\ ask ' -.RB ` \-wcache\ ask ' .RB ` \-verbose ' .SH CONTEXT If a folder is given, it will become the current folder. The last