SHOW(1) [nmh-1.0.4] (MH.6.8) SHOW(1)
NAME
show - show (display) messages
SYNOPSIS
show [+folder] [msgs] [-showproc program]
[-showmimeproc program] [-header] [-noheader]
[-draft] [-checkmime] [-nocheckmime]
[switches for showproc or showmimeproc]
[-version] [-help]
DESCRIPTION
Show lists each of the specified messages to the standard
output (typically, the terminal).
By default, text (non-MIME) messages are filtered and
displayed by the nmh command mhl. This command will display
text messages in a nice, uniform format. It also allows you
to configure the format of the displayed messages and which
headers fields are shown. See the mhl(1) manual page for
the details about this command. This default can be changed
by defining the showproc profile component. Any switches
not recognized by show are passed along to that program. To
override the default and the showproc profile component, use
the `-showproc program' switch. For example,
`-showproc more' will cause the more(1) program to list the
messages with no reformatting. Normally, this program is
specified as the showproc in the user's .mh_profile, rather
than using a command line switch.
By default, non-text messages (MIME messages with multi-
media contents) are processed and displayed by the nmh
command mhshow. See the mhshow(1) manual page for details
about this command. This default can changed by defining
the showmimeproc profile component. Any switches not
recognized by show are passed along to that program. To
override this default and the showmimeproc profile
component, use the `-showmimeproc program' switch.
Note that in some cases, show may invoke the showmimeproc
even for textual contents. This will happen for text
messages that specify a transfer encoding (such as MIME
quoted-printable or base64) or specify a character set that
show doesn't believe can be displayed natively. The
environment variable MM_CHARSET should be set to the
terminal's native character set to avoid gratuitous
invocations of the showmimeproc. See the mh-profile(5) man
page for details about this environment variable.
The option `-checkmime' (set by default) instructs show to
test if any of the messages to be displayed are non-text
(MIME) messages. If any are non-text, they are displayed by
the program showmimeproc, else they are displayed by the
Page 1 (printed 2/1/01)
SHOW(1) [nmh-1.0.4] (MH.6.8) SHOW(1)
program showproc. The option `-nocheckmime' disables this
test and instructs show to use showproc, regardless of
whether any of the messages are non-text (MIME) messages.
The `-noshowproc' switch will disable any formatting or
paging of messages. It is equivalent to `-nocheckmime -
showproc cat'. It is still accepted, but should be
considered (somewhat) obsolete.
If the environment variable NOMHNPROC is set, the test for
non-text (MIME) messages will be disabled. This method is
obsolete. Use the `-nocheckmime' switch instead.
The `-header' switch tells show to display a one-line
description of the message being shown. This description
includes the folder and the message number.
If no `msgs' are specified, the current message is used.
Although it depends on the specific showproc or
showmimeproc, in the default setup when more than one
message is specified, you will be prompted for a <RETURN>
prior to listing each message. Each message will be listed
a page at a time, and when the end of page is reached, the
program will wait for a <SPACE> or <RETURN>. If a <RETURN>
is entered, it will print the next line, whereas <SPACE>
will print the next screenful.
If the standard output is not a terminal, no queries are
made, and each file is listed with a one-line header and two
lines of separation.
show-draft will list the file <mh-dir>/draft if it exists.
If the profile entry Unseen-Sequence is present and
non-empty, then show will remove each of the messages shown
from each sequence named by the profile entry.
FILES
$HOME/.mh_profile The user profile
PROFILE COMPONENTS
Path: To determine the user's nmh directory
Current-Folder: To find the default current folder
Unseen-Sequence: To name sequences denoting unseen messages
showproc: Program to show text (non-MIME) messages
showmimeproc: Program to show non-text (MIME) messages
SEE ALSO
mhl(1), mhshow(1), more(1), next(1), prev(1), scan(1)
DEFAULTS
`+folder' defaults to the current folder
Page 2 (printed 2/1/01)
SHOW(1) [nmh-1.0.4] (MH.6.8) SHOW(1)
`msgs' defaults to cur
`-checkmime'
`-header'
CONTEXT
If a folder is given, it will become the current folder.
The last message shown will become the current message.
BUGS
The `-header' switch doesn't work when `msgs' expands to
more than one message. If the showproc is mhl, then is
problem can be circumvented by referencing the messagename
field in the mhl format file.
Show updates the user's context before showing the message.
Hence show will mark messages as seen prior to the user
actually seeing them. This is generally not a problem,
unless the user relies on the unseen messages mechanism, and
interrupts show while it is showing unseen messages.
If your showproc is mhl (the default), then show uses a
built-in mhl: it does not actually run the mhl program.
Hence, if you define your own showproc, don't call it mhl
since show won't run it.
If your showproc is the pager more, then avoid running show
in the background with only its standard output piped to
another process, as in
show | imprint &
Due to a bug in more, show will go into a tty input state.
To avoid this problem, re-direct show's diagnostic output as
well. For users of csh:
show |& imprint &
For users of sh:
show 2>&1 | imprint &
Page 3 (printed 2/1/01)
