.B scan
.RI [ +folder ]
.RI [ msgs ]
-.RB [ \-clear " | " \-noclear ]
.RB [ \-form
.IR formatfile ]
.RB [ \-width
may be used to specify the width of
the scan line. The default is to use the width of the terminal.
.PP
-If the
-.B \-clear
-switch is used and
-.BR scan 's
-output is directed
-to a terminal, then
-.B scan
-will consult the environment variables
-.B $TERM
-and
-.B $TERMCAP
-to determine your terminal type in order
-to find out how to clear the screen prior to exiting. If the
-.B \-clear
-switch is used and
-.BR scan 's
-output is not directed to a terminal
-(e.g., a pipe or a file), then
-.B scan
-will send a formfeed prior
-to exiting.
-.PP
-For example, the command:
+The command:
.PP
.RS 5
-(scan \-clear ; show all \-show pr \-f) | lpr
+(scan | pr ; show a \-showproc pr) | lpr
.RE
.PP
-produces a scan listing of the current folder, followed by a formfeed,
+produces a scan listing of the current folder,
followed by a formatted listing of all messages in the folder, one
per page. Omitting
-.RB \*(lq "\-show\ pr\ \-f" \*(rq
+.RB \*(lq "\-showproc\ pr" \*(rq
will cause the messages to be
concatenated, separated by a one\-line header and two blank lines.
.PP
.RS 5
.nf
.ta \w'Dtimenow 'u +\w'Returns 'u
-.I Escape Returns Description
+.I "Escape Returns Description
dtimenow date the current date
folder string the name of the current folder
.fi
If a folder is given, it will become the current folder.
.SH BUGS
-The argument to the
-.B \-form
-switch must be interpreted as a single
-token by the shell that invokes
-.BR scan .
-Therefore, one must usually
-place the argument to this switch inside double\-quotes.
-.PP
The value of each
.I component
escape is set by