4.3BSD-UWisc/man/catl/show.l
SHOW(1) UNIX Programmer's Manual SHOW(1)
NAME
show - show (list) messages
SYNOPSIS
show [+folder] [msgs] [-draft] [-header] [-noheader]
[-showproc program] [-noshowproc]
[switches for _s_h_o_w_p_r_o_c] [-help]
9 _S_h_o_w lists each of the specified messages to the standard
output (typically, the terminal). Typically, the messages
are listed exactly as they are, with no reformatting. A
program named by the _s_h_o_w_p_r_o_c profile component is invoked
to do the listing, and any switches not recognized by _s_h_o_w
are passed along to that program. The default program is
known as _m_o_r_e (1). To override the default and the _s_h_o_w_p_r_o_c
profile component, use the `-showproc program' switch. For
example, `-show pr' will cause the _p_r (1) program to list
the messages. The _M_H command _m_h_l can be used as a _s_h_o_w_p_r_o_c
to show messages in a more uniform format. Normally, this
program is specified as the _s_h_o_w_p_r_o_c is the user's
.mh_profile. See _m_h_l (1) for the details. If the
`-noshowproc' option is specified, `/bin/cat' is used
instead of _s_h_o_w_p_r_o_c.
The `-header' switch tells _s_h_o_w 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. If
more than one message is specified, _m_o_r_e will prompt for a
<RETURN> prior to listing each message. _m_o_r_e will list each
message, a page at a time. When the end of page is reached,
_m_o_r_e will ring the bell and wait for a <SPACE> or <RETURN>.
If a <RETURN> is entered, _m_o_r_e will print the next line,
whereas <SPACE> will print the next screenful. To exit
_m_o_r_e, type "q".
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 _s_h_o_w will remove each of the messages shown
from each sequence named by the profile entry. This is
similar to the "Previous-Sequence" profile entry supported
by all _M_H commands which take `msgs' or `msg' arguments.
FILES
$HOME/.mh_profile The user profile
9
Printed 1/10/87 MH 1
SHOW(1) UNIX Programmer's Manual SHOW(1)
PROFILE COMPONENTS
Path: To determine the user's MH directory
Current-Folder: To find the default current folder
Unseen-Sequence: To name sequences denoting unseen messages
showproc: Program to show messages
SEE ALSO
mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
DEFAULTS
`+folder' defaults to the current folder
`msgs' defaults to cur
`-format'
`-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 _s_h_o_w_p_r_o_c is _m_h_l, then is
problem can be circumvented by referencing the "messagename"
field in the _m_h_l format file.
_S_h_o_w updates the user's context before showing the message.
Hence if _s_h_o_w 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 _s_h_o_w while it is showing "unseen" messages.
If _s_h_o_w_p_r_o_c is _m_h_l, then _s_h_o_w uses a built-in _m_h_l: it does
not actually run the _m_h_l program. Hence, if you define your
own _s_h_o_w_p_r_o_c, don't call it _m_h_l since _s_h_o_w won't run it.
If _m_o_r_e (1) is your showproc (the default), then avoid run-
ning _s_h_o_w in the background with only its standard output
piped to another process, as in
show | imprint &
Due to a bug in _m_o_r_e, show will go into a "tty input" state.
To avoid this problem, re-direct _s_h_o_w's diagnostic output as
well. For users of _c_s_h:
show |& imprint &
For users of _s_h:
show 2>&1 | imprint &
Printed 1/10/87 MH 2