4 .TH SHOW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 show \- show (display) messages
17 .RB [ \-header " | " \-noheader ]
18 .RB [ \-checkmime " | " \-nocheckmime ]
28 lists each of the specified messages to the standard output
29 (typically, the terminal).
31 By default, text (non-MIME) messages are filtered and displayed by
36 This command will display text
37 messages in a nice, uniform format. It also allows you to configure
38 the format of the displayed messages and which headers fields are
41 manual page for the details about this
42 command. This default can be changed by defining the
44 profile component. Any switches not recognized by
47 passed along to that program. To override the default and the
49 profile component, use the
57 program to list the messages with no reformatting. Normally, this
58 program is specified as the
61 .IR \&.mh\(ruprofile ,
62 rather than using a command line switch.
64 By default, non-text messages (MIME messages with multi-media
65 contents) are processed and displayed by the
71 manual page for details
72 about this command. This default can changed by defining the
74 profile component. Any switches not recognized
77 are passed along to that program. To override this
80 profile component, use the
85 Note that in some cases,
89 even for textual contents. This will happen for text messages that
90 specify a transfer encoding (such as MIME quoted-printable or
91 base64) or specify a character set that
94 can be displayed natively. The environment variable
96 should be set to the terminal's native character set to avoid
97 gratuitous invocations of the
101 man page for details about this environment variable.
105 (set by default) instructs
108 test if any of the messages to be displayed are non-text (MIME)
109 messages. If any are non-text, they are displayed by the program
111 else they are displayed by the program
115 disables this test and instructs
119 regardless of whether
120 any of the messages are non-text (MIME) messages.
124 switch will disable any formatting or paging of
125 messages. It is equivalent to
129 It is still accepted, but should be considered (somewhat) obsolete.
131 If the environment variable
134 non-text (MIME) messages will be disabled. This method is obsolete.
143 to display a one\-line
144 description of the message being shown. This description includes
145 the folder and the message number.
147 If no `msgs' are specified, the current message is used. Although
148 it depends on the specific
152 in the default setup when more than one message is specified, you
153 will be prompted for a <RETURN> prior to listing each message.
154 Each message will be listed a page at a time, and when the end of
155 page is reached, the program will wait for a <SPACE> or <RETURN>.
156 If a <RETURN> is entered, it will print the next line, whereas
157 <SPACE> will print the next screenful.
159 If the standard output is not a terminal, no queries are made, and
160 each file is listed with a one\-line header and two lines of
163 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
166 will remove each of the messages shown
167 from each sequence named by the profile entry.
172 .ta \w'%etcdir%/ExtraBigFileName 'u
173 ^$HOME/\&.mh\(ruprofile~^The user profile
176 .SH "PROFILE COMPONENTS"
180 .ta \w'ExtraBigProfileName 'u
181 ^Path:~^To determine the user's nmh directory
182 ^Current\-Folder:~^To find the default current folder
183 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
184 ^showproc:~^Program to show text (non-MIME) messages
185 ^showmimeproc:~^Program to show non-text (MIME) messages
189 mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
193 .RB ` +folder "' defaults to the current folder"
194 .RB ` msgs "' defaults to cur"
200 If a folder is given, it will become the current folder. The last
201 message shown will become the current message.
206 switch doesn't work when `msgs' expands to more than
211 then this problem can
212 be circumvented by referencing the \*(lqmessagename\*(rq field in the
217 updates the user's context before showing the message.
220 will mark messages as seen prior to the user actually
221 seeing them. This is generally not a problem, unless the user relies
222 on the \*(lqunseen\*(rq messages mechanism, and interrupts
224 while it is showing \*(lqunseen\*(rq messages.
235 it does not actually run the
238 Hence, if you define your own
252 in the background with only its standard output piped to
253 another process, as in
261 show will go into a \*(lqtty input\*(rq state.
262 To avoid this problem, re\-direct
264 diagnostic output as well.
276 show 2>&1 | imprint &