home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / s / scan12.ark / SCAN12.DOC < prev   
Encoding:
Text File  |  1989-09-27  |  6.9 KB  |  204 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  2. *                                *
  3. *            SCAN version 1.2            *
  4. *                                *
  5. *    A Buffered Bi-directional Text File Scroll Utility    *
  6. *                                *
  7. *               Terry Hazen                *
  8. *              Los Gatos, California            *
  9. *                09/29/85                *
  10. *                                *
  11. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  12.  
  13.  
  14. INTRODUCTION...
  15.  
  16. SCAN  is a buffered  bi-directional text file scroll utility that
  17. was adapted from BISHOW,  Version 3.01.   The name was changed to
  18. avoid conflicts with possible newer BISHOW versions,  and because
  19. BISHOW's assembly-time options were deleted.  The DU: form is now
  20. supported and most control characters are displayed.  File scroll
  21. commands may be customized by the user.
  22.  
  23. SCAN will display normal ASCII files,  squeezed files,    and  will
  24. display  LBR members and directories.  SCAN displays most control
  25. characters,  a    useful feature when viewing WordStar and  similar
  26. files  with embedded print and format control  characters.   SCAN
  27. can replace TYPE, LDIR, LTYPE, TYPEL, etc, in many situations.
  28.  
  29. SCAN  requires    a  terminal  with  home cursor    and  erase screen
  30. functions.   Scrolling    backwards by page or by line is  done  by
  31. erasing  and  re-displaying the text,  so that    SCAN  works  more
  32. satisfactorily    on high baud rate terminals like the WYSE,  which
  33. supports 38400 baud.
  34.  
  35.  
  36. THE SCAN COMMAND LINE...
  37.  
  38. The  SCAN command line may include the filename with optional du:
  39. specification,    and  optional library member  name.   The  screen
  40. display width and number of lines per scroll may also be changed.
  41.  
  42.  
  43. Usage:      SCAN [du:]fn.ft [member] [columns [scroll lines]]
  44.  
  45. Examples:
  46.       SCAN               - displays usage help screen
  47.  
  48.       SCAN TXT50.ASM       - displays normal file
  49.  
  50.       SCAN TXT50.AQM       - displays squeezed file
  51.  
  52.       SCAN TXT50.DOC 65 20       - displays file and sets
  53.                     screen display to
  54.                     65 columns wide and
  55.                     20 lines/scroll
  56.  
  57.       SCAN TXT50.LBR       - displays directory of LBR
  58.                     when .LBR extension is
  59.                     used and no member name
  60.                      is specified
  61.  
  62.       SCAN TXT50 TXT50.AQM       - displays member file in LBR
  63.  
  64.  
  65. Command Line Options:
  66.  
  67.      [du:]           - Normal drive and/or user specification
  68.  
  69.      [member]           - Displays  a  member file in  a  library.
  70.              The  use of the .LBR extension   in  the
  71.              library filename is optional.
  72.  
  73.      [columns  [scroll    lines]]
  74.                - Sets the number of columns displayed and
  75.              the  number  of lines per  scroll.   The
  76.              number  of columns may be  specified  by
  77.              itself, or both columns and scroll lines
  78.              may be specified
  79.  
  80.  
  81. SCAN FILE SCROLL COMMANDS...
  82.  
  83. SCAN,  as supplied,  has the following file scroll commands, many
  84. of them emulating WordStar cursor control commands:
  85.  
  86.      First Line ---------------->  1
  87.  
  88.      Next Page -----------------> ^C, F, Space
  89.      Previous Page -------------> ^R, B
  90.  
  91.      Next Line -----------------> ^X, N, CR
  92.      Previous Line -------------> ^E, P
  93.  
  94.      Scroll Display Left -------> ^S, Backspace
  95.      Scroll Display Right ------> ^D, Tab
  96.  
  97.      Set Display Width/Scroll -->  S
  98.  
  99.      EXIT SCAN ----------------->  Q, ESC
  100.  
  101.      Any other command will display a help screen.
  102.  
  103.  
  104. CUSTOMIZING SCAN...
  105.  
  106. SCAN  requires    a  terminal with home  cursor  and  erase  screen
  107. functions.   These  control sequences and any desired changes  in
  108. the  commands  may be patched directly into SCAN.COM  using  DDT,
  109. PATCH, or any similar utility, at the locations given below.
  110.  
  111. Some  of  the  distribution  command  options  emulate     WordStar
  112. commands,  but    you may customize any or all of these commands to
  113. suit  your  own  preferences.    You may change    the  commands  to
  114. emulate your favorite word processor, or to use your cursor arrow
  115. keys,  for  example.   If any of the commands  are  changed,  you
  116. should also update the help screen text beginning at 0116H.
  117.  
  118. If you are using DDT or PATCH to modify  SCAN.COM,  use this list
  119. of functions and their corresponding addresses:
  120.  
  121.  
  122. HEX    -DEFAULT-
  123. ADDR   HEX  ASCII   FUNCTION
  124. -----------------------------------------------------------------
  125. 0106H  1AH  ESC     Home cursor and clear screen sequences. Up to
  126. 0107H  5BH   [        7  bytes  are  available.    The  default
  127. 0108H  48H   H        sequences  are    for the  VT100/ANSI.  End
  128. 0109H  1AH  ESC     your combined sequences with 00H.
  129. 010AH  5BH   [
  130. 010BH  32H   2
  131. 010CH  4AH   J
  132. 010DH  00H        End of home cursor and clear screen area.
  133.  
  134. 0116H            Start of help screen  text area.   Update the
  135.             text in this area with any changed commands.
  136.  
  137.  
  138. File Scroll Command definitions:
  139. -------------------------------
  140.  
  141. 067AH  31H   1        First Line command.
  142.  
  143. 067FH  20H  SPACE   Next Page command, first option.
  144. 0684H  03H  ^C        Next Page command, second option.
  145.  
  146. 0689H  42H   B        Previous Page command, first option.
  147. 068EH  12H  ^R        Previous Page command, second option.
  148.  
  149. 0693H  0DH  CR        Next Line command, first option.
  150. 0698H  4EH   N        Next Line command, second option.
  151. 069DH  1AH  ^Z        Next Line command, third option.
  152.  
  153. 06A2H  50H   P        Previous Line command, first option.
  154. 06A7H  17H  ^W        Previous Line command, second option.
  155.  
  156. 06ACH  51H   Q        Exit command, first option.
  157. 06B1H  1BH  ESC     Exit command, second option.
  158.  
  159. 06B6H  53H   S        Set Screen Display command.
  160.  
  161. 06BBH  08H  BS        Scroll Display Left command, first option.
  162. 06C0H  13H  ^S        Scroll Display Left command, first option.
  163.  
  164. 06C5H  09H  TAB     Scroll Display Right command, first option.
  165. 06CAH  04H  ^D        Scroll Display Right command, first option.
  166.  
  167.  
  168. Default Settings:
  169. ----------------
  170.  
  171. 08B8H  3EH   >        Beginning of >>> Unsqueezing text <<< msg.
  172.             If this message annoys you, put a 00H here.
  173.  
  174. 0D38H  3AH   :        Fence character for LBR directory display.
  175.  
  176. 10A7H  17H (23 dec) Default number of lines per scroll.
  177.  
  178. 10A8H  4EH (78 dec) Default  number  of  columns  displayed  -    1
  179.             (79 - 1).    79  is used,  as  some    terminals
  180.             do not  allow the  80th column  to be  filled
  181.             without going to the next line.
  182.  
  183. 10B8H  00H  (0 dec) Maximum number of  LBR  directory names to be
  184.             displayed  per  line  -  1    (1 per line - 1).
  185.             Allow 14 spaces for each  directory  listing.
  186.             Change this number if you change the  default
  187.             number  of columns    to be  displayed.   A 00H
  188.             here causes the listings to be displayed in a
  189.             single column, which is easy to read.  An 04H
  190.             will give  5 names per line,  the maximum for
  191.             79 columns.
  192.  
  193.  
  194. ACKNOWLEDGEMENTS...
  195.  
  196. Phil Cary wrote BISHOW 1.00,  which was a buffered, bidirectional
  197. version of SHOW.ASM from Interface Age, November 1981. BISHOW was
  198. subsequently updated and enhanced by W.F.Mcgee, Lucien Pan, Keith
  199. Petersen, Bruce Ratoff, Dick Mead, Chuck Forsberg, Ted Emigh, and
  200. Frans van Duinen.  The DU: code was adapted from Bob Van Valzah's
  201. FAST and Ron Fowler's MLOAD.  Thanks!
  202.  
  203.                   - Terry Hazen
  204.