Project Software & Development, Inc.
14 Story St.
Cambridge, Ma. 02138
617-661-1444

Title:		LIST
Author:		Robin Miller
Date:		December 3, 1982

Description:

	The LIST program is used to list file(s) at the terminal.  It lists
one screen full at a time so you can easily scroll through the file.  On the
VT52, VT100, and Tektronix scope, it keeps the file name and creation date at
the top op the screen.  Typing a /HE to the LIS> prompt displays the valid
switches.  Typing "HELP" or question mark ("?") while listing a file displays
help on additional commands.

Operating procedures:

	>LIST file_name

Where:
	The file_name may be any legal VAX/RSX-11M file specification,
	and may have wildcards (*) for the file names.  If wildcards
	are used, the version number also defaults to * automatically.

	Wildcard listing on the VAX is available by using a command file
	called LIST.COM.  To use this command file, define the following
	symbol in your login command file "LIST :== @LIST.COM".  This
	command procedure will probably need modified for your installation.

Examples:
	*.MAC		*.*		TEST.*		file.ext

******************************************************************************

There have been several changes made to the LIST program.

1.  First, LIST presumes you are running on a VT100 with the Advanced
    Video Option (AVO).  If your VT100 doesn't have the AVO, you must
    specify /VT or the VT command within LIST.  This is only needed
    if you are listing in 132 column mode.  The AVO, adds an additional
    10 lines of 132 column lines for display; otherwise only 14 lines
    can be displayed.

2.  The Find Next (FN) command has been added to search for a previous
    search string.  The Find command now always prompts for a search
    string where previously it would use the previous search string
    if there was one.

3.  The most important change and the most requested, is the keypad on
    the VT100 is now enabled.  The PF2 key can be used to display the
    keypad help just like EDT.  Only those keys which make sense are
    enabled.  For example, FILL, WORD, EOL, CHAR, etc., are all disabled.

    The arrow keys are also enabled.  The right and left arrow keys are
    used to move the margin left or right, and the up and down arrow
    keys are used to backup or advance 1 line.

    I'm open to suggestions as to how the undefined keys should be defined.
    Some of the commands which could be used for these keys are:

    	SEEALL, RULER, NARROW, and WIDE.

******************************************************************************

    The PRINT command has been added to the LIST program.  The command can
    be issued either by typing "PR(int)" to the prompt at the bottom of the
    screen, or by typing the COMMA key on the VT100 auxiliary keypad.

    The file is spooled to logical name SYS$PRINT.  If you want the file to
    be printed on a particular line printer, direct SYS$PRINT to the
    appropriate queue.  For example, to print files on our lowercase line
    printer, issue the following command before running LIST:

	$ DEFINE SYS$PRINT LPB0

   After the file is spooled to the line printer, it is automatically closed
   and the next file (if any) is listed.

   Also, any key on the VT100 auxiliary keypad can now be used to terminate a
   LIST command at the bottom of the screen (i.e., EXIT).  Previously, any
   command terminated by a key on the auxiliary keypad was ignored.

******************************************************************************

Problems:

  1.  The search command only searchs forward through the file.
  2.  Scrolling backward through a file, such as embedded carriage control,
      does not update the screen properly on a VT100.  A temporary solution
      is too type the REFRESH command to get an accurate display.
  3.  Moving the margin by less than a tab stop sometimes causes problems.

Notes:

  1.  The largest record size that can be listed is 512 bytes.
  2.  When listing binary data such as task images and librarys, use the
      /-VFU (disable vertical format conversion) and /SEEALL mode to
      display non-printable characters.

