4 .TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 show \- show (display) messages
18 .RB [ \-header " | " \-noheader ]
19 .RB [ \-checkmime " | " \-nocheckmime ]
29 lists each of the specified messages to the standard output
30 (typically, the terminal).
32 By default, text (non-MIME) messages are filtered and displayed by
37 This command will display text
38 messages in a nice, uniform format. It also allows you to configure
39 the format of the displayed messages and which headers fields are
42 manual page for the details about this
43 command. This default can be changed by defining the
45 profile component. Any switches not recognized by
48 passed along to that program. To override the default and the
50 profile component, use the
58 program to list the messages with no reformatting. Normally, this
59 program is specified as the
62 .IR \&.mh\(ruprofile ,
63 rather than using a command line switch.
65 By default, non-text messages (MIME messages with multi-media
66 contents) are processed and displayed by the
72 manual page for details
73 about this command. This default can changed by defining the
75 profile component. Any switches not recognized
78 are passed along to that program. To override this
81 profile component, use the
86 Note that in some cases,
90 even for textual contents. This will happen for text messages that
91 specify a transfer encoding (such as MIME quoted-printable or
92 base64) or specify a character set that
95 can be displayed natively. The environment variable
97 should be set to the terminal's native character set to avoid
98 gratuitous invocations of the
102 man page for details about this environment variable.
106 (set by default) instructs
109 test if any of the messages to be displayed are non-text (MIME)
110 messages. If any are non-text, they are displayed by the program
112 else they are displayed by the program
116 disables this test and instructs
120 regardless of whether
121 any of the messages are non-text (MIME) messages.
125 switch will disable any formatting or paging of
126 messages. It is equivalent to
130 It is still accepted, but should be considered (somewhat) obsolete.
132 If the environment variable
135 non-text (MIME) messages will be disabled. This method is obsolete.
144 to display a one\-line
145 description of the message being shown. This description includes
146 the folder and the message number.
148 If no `msgs' are specified, the current message is used. Although
149 it depends on the specific
153 in the default setup when more than one message is specified, you
154 will be prompted for a <RETURN> prior to listing each message.
155 Each message will be listed a page at a time, and when the end of
156 page is reached, the program will wait for a <SPACE> or <RETURN>.
157 If a <RETURN> is entered, it will print the next line, whereas
158 <SPACE> will print the next screenful.
160 If the standard output is not a terminal, no queries are made, and
161 each file is listed with a one\-line header and two lines of
164 .RB \*(lq "show \-draft" \*(rq
165 will list the file <mh\-dir>/draft if it
168 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
171 will remove each of the messages shown
172 from each sequence named by the profile entry.
177 .ta \w'%etcdir%/ExtraBigFileName 'u
178 ^$HOME/\&.mh\(ruprofile~^The user profile
181 .SH "PROFILE COMPONENTS"
185 .ta \w'ExtraBigProfileName 'u
186 ^Path:~^To determine the user's nmh directory
187 ^Current\-Folder:~^To find the default current folder
188 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
189 ^showproc:~^Program to show text (non-MIME) messages
190 ^showmimeproc:~^Program to show non-text (MIME) messages
194 mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
198 .RB ` +folder "' defaults to the current folder"
199 .RB ` msgs "' defaults to cur"
205 If a folder is given, it will become the current folder. The last
206 message shown will become the current message.
211 switch doesn't work when `msgs' expands to more than
216 then this problem can
217 be circumvented by referencing the \*(lqmessagename\*(rq field in the
222 updates the user's context before showing the message.
225 will mark messages as seen prior to the user actually
226 seeing them. This is generally not a problem, unless the user relies
227 on the \*(lqunseen\*(rq messages mechanism, and interrupts
229 while it is showing \*(lqunseen\*(rq messages.
240 it does not actually run the
243 Hence, if you define your own
257 in the background with only its standard output piped to
258 another process, as in
266 show will go into a \*(lqtty input\*(rq state.
267 To avoid this problem, re\-direct
269 diagnostic output as well.
281 show 2>&1 | imprint &