![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to show.me CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh|
Return to show.me CVS log | Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh |
1.1 root 1: .\" This file is automatically generated. Do not edit!
2: .SC SHOW 1
3: .NA
4: show \- show (list) messages
5: .SY
6: show
7: \%[+folder] \%[msgs]
8: \%[\-draft]
9: \%[\-header] \%[\-noheader]
10: \%[\-showproc\ program] \%[\-noshowproc]
11: \%[switches\ for\ \fIshowproc\fR]
12: \%[\-help]
13: .DE
14: \fIShow\fR lists each of the specified messages to the standard
15: output (typically, the terminal).
16: Typically, the messages are listed exactly
17: as they are, with no reformatting.
18: A program named by the \fIshowproc\fR profile component is
19: invoked to do the listing, and any switches not recognized by
20: \fIshow\fR are passed along to that program.
21: The default program is known as \fImore\fR\0(1).
22: To override the default and the \fIshowproc\fR profile component,
23: use the `\-showproc\ program' switch.
24: For example, `\-show\ pr' will cause the \fIpr\fR\0(1) program to list the
25: messages.
26: The \fIMH\fR command \fImhl\fR can be used as a \fIshowproc\fR
27: to show messages in a more uniform format.
28: Normally, this program is specified as the \fIshowproc\fR is the user's
29: \&.mh\(ruprofile.
30: See \fImhl\fR\0(1) for the details.
31: If the `\-noshowproc' option is specified,
32: `/bin/cat' is used instead of \fIshowproc\fR.
33:
34: The `\-header' switch tells \fIshow\fR to display a one\-line
35: description of the message being shown.
36: This description includes the folder and the message number.
37:
38: If no `msgs' are specified, the current message is used.
39: If more than one message is specified,
40: \fImore\fR will prompt for a <RETURN> prior to listing each message.
41: \fImore\fR will list each message, a page at a time.
42: When the end of
43: page is reached, \fImore\fR will ring the bell and wait for a <SPACE>
44: or <RETURN>.
45: If a <RETURN> is entered, \fImore\fR will print the next line,
46: whereas <SPACE> will print the next screenful.
47: To exit \fImore\fR, type \*(lqq\*(rq.
48:
49: If the standard output is not a terminal, no queries are made,
50: and each file is listed with a one\-line header and two lines of
51: separation.
52:
53: \*(lqshow \-draft\*(rq will list the file <mh\-dir>/draft if it
54: exists.
55:
56: If the profile entry \*(lqUnseen\-Sequence\*(rq is present and non\-empty,
57: then \fIshow\fR will remove each of the messages shown from each
58: sequence named by the profile entry.
59: This is similar to the \*(lqPrevious\-Sequence\*(rq profile entry supported
60: by all \fIMH\fR commands which take `msgs' or `msg' arguments.
61: .Fi
62: ^$HOME/\&.mh\(ruprofile~^The user profile
63: .Pr
64: ^Path:~^To determine the user's MH directory
65: .Ps
66: ^Current\-Folder:~^To find the default current folder
67: .Ps
68: ^Unseen\-Sequence:~^To name sequences denoting unseen messages
69: .Ps
70: ^showproc:~^Program to show messages
71: .Sa
72: mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
73: .De
74: `+folder' defaults to the current folder
75: .Ds
76: `msgs' defaults to cur
77: .Ds
78: `\-format'
79: .Ds
80: `\-header'
81: .Co
82: If a folder is given, it will become the current folder.
83: The last message shown will become the current message.
84: .Bu
85: The `\-header' switch doesn't work when `msgs' expands to more than
86: one message.
87: If the \fIshowproc\fR is \fImhl\fR,
88: then is problem can be circumvented by referencing
89: the \*(lqmessagename\*(rq field in the \fImhl\fR format file.
90:
91: \fIShow\fR updates the user's context before showing the message.
92: Hence if \fIshow\fR will mark messages as seen prior to the user
93: actually seeing them.
94: This is generally not a problem,
95: unless the user relies on the \*(lqunseen\*(rq messages mechanism,
96: and interrupts \fIshow\fR while it is showing \*(lqunseen\*(rq messages.
97:
98: If \fIshowproc\fR is \fImhl\fR,
99: then \fIshow\fR uses a built\-in \fImhl\fR:
100: it does not actually run the \fImhl\fR program.
101: Hence, if you define your own \fIshowproc\fR,
102: don't call it \fImhl\fR since \fIshow\fR won't run it.
103:
104: If \fImore\fR\0(1) is your showproc (the default),
105: then avoid running \fIshow\fR in the background
106: with only its standard output piped to another process, as in
107:
108: .ti +.5i
109: show | imprint &
110:
111: Due to a bug in \fImore\fR,
112: show will go into a \*(lqtty input\*(rq state.
113: To avoid this problem,
114: re\-direct \fIshow\fR's diagnostic output as well.
115: For users of \fIcsh\fR:
116:
117: .ti +.5i
118: show |& imprint &
119:
120: For users of \fIsh\fR:
121:
122: .ti +.5i
123: show 2>&1 | imprint &
124: .En
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.