4 .TH MHSHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 mhshow \- display MIME messages
29 command display contents of a MIME (multi-media)
30 message or collection of messages.
33 manipulates multi-media messages as specified in
34 RFC\-2045 thru RFC\-2049. Currently
37 encodings in message bodies, and does not support the encoding of
38 message headers as specified in RFC\-2047.
42 will display all parts of a multipart
50 to particular subparts (of a
51 multipart content) and/or particular content types.
58 to use the specified file as
59 the source message, rather than a message from a folder. If you specify
60 this file as \*(lq-\*(rq, then
62 will accept the source message
63 on the standard input. Note that the file, or input from standard input
64 should be a validly formatted message, just like any other
68 be in mail drop format (to convert a file in
69 mail drop format to a folder of
74 A part specification consists of a series of numbers separated by dots.
75 For example, in a multipart content containing three parts, these
76 would be named as 1, 2, and 3, respectively. If part 2 was also a
77 multipart content containing two parts, these would be named as 2.1 and
78 2.2, respectively. Note that the
80 switch is effective for only
81 messages containing a multipart content. If a message has some other
82 kind of content, or if the part is itself another multipart content, the
84 switch will not prevent the content from being acted upon.
86 A content specification consists of a content type and a subtype.
87 The initial list of \*(lqstandard\*(rq content types and subtypes can
88 be found in RFC\-2046.
90 A list of commonly used contents is briefly reproduced here:
98 multipart mixed, alternative, digest, parallel
99 message rfc822, partial, external-body
100 application octet-stream, postscript
107 A legal MIME message must contain a subtype specification.
109 To specify a content, regardless of its subtype, just use the
110 name of the content, e.g., \*(lqaudio\*(rq. To specify a specific
111 subtype, separate the two with a slash, e.g., \*(lqaudio/basic\*(rq.
112 Note that regardless of the values given to the `\-type' switch, a
113 multipart content (of any subtype listed above) is always acted upon.
114 .SS "Unseen Sequence"
115 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
118 will remove each of the messages shown
119 from each sequence named by the profile entry.
120 .SS "Showing the Contents"
121 The headers of each message are displayed with
123 using the standard format file
125 You may specify an alternate format file with the
128 switch. If the format file
130 is specified, then the display
131 of the message headers is suppressed.
133 Next, the contents are extracted from the message and are stored in
134 a temporary file. Usually, the name of the temporary file is the
135 word \*(lqmhshow\*(rq followed by a string of characters. Occasionally,
136 the method used to display a content (described next), requires that
137 the file end in a specific suffix. For example, the
139 command (part of the StarOffice package) can be used to display
140 Microsoft Word content, but it uses the suffix to determine how to display
141 the file. If no suffix is present, the file is not correctly loaded.
142 Similarily, older versions of the
144 command append a \*(lq.ps\*(rq suffix to
145 the filename if one was missing. As a result, these cannot be used to read
146 the default temporary file.
148 To get around this, your profile can contain lines of the form:
151 mhshow-suffix-<type>/<subtype>: <suffix>
157 mhshow-suffix-<type>: <suffix>
160 to specify a suffix which can be automatically added to the temporary
161 file created for a specific content type. For example, the following
162 lines might appear in your profile:
166 mhshow-suffix-text: .txt
167 mhshow-suffix-application/msword: .doc
168 mhshow-suffix-application/PostScript: .ps
172 to automatically append a suffix to the temporary files.
174 The method used to display the different contents in the messages bodies
175 will be determined by a \*(lqdisplay string\*(rq. To find the display
178 will first search your profile for an entry of the form:
181 mhshow-show-<type>/<subtype>
184 to determine the display string. If this isn't found,
186 will search for an entry of the form:
192 to determine the display string.
194 If a display string is found, any escapes (given below) will be expanded.
195 The result will be executed under
196 \*(lq/bin/sh\*(rq, with the standard input
199 The display string may contain the following escapes:
204 %a Insert parameters from Content-Type field
205 %e exclusive execution
206 %f Insert filename containing content
207 %F %e, %f, and stdin is terminal not content
208 %l display listing prior to displaying content
210 %s Insert content subtype
211 %d Insert content description
212 %% Insert the character %
216 For those display strings containing the e- or F-escape,
219 execute at most one of these at any given time. Although the F-escape
220 expands to be the filename containing the content, the e-escape has no
221 expansion as far as the shell is concerned.
225 is display a content, typing QUIT (usually
226 control-\\) will tell
228 to wrap things up immediately.
230 Note that if the content being displayed is multipart, but not one of
231 the subtypes listed above, then the f- and F-escapes expand to multiple
232 filenames, one for each subordinate content. Further, stdin is not
233 redirected from the terminal to the content.
235 If a display string is not found,
237 has the following default values:
241 mhshow-show-text/plain: %l<defaultpager> '%F'
242 mhshow-show-message/rfc822: %lshow \-file '%F'
246 If a subtype of type text doesn't have a profile entry, it will be
247 treated as text/plain.
250 has default methods for handling multipart messages of subtype
251 mixed, alternative, parallel, and digest. Any unknown subtype of type
252 multipart (without a profile entry), will be treated as multipart/mixed.
254 If none of these apply, then
258 Example entries might be:
262 mhshow-show-audio/basic: raw2audio 2>/dev/null | play
263 mhshow-show-image: xv '%f'
264 mhshow-show-application/PostScript: lpr -Pps
268 Note that when using the f- or F-escape, it's a good idea to use
269 single-quotes around the escape. This prevents misinterpretation by
270 the shell of any funny characters that might be present in the filename.
274 will process each message serially \- it won't start
275 showing the next message until all the commands executed to display the
276 current message have terminated. In the case of a multipart content
277 (of any subtype listed above), the content contains advice indicating if
278 the parts should be displayed serially or in parallel. Because this may
279 cause confusion, particularly on uni-window displays,
281 will never display parts in parallel.
282 .SS "Showing Alternate Character Sets"
283 Because a content of type text might be in a non-ASCII character
286 encounters a \*(lqcharset\*(rq parameter for
287 this content, it checks if your terminal can display this character
290 checks this by examining the the environment
293 If the value of this environment variable is equal
294 to the value of the charset parameter, then
297 display this content without any additional setup. If this environment
300 will assume a value of \*(lqUS-ASCII\*(rq.
301 If the character set cannot be displayed natively, then
303 will look for an entry of the form:
306 mhshow-charset-<charset>
309 which should contain a command creating an environment to render
310 the character set. This command string should containing a single
311 \*(lq%s\*(rq, which will be filled-in with the command to display the
314 Example entries might be:
317 mhshow-charset-iso-8859-1: xterm -fn '-*-*-medium-r-normal-*-*-120-*-*-c-*-iso8859-*' -e %s
323 mhshow-charset-iso-8859-1: '%s'
326 The first example tells
331 appropriate character set for that message content. The second example
334 that your pager (or other program handling that content
335 type) can handle that character set, and that no special processing is
338 Note that many pagers strip off the high-order bit or have problems
339 displaying text with the high-order bit set. However, the pager
341 has support for single-octet character sets. The source
344 is available on many ftp sites carrying free software.
345 In order to view messages sent in the ISO-8859-1 character set using
348 put these lines in your
354 setenv LESSCHARSET latin1
361 to use the ISO-8859-1 definition for
362 determining whether a character is \*(lqnormal\*(rq, \*(lqcontrol\*(lq,
363 or \*(lqbinary\*(rq. The second line tells
366 if it encounters a file that has non-ASCII characters. Then,
372 called automatically. (To handle other single-octet character sets,
375 manual entry for information about the
377 environment variable.)
378 .SS "Messages of Type message/partial"
380 cannot directly display messages of type partial.
381 You must reassemble them first into a normal message using
383 Check the man page for
386 .SS "External Access"
388 does not automatically retrieve message/external-body parts (anymore),
389 but prints the relevant information to enable the user to retrieve
391 .SS "User Environment"
392 Because the display environment in which
394 operates may vary for
397 will look for the environment variable
399 If present, this specifies the name of an additional
400 user profile which should be read. Hence, when a user logs in on a
401 particular display device, this environment variable should be set to
402 refer to a file containing definitions useful for the given display device.
403 Normally, only entries that deal with the methods to display different
404 content type and subtypes
408 mhshow-show-<type>/<subtype>
413 need be present in this additional profile. Finally,
415 will attempt to consult one other additional user profile,
419 %etcdir%/mhn.defaults
422 which is created automatically during
429 .ta \w'%etcdir%/ExtraBigFileName 'u
430 ^$HOME/.mmh/profile~^The user profile
431 ^$MHSHOW~^Additional profile entries
432 ^%etcdir%/mhn.defaults~^System default MIME profile entries
433 ^%etcdir%/mhl.headers~^The headers template
436 .SH "PROFILE COMPONENTS"
440 .ta \w'ExtraBigProfileName 'u
441 ^Path:~^To determine the user's mail storage
442 ^Current\-Folder:~^To find the default current folder
443 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
444 ^mhshow-charset-<charset>~^Template for environment to render character sets
445 ^mhshow-show-<type>*~^Template for displaying contents
446 ^Pager:~^Default program to display text/plain content
450 mhbuild(1), mhl(1), mhlist(1), mhstore(1), sendfiles(1)
454 .RB ` +folder "' defaults to the current folder"
455 .RB ` msgs "' defaults to cur"
456 .RB ` \-form \ mhl.headers'
461 If a folder is given, it will become the current folder. The last
462 message selected will become the current message.