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. Any switches not recognized by
45 passed along to that program. To override the default, use the
53 program to list the messages with no reformatting.
55 By default, non-text messages (MIME messages with multi-media
56 contents) are processed and displayed by the
62 manual page for details
64 Any switches not recognized
67 are passed along to that program. To override this
73 Note that in some cases,
77 even for textual contents. This will happen for text messages that
78 specify a transfer encoding (such as MIME quoted-printable or
79 base64) or specify a character set that
82 can be displayed natively. The environment variable
84 should be set to the terminal's native character set to avoid
85 gratuitous invocations of the
89 man page for details about this environment variable.
93 (set by default) instructs
96 test if any of the messages to be displayed are non-text (MIME)
97 messages. If any are non-text, they are displayed by the
99 else they are displayed by the
103 disables this test and instructs
107 regardless of whether
108 any of the messages are non-text (MIME) messages.
114 to display a one\-line
115 description of the message being shown. This description includes
116 the folder and the message number.
118 If no `msgs' are specified, the current message is used. Although
119 it depends on the specific
123 in the default setup when more than one message is specified, you
124 will be prompted for a <RETURN> prior to listing each message.
125 Each message will be listed a page at a time, and when the end of
126 page is reached, the program will wait for a <SPACE> or <RETURN>.
127 If a <RETURN> is entered, it will print the next line, whereas
128 <SPACE> will print the next screenful.
130 If the standard output is not a terminal, no queries are made, and
131 each file is listed with a one\-line header and two lines of
134 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and
137 will remove each of the messages shown
138 from each sequence named by the profile entry.
143 .ta \w'%etcdir%/ExtraBigFileName 'u
144 ^$HOME/.mmh/profile~^The user profile
147 .SH "PROFILE COMPONENTS"
151 .ta \w'ExtraBigProfileName 'u
152 ^Path:~^To determine the user's mail storage
153 ^Current\-Folder:~^To find the default current folder
154 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
158 mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
162 .RB ` +folder "' defaults to the current folder"
163 .RB ` msgs "' defaults to cur"
169 If a folder is given, it will become the current folder. The last
170 message shown will become the current message.
175 switch doesn't work when `msgs' expands to more than
180 then this problem can
181 be circumvented by referencing the \*(lqmessagename\*(rq field in the
186 updates the user's context before showing the message.
189 will mark messages as seen prior to the user actually
190 seeing them. This is generally not a problem, unless the user relies
191 on the \*(lqunseen\*(rq messages mechanism, and interrupts
193 while it is showing \*(lqunseen\*(rq messages.
201 in the background with only its standard output piped to
202 another process, as in
210 show will go into a \*(lqtty input\*(rq state.
211 To avoid this problem, re\-direct
213 diagnostic output as well.
225 show 2>&1 | imprint &