]> diplodocus.org Git - nmh/blobdiff - man/mhshow.man
Tweaked check of -outfile in test-mhstore.
[nmh] / man / mhshow.man
index 28868de2a8772eb93aa7d1c0a29ab49614c662bb..4d0dadc7fa2c306bb5ab3aaf01830258e4b57f9f 100644 (file)
@@ -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-<charset>~^Template for environment to render character sets