5 .TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 show \- show (display) messages
19 .RB [ \-header " | " \-noheader ]
20 .RB [ \-checkmime " | " \-nocheckmime ]
30 lists each of the specified messages to the standard output
31 (typically, the terminal).
33 By default, text (non-MIME) messages are filtered and displayed by
38 This command will display text
39 messages in a nice, uniform format. It also allows you to configure
40 the format of the displayed messages and which headers fields are
43 manual page for the details about this
44 command. This default can be changed by defining the
46 profile component. Any switches not recognized by
49 passed along to that program. To override the default and the
51 profile component, use the
59 program to list the messages with no reformatting. Normally, this
60 program is specified as the
63 .IR \&.mh\(ruprofile ,
64 rather than using a command line switch.
66 By default, non-text messages (MIME messages with multi-media
67 contents) are processed and displayed by the
73 manual page for details
74 about this command. This default can changed by defining the
76 profile component. Any switches not recognized
79 are passed along to that program. To override this
82 profile component, use the
87 Note that in some cases,
91 even for textual contents. This will happen for text messages that
92 specify a transfer encoding (such as MIME quoted-printable or
93 base64) or specify a character set that
96 can be displayed natively. The environment variable
98 should be set to the terminal's native character set to avoid
99 gratuitous invocations of the
103 man page for details about this environment variable.
107 (set by default) instructs
110 test if any of the messages to be displayed are non-text (MIME)
111 messages. If any are non-text, they are displayed by the program
113 else they are displayed by the program
117 disables this test and instructs
121 regardless of whether
122 any of the messages are non-text (MIME) messages.
126 switch will disable any formatting or paging of
127 messages. It is equivalent to
131 It is still accepted, but should be considered (somewhat) obsolete.
133 If the environment variable
136 non-text (MIME) messages will be disabled. This method is obsolete.
145 to display a one\-line
146 description of the message being shown. This description includes
147 the folder and the message number.
149 If no `msgs' are specified, the current message is used. Although
150 it depends on the specific
154 in the default setup when more than one message is specified, you
155 will be prompted for a <RETURN> prior to listing each message.
156 Each message will be listed a page at a time, and when the end of
157 page is reached, the program will wait for a <SPACE> or <RETURN>.
158 If a <RETURN> is entered, it will print the next line, whereas
159 <SPACE> will print the next screenful.
161 If the standard output is not a terminal, no queries are made, and
162 each file is listed with a one\-line header and two lines of
165 .RB \*(lq "show \-draft" \*(rq
166 will list the file <mh\-dir>/draft if it
169 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
172 will remove each of the messages shown
173 from each sequence named by the profile entry.
178 .ta \w'%etcdir%/ExtraBigFileName 'u
179 ^$HOME/\&.mh\(ruprofile~^The user profile
182 .SH "PROFILE COMPONENTS"
186 .ta \w'ExtraBigProfileName 'u
187 ^Path:~^To determine the user's nmh directory
188 ^Current\-Folder:~^To find the default current folder
189 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
190 ^showproc:~^Program to show text (non-MIME) messages
191 ^showmimeproc:~^Program to show non-text (MIME) messages
195 mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
199 .RB ` +folder "' defaults to the current folder"
200 .RB ` msgs "' defaults to cur"
206 If a folder is given, it will become the current folder. The last
207 message shown will become the current message.
212 switch doesn't work when `msgs' expands to more than
217 then this problem can
218 be circumvented by referencing the \*(lqmessagename\*(rq field in the
223 updates the user's context before showing the message.
226 will mark messages as seen prior to the user actually
227 seeing them. This is generally not a problem, unless the user relies
228 on the \*(lqunseen\*(rq messages mechanism, and interrupts
230 while it is showing \*(lqunseen\*(rq messages.
241 it does not actually run the
244 Hence, if you define your own
258 in the background with only its standard output piped to
259 another process, as in
267 show will go into a \*(lqtty input\*(rq state.
268 To avoid this problem, re\-direct
270 diagnostic output as well.
282 show 2>&1 | imprint &