1SHOW(1) [nmh-1.3] SHOW(1)
2
6 show - show (display) messages
7
9 show [+folder] [msgs] [-draft] [-showproc program] [-showmimeproc pro‐
10 gram] [-header | -noheader] [-checkmime | -nocheckmime]
11 [switches for showproc or showmimeproc] [-version] [-help]
12
14 Show lists each of the specified messages to the standard output (typi‐
15 cally, the terminal).
16 By default, text (non-MIME) messages are filtered and displayed by the
18 nmh command mhl. This command will display text messages in a nice,
19 uniform format. It also allows you to configure the format of the dis‐
20 played messages and which headers fields are shown. See the mhl(1)
21 manual page for the details about this command. This default can be
22 changed by defining the showproc profile component. Any switches not
23 recognized by show are passed along to that program. To override the
24 default and the showproc profile component, use the -showproc program
25 switch. For example, -showproc more will cause the more program to
26 list the messages with no reformatting. Normally, this program is
27 specified as the showproc in the user's .mh_profile, rather than using
28 a command line switch.
29 By default, non-text messages (MIME messages with multi-media contents)
31 are processed and displayed by the nmh command mhshow. See the
32 mhshow(1) manual page for details about this command. This default can
33 changed by defining the showmimeproc profile component. Any switches
34 not recognized by show are passed along to that program. To override
35 this default and the showmimeproc profile component, use the -showmime‐
36 proc program switch.
37 Note that in some cases, show may invoke the showmimeproc even for tex‐
39 tual contents. This will happen for text messages that specify a
40 transfer encoding (such as MIME quoted-printable or base64) or specify
41 a character set that show doesn't believe can be displayed natively.
42 The environment variable $MM_CHARSET should be set to the terminal's
43 native character set to avoid gratuitous invocations of the showmime‐
44 proc. See the mh-profile(5) man page for details about this environ‐
45 ment variable.
46 The option -checkmime (set by default) instructs show to test if any of
48 the messages to be displayed are non-text (MIME) messages. If any are
49 non-text, they are displayed by the program showmimeproc, else they are
50 displayed by the program showproc. The option -nocheckmime disables
51 this test and instructs show to use showproc, regardless of whether any
52 of the messages are non-text (MIME) messages.
53 The -noshowproc switch will disable any formatting or paging of mes‐
55 sages. It is equivalent to -nocheckmime -showproc cat. It is still
56 accepted, but should be considered (somewhat) obsolete.
57 If the environment variable $NOMHNPROC is set, the test for non-text
59 (MIME) messages will be disabled. This method is obsolete. Use the
60 -nocheckmime switch instead.
61 The -header switch tells show to display a one-line description of the
63 message being shown. This description includes the folder and the mes‐
64 sage number.
65 If no `msgs' are specified, the current message is used. Although it
67 depends on the specific showproc or showmimeproc, in the default setup
68 when more than one message is specified, you will be prompted for a
69 <RETURN> prior to listing each message. Each message will be listed a
70 page at a time, and when the end of page is reached, the program will
71 wait for a <SPACE> or <RETURN>. If a <RETURN> is entered, it will
72 print the next line, whereas <SPACE> will print the next screenful.
73 If the standard output is not a terminal, no queries are made, and each
75 file is listed with a one-line header and two lines of separation.
76 “show -draft” will list the file <mh-dir>/draft if it exists.
78 If the profile entry “Unseen-Sequence” is present and non-empty, then
80 show will remove each of the messages shown from each sequence named by
81 the profile entry.
82
85 $HOME/.mh_profile The user profile
86
89 Path: To determine the user's nmh directory
90 Current-Folder: To find the default current folder
91 Unseen-Sequence: To name sequences denoting unseen messages
92 showproc: Program to show text (non-MIME) messages
93 showmimeproc: Program to show non-text (MIME) messages
94
97 mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
98
101 `+folder' defaults to the current folder
102 `msgs' defaults to cur
103 `-checkmime'
104 `-header'
105
108 If a folder is given, it will become the current folder. The last mes‐
109 sage shown will become the current message.
110
113 The -header switch doesn't work when `msgs' expands to more than one
114 message. If the showproc is mhl, then this problem can be circumvented
115 by referencing the “messagename” field in the mhl format file.
116 Show updates the user's context before showing the message. Hence show
118 will mark messages as seen prior to the user actually seeing them.
119 This is generally not a problem, unless the user relies on the “unseen”
120 messages mechanism, and interrupts show while it is showing “unseen”
121 messages.
122 If your showproc is mhl (the default), then show uses a built-in mhl:
124 it does not actually run the mhl program. Hence, if you define your
125 own showproc , don't call it mhl since show won't run it.
126 If your showproc is the pager more, then avoid running show in the
128 background with only its standard output piped to another process, as
129 in
130 show | imprint &
132 Due to a bug in more, show will go into a “tty input” state. To avoid
134 this problem, re-direct show's diagnostic output as well. For users of
135 csh:
136 show |& imprint &
138 For users of sh:
140 show 2>&1 | imprint &
142MH.6.8 1 June 2008 SHOW(1)