X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/c59d387888272695ccf163a8057275dbdc77afd0..2d8a2d23b4c17ffb277d008f4e011fcc2bb2fa7e:/man/mhshow.man?ds=inline diff --git a/man/mhshow.man b/man/mhshow.man index 28868de2..4d0dadc7 100644 --- a/man/mhshow.man +++ b/man/mhshow.man @@ -1,4 +1,4 @@ -.TH MHSHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] +.TH MHSHOW %manext1% "April 9, 2013" "%nmhversion%" .\" .\" %nmhwarning% .\" @@ -38,7 +38,7 @@ message or collection of messages. .PP .B mhshow manipulates multi-media messages as specified in -RFC\-2045 thru RFC\-2049. Currently +RFC\-2045 to RFC\-2049. Currently .B mhshow only supports encodings in message bodies, and does not support the encoding of @@ -76,7 +76,7 @@ be in mail drop format (to convert a file in mail drop format to a folder of .B nmh messages, see -.BR inc (1)). +.IR inc (1)). .PP A part specification consists of a series of numbers separated by dots. For example, in a multipart content containing three parts, these @@ -325,7 +325,7 @@ encounters a \*(lqcharset\*(rq parameter for this content, it checks if your terminal can display this character set natively. .B mhn -checks this by examining the the environment +checks this by examining the environment variable .BR $MM_CHARSET . If the value of this environment variable is equal @@ -409,7 +409,7 @@ profile entry to and it will get called automatically. (To handle other single-octet character sets, look at the -.BR less (1) +.IR less (1) manual entry for information about the .B $LESSCHARDEF environment variable.) @@ -419,7 +419,7 @@ cannot directly display messages of type partial. You must reassemble them first into a normal message using .BR mhstore . Check the man page for -.BR mhstore (1) +.IR mhstore (1) for details. .SS "External Access" For contents of type message/external-body, @@ -436,6 +436,8 @@ ftp local-file .IP \(bu 4 mail-server +.IP \(bu 4 +url .PP For the \*(lqanon-ftp\*(rq and \*(lqftp\*(rq access types, .B mhshow @@ -464,6 +466,14 @@ 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 +For the \*(lqurl\*(rq access\-type, +.B mhshow +will look for the \*(lqnmh-access-url\*(rq +profile entry. See +.IR mhstore (1) +for more details. +.PP .SS "The Content Cache" When .B mhshow @@ -551,6 +561,15 @@ which is created automatically during .B nmh installation. .SH FILES +.B mhshow +looks for all format files and mhn.defaults in multiple locations: +absolute pathnames are accessed directly, tilde expansion is done on +usernames, and files are searched for in the user's +.I Mail +directory as specified in their profile. If not found there, the directory +.RI \*(lq %etcdir% \*(rq +is checked. +.PP .fc ^ ~ .nf .ta \w'%etcdir%/ExtraBigFileName 'u @@ -569,6 +588,7 @@ installation. ^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-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 ^mhshow-charset-~^Template for environment to render character sets