4 .TH MHSHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 mhshow \- display MIME messages
33 command display contents of a MIME (multi-media)
34 message or collection of messages.
37 manipulates multi-media messages as specified in
38 RFC\-2045 thru RFC\-2049. Currently
41 encodings in message bodies, and does not support the encoding of
42 message headers as specified in RFC\-2047.
46 will display all parts of a multipart
54 to particular subparts (of a
55 multipart content) and/or particular content types.
62 to use the specified file as
63 the source message, rather than a message from a folder. If you specify
64 this file as \*(lq-\*(rq, then
66 will accept the source message
67 on the standard input. Note that the file, or input from standard input
68 should be a validly formatted message, just like any other
72 be in mail drop format (to convert a file in
73 mail drop format to a folder of
78 A part specification consists of a series of numbers separated by dots.
79 For example, in a multipart content containing three parts, these
80 would be named as 1, 2, and 3, respectively. If part 2 was also a
81 multipart content containing two parts, these would be named as 2.1 and
82 2.2, respectively. Note that the
84 switch is effective for only
85 messages containing a multipart content. If a message has some other
86 kind of content, or if the part is itself another multipart content, the
88 switch will not prevent the content from being acted upon.
90 A content specification consists of a content type and a subtype.
91 The initial list of \*(lqstandard\*(rq content types and subtypes can
92 be found in RFC\-2046.
94 A list of commonly used contents is briefly reproduced here:
102 multipart mixed, alternative, digest, parallel
103 message rfc822, partial, external-body
104 application octet-stream, postscript
111 A legal MIME message must contain a subtype specification.
113 To specify a content, regardless of its subtype, just use the
114 name of the content, e.g., \*(lqaudio\*(rq. To specify a specific
115 subtype, separate the two with a slash, e.g., \*(lqaudio/basic\*(rq.
116 Note that regardless of the values given to the `\-type' switch, a
117 multipart content (of any subtype listed above) is always acted upon.
118 Further note that if the `\-type' switch is used, and it is desirable to
119 act on a message/external-body content, then the `\-type' switch must
120 be used twice: once for message/external-body and once for the content
121 externally referenced.
122 .SS "Unseen Sequence"
123 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
126 will remove each of the messages shown
127 from each sequence named by the profile entry.
128 .SS "Showing the Contents"
129 The headers of each message are displayed with
131 using the standard format file
133 You may specify an alternate format file with the
136 switch. If the format file
138 is specified, then the display
139 of the message headers is suppressed.
141 Next, the contents are extracted from the message and are stored in
142 a temporary file. Usually, the name of the temporary file is the
143 word \*(lqmhshow\*(rq followed by a string of characters. Occasionally,
144 the method used to display a content (described next), requires that
145 the file end in a specific suffix. For example, the
147 command (part of the StarOffice package) can be used to display
148 Microsoft Word content, but it uses the suffix to determine how to display
149 the file. If no suffix is present, the file is not correctly loaded.
150 Similarily, older versions of the
152 command append a \*(lq.ps\*(rq suffix to
153 the filename if one was missing. As a result, these cannot be used to read
154 the default temporary file.
156 To get around this, your profile can contain lines of the form:
159 mhshow-suffix-<type>/<subtype>: <suffix>
165 mhshow-suffix-<type>: <suffix>
168 to specify a suffix which can be automatically added to the temporary
169 file created for a specific content type. For example, the following
170 lines might appear in your profile:
174 mhshow-suffix-text: .txt
175 mhshow-suffix-application/msword: .doc
176 mhshow-suffix-application/PostScript: .ps
180 to automatically append a suffix to the temporary files.
182 The method used to display the different contents in the messages bodies
183 will be determined by a \*(lqdisplay string\*(rq. To find the display
186 will first search your profile for an entry of the form:
189 mhshow-show-<type>/<subtype>
192 to determine the display string. If this isn't found,
194 will search for an entry of the form:
200 to determine the display string.
202 If a display string is found, any escapes (given below) will be expanded.
203 The result will be executed under
204 \*(lq/bin/sh\*(rq, with the standard input
207 The display string may contain the following escapes:
212 %a Insert parameters from Content-Type field
213 %e exclusive execution
214 %f Insert filename containing content
215 %F %e, %f, and stdin is terminal not content
216 %l display listing prior to displaying content
218 %s Insert content subtype
219 %d Insert content description
220 %% Insert the character %
224 For those display strings containing the e- or F-escape,
227 execute at most one of these at any given time. Although the F-escape
228 expands to be the filename containing the content, the e-escape has no
229 expansion as far as the shell is concerned.
233 is display a content, typing QUIT (usually
234 control-\\) will tell
236 to wrap things up immediately.
238 Note that if the content being displayed is multipart, but not one of
239 the subtypes listed above, then the f- and F-escapes expand to multiple
240 filenames, one for each subordinate content. Further, stdin is not
241 redirected from the terminal to the content.
243 If a display string is not found,
245 has the following default values:
249 mhshow-show-text/plain: %l<defaultpager> '%F'
250 mhshow-show-message/rfc822: %lshow \-file '%F'
254 If a subtype of type text doesn't have a profile entry, it will be
255 treated as text/plain.
258 has default methods for handling multipart messages of subtype
259 mixed, alternative, parallel, and digest. Any unknown subtype of type
260 multipart (without a profile entry), will be treated as multipart/mixed.
262 If none of these apply, then
264 will check to see if the message
265 has an application/octet-stream content with parameter \*(lqtype=tar\*(rq.
268 will use an appropriate command. If not,
272 Example entries might be:
276 mhshow-show-audio/basic: raw2audio 2>/dev/null | play
277 mhshow-show-image: xv '%f'
278 mhshow-show-application/PostScript: lpr -Pps
282 Note that when using the f- or F-escape, it's a good idea to use
283 single-quotes around the escape. This prevents misinterpretation by
284 the shell of any funny characters that might be present in the filename.
288 will process each message serially \- it won't start
289 showing the next message until all the commands executed to display the
290 current message have terminated. In the case of a multipart content
291 (of any subtype listed above), the content contains advice indicating if
292 the parts should be displayed serially or in parallel. Because this may
293 cause confusion, particularly on uni-window displays,
295 will never display parts in parallel.
296 .SS "Showing Alternate Character Sets"
297 Because a content of type text might be in a non-ASCII character
300 encounters a \*(lqcharset\*(rq parameter for
301 this content, it checks if your terminal can display this character
304 checks this by examining the the environment
307 If the value of this environment variable is equal
308 to the value of the charset parameter, then
311 display this content without any additional setup. If this environment
314 will assume a value of \*(lqUS-ASCII\*(rq.
315 If the character set cannot be displayed natively, then
317 will look for an entry of the form:
320 mhshow-charset-<charset>
323 which should contain a command creating an environment to render
324 the character set. This command string should containing a single
325 \*(lq%s\*(rq, which will be filled-in with the command to display the
328 Example entries might be:
331 mhshow-charset-iso-8859-1: xterm -fn '-*-*-medium-r-normal-*-*-120-*-*-c-*-iso8859-*' -e %s
337 mhshow-charset-iso-8859-1: '%s'
340 The first example tells
345 appropriate character set for that message content. The second example
348 that your pager (or other program handling that content
349 type) can handle that character set, and that no special processing is
352 Note that many pagers strip off the high-order bit or have problems
353 displaying text with the high-order bit set. However, the pager
355 has support for single-octet character sets. The source
358 is available on many ftp sites carrying free software.
359 In order to view messages sent in the ISO-8859-1 character set using
362 put these lines in your
368 setenv LESSCHARSET latin1
375 to use the ISO-8859-1 definition for
376 determining whether a character is \*(lqnormal\*(rq, \*(lqcontrol\*(lq,
377 or \*(lqbinary\*(rq. The second line tells
380 if it encounters a file that has non-ASCII characters. Then,
386 called automatically. (To handle other single-octet character sets,
389 manual entry for information about the
391 environment variable.)
392 .SS "Messages of Type message/partial"
394 cannot directly display messages of type partial.
395 You must reassemble them first into a normal message using
397 Check the man page for
400 .SS "External Access"
401 For contents of type message/external-body,
403 supports these access-types:
416 For the \*(lqanon-ftp\*(rq and \*(lqftp\*(rq access types,
418 will look for the \*(lqnmh-access-ftp\*(rq
422 nmh-access-ftp: myftp.sh
425 to determine the pathname of a program to perform the FTP retrieval.
427 This program is invoked with these arguments:
431 domain name of FTP-site
437 \*(lqascii\*(rq or \*(lqbinary\*(rq
441 The program should terminate with an exit status of zero if the
442 retrieval is successful, and a non-zero exit status otherwise.
443 .SS "The Content Cache"
446 encounters an external content containing a
447 \*(lqContent-ID:\*(rq field, and if the content allows caching, then
448 depending on the caching behavior of
450 the content might be read from or written to a cache.
452 The caching behavior of
454 is controlled with the
458 switches, which define the policy for reading from,
459 and writing to, the cache, respectively. One of four policies may be
460 specified: \*(lqpublic\*(rq, indicating that
463 of a publically-accessible content cache; \*(lqprivate\*(rq, indicating
466 should make use of the user's private content cache;
467 \*(lqnever\*(rq, indicating that
469 should never make use of
470 caching; and, \*(lqask\*(rq, indicating that
474 There are two directories where contents may be cached: the profile entry
475 \*(lqnmh-cache\*(rq names a directory containing world-readable contents, and,
476 the profile entry \*(lqnmh-private-cache\*(rq names a directory containing
477 private contents. The former should be an absolute (rooted) directory
486 might be used if you didn't care that the cache got wiped after each
487 reboot of the system. The private cache is interpreted relative to the user's
488 mail storage, if not rooted, e.g.,
491 nmh-private-cache: .cache
494 (which is the default value).
495 .SS "User Environment"
496 Because the display environment in which
498 operates may vary for
501 will look for the environment variable
503 If present, this specifies the name of an additional
504 user profile which should be read. Hence, when a user logs in on a
505 particular display device, this environment variable should be set to
506 refer to a file containing definitions useful for the given display device.
507 Normally, only entries that deal with the methods to display different
508 content type and subtypes
512 mhshow-show-<type>/<subtype>
517 need be present in this additional profile. Finally,
519 will attempt to consult one other additional user profile,
523 %etcdir%/mhn.defaults
526 which is created automatically during
533 .ta \w'%etcdir%/ExtraBigFileName 'u
534 ^$HOME/.mmh/profile~^The user profile
535 ^$MHSHOW~^Additional profile entries
536 ^%etcdir%/mhn.defaults~^System default MIME profile entries
537 ^%etcdir%/mhl.headers~^The headers template
540 .SH "PROFILE COMPONENTS"
544 .ta \w'ExtraBigProfileName 'u
545 ^Path:~^To determine the user's mail storage
546 ^Current\-Folder:~^To find the default current folder
547 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
548 ^nmh-access-ftp:~^Program to retrieve contents via FTP
549 ^nmh-cache~^Public directory to store cached external contents
550 ^nmh-private-cache~^Personal directory to store cached external contents
551 ^mhshow-charset-<charset>~^Template for environment to render character sets
552 ^mhshow-show-<type>*~^Template for displaying contents
553 ^Pager:~^Default program to display text/plain content
557 mhbuild(1), mhl(1), mhlist(1), mhstore(1), sendfiles(1)
561 .RB ` +folder "' defaults to the current folder"
562 .RB ` msgs "' defaults to cur"
563 .RB ` \-form \ mhl.headers'
564 .RB ` \-rcache \ ask'
566 .RB ` \-wcache \ ask'
570 If a folder is given, it will become the current folder. The last
571 message selected will become the current message.