LISt -- Type File on Video Screen
list [+cols__per__line] [-lines__per__screen] [file__list]

LIST writes a file, one screen at a time, on the user's terminal.  The argument
list may contain wildcard file specifiers.  The optional lines__per__screen may
be given to shorten the screen from its default of 24 lines. The optional
cols__per__line parameter may be given to change the screen from its default
width of 80 columns.  Setting cols____per____line to zero supresses line
wrap-around. 

Note that T works only on video terminals.  If no file__list is specified, T
prompts for each file.  If a file__list argument lacks an explicit extension,
".*" will be used; thus "LIST X" is equivalent to 

	"LIST X.*".

After each screen has been printed, T waits for the user to type a
single-letter command. Type HELP LIST COMMANDS for commands available.
See also HELP LIST LIMITATIONS and HELP LIST BUGS.
2 COMMANDS
Commands for LIST program are:

<Space> or
<Carriage-Return>	To get the next screen.
<Backspace> or
<Line-feed> or
'^' <Circumflex>	To back up one screen.
'P'			To get the next page.
'F'			To return to the first screen.
'B'			To skip to the last screen.
'S'			To search for a regular expression.
'E' or CTRL/Z		To exit the program.
'X'			To exit the current file.

Type HELP LIST COMMANDS DETAILS for more on specific commands.

3 DETAILS
If the "next screen," "next page," or "backup" commands are preceeded by a
number, LIST will skip the requested number of screens or pages.  Negative
skips are allowed:  "-P" moves back one page. Note that <Space>, 0<Space>,
and 1<Space> are equivalent. All other characters will be ignored. 

The 'P' command skips to the next page (as delimited by form-feeds).

The 'B' command is equivalent to 32767<Space>.  As T must scan the file
byte-by-byte, the 'B' command may seem slow. 

Search arguments are regular expressions (as defined in the grep program).  If
you enter '?' when prompted for a search argument, a help screen will be
printed.  Backward searching is not possible. 

2 LIMITATIONS
The program will only backup to the built-in maximum of 100 screens.

T will erase underline and boldface information from the text if it occurs in
the following format (where 'X' is any character and '_\b' is backspace): 

	X_\b__    for underline and

	X_\bX... for boldface

If an embedded carriage return (for line-overprint) is encountered,
all text following the return will be ignored.

T converts <escape> characters in the text file to "<ESC>".
This was done to defend against escape sequences triggering user
terminal identification sequences (which could, for example, cause
the program to backup one screen).

2 BUGS

Neither input nor output may be redirected.  T cannot be used as a filter. 

If a skip or backup command fails (for example, if the input file is
not on a disk), the program will exit with an error message.

When running T from a remote (DECnet) terminal, you should use
<return> to request the next page and <rubout> or <linefeed>
to request the previous page.
