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