8 date 95.12.06.22.48.30; author jromine; state Exp;
13 date 93.10.26.20.09.07; author jromine; state Exp;
18 date 92.05.19.21.57.39; author jromine; state Exp;
23 date 92.01.31.16.41.16; author jromine; state Exp;
28 date 90.04.05.15.15.20; author sources; state Exp;
33 date 90.03.22.11.31.52; author sources; state Exp;
38 date 90.03.20.19.42.35; author sources; state Exp;
43 date 90.03.20.17.36.49; author sources; state Exp;
48 date 90.03.20.17.21.30; author sources; state Exp;
59 @fixup some envar references
63 .\" @@(#)$Id: show.rf,v 1.8 1993/10/26 20:09:07 jromine Exp jromine $
66 show \- show (list) messages
71 \%[\-header] \%[\-noheader]
72 \%[\-showproc\ program] \%[\-noshowproc]
73 \%[switches\ for\ \fIshowproc\fR]
76 \fIShow\fR lists each of the specified messages to the standard
77 output (typically, the terminal).
78 Typically, the messages are listed exactly
79 as they are, with no reformatting.
80 A program named by the \fIshowproc\fR profile component is
81 invoked to do the listing, and any switches not recognized by
82 \fIshow\fR are passed along to that program.
83 The default program is known as \fImore\fR\0(1).
84 To override the default and the \fIshowproc\fR profile component,
85 use the `\-showproc\ program' switch.
86 For example, `\-show\ pr' will cause the \fIpr\fR\0(1) program to list the
88 The \fIMH\fR command \fImhl\fR can be used as a \fIshowproc\fR
89 to show messages in a more uniform format.
90 Normally, this program is specified as the \fIshowproc\fR is the user's
92 See \fImhl\fR\0(1) for the details.
93 If the `\-noshowproc' option is specified,
94 `/bin/cat' is used instead of \fIshowproc\fR.
97 If you have messages with multi-media contents,
98 the profile entry \fImhnproc\fR defines the name of a program to
99 manipulate multi-media messages.
100 (The \fImhn\fR\0(1) program,
101 which is suitable for this purpose,
103 If the `\-noshowproc' option is NOT specified,
104 and if one or more named messages has a multi-media content,
105 then the program indicated by \fImhnproc\fR will be run instead of
107 The use of the \fImhnproc\fR can also be disabled if the
108 environment variable \fBNOMHNPROC\fR is set.
109 Note that the \fImhnproc\fR may be invoked even for textual contents,
110 depending on the character set involved.
111 The environment variable \fBMM_CHARSET\fP should be set to the terminal's
112 character set to avoid gratuitous invocations of the \fImhnproc\fR.
115 The `\-header' switch tells \fIshow\fR to display a one\-line
116 description of the message being shown.
117 This description includes the folder and the message number.
119 If no `msgs' are specified, the current message is used.
120 If more than one message is specified,
121 \fImore\fR will prompt for a <RETURN> prior to listing each message.
122 \fImore\fR will list each message, a page at a time.
124 page is reached, \fImore\fR will ring the bell and wait for a <SPACE>
126 If a <RETURN> is entered, \fImore\fR will print the next line,
127 whereas <SPACE> will print the next screenful.
128 To exit \fImore\fR, type \*(lqq\*(rq.
130 If the standard output is not a terminal, no queries are made,
131 and each file is listed with a one\-line header and two lines of
134 \*(lqshow \-draft\*(rq will list the file <mh\-dir>/draft if it
137 If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
138 then \fIshow\fR will remove each of the messages shown from each
139 sequence named by the profile entry.
140 This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
141 by all \fIMH\fR commands which take `msgs' or `msg' arguments.
143 ^$HOME/\&.mh\(ruprofile~^The user profile
145 ^Path:~^To determine the user's MH directory
147 ^Current\-Folder:~^To find the default current folder
149 ^Unseen\-Sequence:~^To name sequences denoting unseen messages
151 ^showproc:~^Program to show messages
154 ^mhnproc:~^Program to show messages with multi-media content
157 mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
159 `+folder' defaults to the current folder
161 `msgs' defaults to cur
165 If a folder is given, it will become the current folder.
166 The last message shown will become the current message.
168 The `\-header' switch doesn't work when `msgs' expands to more than
170 If the \fIshowproc\fR is \fImhl\fR,
171 then is problem can be circumvented by referencing
172 the \*(lqmessagename\*(rq field in the \fImhl\fR format file.
174 \fIShow\fR updates the user's context before showing the message.
175 Hence \fIshow\fR will mark messages as seen prior to the user
176 actually seeing them.
177 This is generally not a problem,
178 unless the user relies on the \*(lqunseen\*(rq messages mechanism,
179 and interrupts \fIshow\fR while it is showing \*(lqunseen\*(rq messages.
181 If \fIshowproc\fR is \fImhl\fR,
182 then \fIshow\fR uses a built\-in \fImhl\fR:
183 it does not actually run the \fImhl\fR program.
184 Hence, if you define your own \fIshowproc\fR,
185 don't call it \fImhl\fR since \fIshow\fR won't run it.
187 If \fImore\fR\0(1) is your showproc (the default),
188 then avoid running \fIshow\fR in the background
189 with only its standard output piped to another process, as in
194 Due to a bug in \fImore\fR,
195 show will go into a \*(lqtty input\*(rq state.
196 To avoid this problem,
197 re\-direct \fIshow\fR's diagnostic output as well.
198 For users of \fIcsh\fR:
203 For users of \fIsh\fR:
206 show 2>&1 | imprint &
218 .\" @@(#)$Id: show.rf,v 1.7 1992/05/19 21:57:39 jromine Exp $
221 environment variable \fB$NOMHNPROC\fR is set.
224 The environment variable $MM_CHARSET should be set to the terminal's
235 .\" @@(#)$Id: show.rf,v 1.6 1992/01/31 16:41:16 jromine Exp jromine $
238 If you have messages with multi-media content,
239 you should define the profile entry \fImhnproc\fR,
240 which is the name of a program to manipulate multi-media messages.
241 The \fImhn\fR\0(1) program is suitable for this purpose.
242 Note that if the \fImhnproc\fR profile entry is defined,
243 the `\-noshowproc' option is NOT specified,
255 .\" @@(#)$Id: show.rf,v 1.5 90/04/05 15:15:20 sources Exp $
278 @put things back, do .NA stuff another way
292 .TH SHOW 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
302 @fixup for makewhatis