home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / gags.zip / LIST.DOC < prev    next >
Text File  |  1985-07-17  |  10KB  |  243 lines
  1.                                                         LIST     Page 1
  2.  
  3.                         LIST Version 5.2
  4.                 (c) Copyright Vernon D. Buerg 1985
  5.  
  6.  
  7.  Command  LIST
  8.  -------------
  9.  
  10.  Purpose:  To display the contents of an ASCII text file,  line by  line
  11.            with the aid of scrolling and positioning commands.
  12.  
  13.  Format:   LIST  [d:][path]filename[.ext]
  14.  
  15.  Remarks:  An ASCII file of any size may be listed.
  16.  
  17.            The "filename" is optional.  If omitted, you are prompted  to
  18.         to enter  a filename.   You may  include drive,  path, and  wild
  19.         cards in the file name.   The first file which matches  the name
  20.         is displayed until an end-of-file character is encountered. Each
  21.         file which matches the "filename" may be displayed.
  22.  
  23.            LIST was  designed to  display ASCII  files.  That  is, files
  24.         which  contain  text  and  not  binary  or  control codes.  Text
  25.         characters usually range from a value of 32 to 127.
  26.  
  27.            Characters  below  32  (a  blank)  are  replaced with a funny
  28.         character to indicate that a non-displayable character has  been
  29.         encountered.  This character is an upside-down question mark.
  30.  
  31.            Characters above 127 may be valid graphic characters, and may
  32.         be displayed if  the '8' command  is in effect.   To insure that
  33.         characters above ASCII value 127 are not displayed, use the  '7'
  34.         command.
  35.  
  36.            The  file  is  displayed  with  one  logical  record  on each
  37.         80-column display line.   A logical record  ends in a  linefeed.
  38.         The maximum logical record may  be 255 characters long.  If  the
  39.         record exceeds 80  characters, you may  view the portion  beyond
  40.         the 80 columns  by using the  scroll right command,  or by using
  41.         the Wrap feature.
  42.  
  43.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  44.         longer than 80 characters.  With Wrap on, lines are displayed in
  45.         their  entirety,  80  characters  per  display line.  The scroll
  46.         -left and -right functions are disabled when Wrap is ON.
  47.  
  48.            The file may  be PRINTed as  it it displayed.   The P command
  49.         toggles  the  printer  on  or  off.   When  first entered, the P
  50.         command causes the current screen  to be printed.  As new  lines
  51.         are displayed, they too are printed.  Printing may be stopped by
  52.         entering another P command.  The PrtSc key may also be used, but
  53.         the title and prompt lines will be printed with the lines of the
  54.         file. Empty lines cause a line to be skipped on the printer.
  55.                                                         LIST     Page 2
  56.  Key functions and Commands
  57.  --------------------------
  58.  
  59.         On the COMMAND line, enter a letter or control key:
  60.  
  61.         Letter(s)     Default   Function
  62.         ---------     -------   ------------------------
  63.         A                       find next occurance of 'text'
  64.         B                       skip to end of file (bottom)
  65.         D or +                  scroll down one page
  66.         F                       Find 'text' regardless of case
  67.         H or ?                  list commands (HELP)
  68.         K               off     toggle keyboard flush
  69.         L                       scroll left 20 columns
  70.         N                       down one (next) line
  71.         P               off     toggle printer on or off
  72.         Q                       display next matching file
  73.         R                       scroll right 20 columns
  74.         S                       Scan for exact text match
  75.         T                       restart from first block (top)
  76.         U or -                  scroll up one page
  77.         W               off     toggle wrap of lines over 80 chars
  78. |       X                       terminate, clear screen and exit to DOS
  79.         7               off     turn off high bit (non-graphics only)
  80.         8               on      leave high bit on (graphics)
  81.  
  82.         \text                   Find 'text' regardless of case
  83.         /text                   Scan for exact text match
  84.  
  85.     Control key      Function
  86.     -----------     -------------------------------------------
  87.      Enter           continue to next page
  88. |    END             position to end of block
  89.      ESCape          Display next matching file
  90.      HOME            restart from first block (top)
  91.      PgUp            scroll up one page
  92.      PgDn            scroll down one page
  93.  
  94.      left arrow      scroll left 20 columns
  95.      right arrow     scroll right 20 columns
  96.      up arrow        up one (previous) line
  97.      down arrow      down one (next) line
  98.  
  99.      ctl-HOME        restart from CURRENT (64k) block
  100.      ctl-PgUp        restart from first block (TOP)
  101.      ctl-PgDn        skip to end of file (BOTTOM)
  102.      ctl-left-arrow  reset scroll to column 1
  103.  
  104.      F1              Help - display summary of commands
  105.      F3              Find next occurrance of text
  106.      F10             Exit to DOS
  107.  
  108. |    F5              change background color for top and bottom lines
  109. |    F6              change foreground color for top and bottom lines
  110. |    F7              change background color for main body of display
  111. |    F8              change foreground color for main body of display
  112.  
  113. |    alt-C           clone LIST.COM, change colors permanently in program file
  114.                                                         LIST     Page 3
  115.  
  116.  Screen attributes
  117.  -----------------
  118.  
  119. |          The colors used for displaying the titles and main body of
  120. |       text may be changed temporarily or permanently. To make a
  121. |       permanent change, the cloning command alt-C is used. It requires
  122. |       that the LIST.COM program file be on the current drive and in
  123. |       the current directory.
  124.  
  125.            There are three classes  of attributes used.  One  for normal
  126.         display lines  - lines  2 to  24 -  another for  special lines -
  127.         lines 1 and 25, and a third for the Find/Scan color.  The border
  128.         is not changed.  The foreground color applies to the characters
  129.         displayed.
  130.  
  131. |       These color attributes may be changed by using these function keys:
  132.  
  133. |         For the top and bottom lines
  134. |           F5 - background color
  135. |           F6 - foreground color
  136. |
  137. |         For the main body of text
  138. |           F7 - background color
  139. |           F8 - foreground color
  140.  
  141.  
  142. |       Once you have decided upon the colors, use the alt-C key
  143. |       combination to change the LIST.COM program file.
  144.  
  145.                                                         LIST     Page 4
  146.  
  147.  Scanning for text
  148.  -----------------
  149.  
  150.  
  151.            You may use  Find (\)  to search for text  regardless  of the
  152.         case, or you may use Scan (/) to find an exact match.
  153.  
  154.            To scan for a character string, type a slash (/) followed  by
  155.         one or more (up to 32)  characters.  The scan text, but not  the
  156.         slash,  is  displayed  on  the  command  line.  The scan is case
  157.         sensitive.  That is, lower case scan text will only match  lower
  158.         lower case file text.
  159.  
  160.            While  the  program  is  searching  for  the text, the bottom
  161.         display line is changed to say "Scanning".
  162.  
  163.            If the text is found, the line containing it is displayed  as
  164.         a high-intensity line.
  165.  
  166.            If the text is NOT found, the bottom line (25) is changed  to
  167.         say '*** text not found ***', and the display remains unchanged.
  168.  
  169.            To find the next occurrance of the same text,  use the A)gain
  170.         command, or press the F3 key.
  171.  
  172.                                                         LIST     Page 5
  173.  
  174. Update history
  175. ==============
  176.  
  177.         Lines beginning with | denote changes to the latest version.
  178.  
  179.         Version 4.1, April 27, 1984.
  180.         Version 4.15, June 2, 1984.
  181.         Version 4.2, July 14, 1984.
  182.         Version 5.0, August 10, 1984.
  183.         Version 5.1, August 27, 1984.
  184.         Version 5.2, September 29, 1984.
  185.         Version 5.4, March 22, 1984.
  186.         Version 5.48, May 27, 1985.
  187.  
  188.         Version 5.49, May 31, 1985.
  189.             Corrects ctrl-PgDn, adds file date/time display
  190.             Wrap forces Left column and Top of file
  191.  
  192. |       Version 5.52, July 15, 1985.
  193. |           Correct Print command problems
  194. |           Adds alt-C to clone LIST.COM with new colors
  195. |           The X command now clears the screen when exiting to DOS,
  196. |           while F10 leaves the last display on the screen.
  197.  
  198.                                                         LIST     Page 6
  199.  
  200.  Restrictions
  201.  ------------
  202.  
  203.            Some positioning is relative to the current block in storage.
  204.         The size of the block depends on the amount of memory available,
  205.         and up to 64K-bytes is allocated to the file buffer. The program
  206.         requires at least 6K bytes.
  207.  
  208.         o  PC-DOS Version 2.0 or later is required.
  209.  
  210.         o  ANSI.SYS is NOT required.
  211.  
  212.  
  213.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or
  214.         later, including DOS 3.1.
  215.  
  216.         LIST is supplied for personal, private use. Feel free to
  217.         distribute LIST given these restrictions:
  218.  
  219.           o  the program shall be supplied in its original,
  220.              unmodified form, which includes this documentation;
  221.  
  222.           o  no fee is charged.
  223.  
  224.           o  commmercial use is prohibited.
  225.  
  226.           o  the program may not be included - or bundled - with
  227.              other goods or services. Exceptions may be granted
  228.              upon written request only.
  229.  
  230.         If you are using LIST and find it of value, your contribution
  231.         in any amount ($15 suggested) will be greatly appreciated.
  232.  
  233.         For use by corporations and other institutions, please
  234.         contact AAI Systems for a site licensing agreement.
  235.  
  236.                 Vernon D. Buerg
  237.                 AAI Systems, Inc.
  238.                 456 Lakeshire Drive
  239.                 Daly City, CA 94015
  240.                 Data: (415) 994-2944, 2am-10am PDT
  241.  
  242.  
  243.