home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / utilitys / rpeep12.arc / RPEEP12.DOC < prev    next >
Text File  |  1991-08-11  |  4KB  |  92 lines
  1. =============================================================================
  2.  
  3.         P E E P    C O M M A N D
  4.  
  5. ============================================================================
  6.  
  7.  +++++++    NOT an official RCP segment for Z33RCP.Z80
  8.         This is a hacker's module intended to work with Z33RCP.
  9.  
  10.  Command:    PEEP
  11.  Function:    Text File Browser and Lister
  12.  Comments:    The CRT protocol has to be hard coded into this module.
  13.         If the TCAP were used, PEEP would not be practical.
  14.  Author:     Rob Friefeld, 4607 Colorado St., Long Beach, CA 213-434-7338
  15.  Date:        4 Nov 1987 Version 1.2
  16.  
  17. USAGE:
  18.     Hands rest on the home row of keys.  Left hand moves ahead
  19.     through text, right hand moves back.
  20.                                                             ---
  21.                                               Go To Marker | 0 |
  22.                                                             ---
  23.                       Read More                     Init    Set    Print
  24.                   (if memory full)                 Printer Marker (from mark)
  25.                          ---                         ---    ---    ---
  26.                         | R |                       | I |  | O |  | P |
  27.                          ---                         ---    ---    ---
  28.     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
  29.    | A |  | S |  | D |  | F |  | G |  | H |  | J |  | K |  | L |  | ; |
  30.     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
  31.     End   Scan   Next   Next    Find   Rpt    Prev   Prev  R/Scan  Top
  32.   Screen         Line  Screen         Find   Screen  Line         Screen
  33.  
  34.  
  35.   X - Exit   <sp> - Hop 10 lines   <cr> - Next Screen (F)  </,?> - File Name
  36.  
  37. The text movement commands should be self-demonstrating.  I hope with a
  38. minute or two practice, they become easy enough to use.
  39.  
  40. If the entire file will not fit in memory, a message is printed.  The 'R'
  41. command will then read in the next TPA sized chunk of the file with one
  42. screen of overlap.  When there is no more to be read, you can start over at
  43. the beginning.
  44.  
  45. The 'O' command sets a place marker to the top of the current screen.  You can
  46. return to it with a '0'.  The marker is also used as the start of the block
  47. to be listed with the 'P' command.  The end of the block is the bottom of the
  48. current screen.  A prompt will ask if you really want to do a listing to:
  49. 1) give you a chance to recover from an accidental key strike, 2) make sure
  50. the printer is on, 3) think one last time about where the marker is - it
  51. is initialized to the start of the text.  A printer initialization string
  52. can be installed, if desired.
  53.  
  54. Sorry about not using the TCAP video.  Aside from the problem of no "insert
  55. line" sequence, the access routines would make PEEP unwieldy.  Those using
  56. only one terminal should find the installation worthwhile.
  57.  
  58. The CRT requirements are:
  59.     80 columns (or more), 24 lines
  60.  
  61.     COMMAND        DEFAULT
  62.     -------        -------
  63.     CLS        1Ah
  64.     EREOL        ESC,'T'
  65.     GOTOXY        ESC,'=',row+32,col+32
  66.     INSERT LINE    ESC,'E'
  67.     HOME CURSOR    1Eh
  68.     STAND OUT    ESC,')'        ;optional
  69.     STAND END    ESC,'('        ;optional
  70.  
  71. The source file contains instructions for setting up the video sequences.
  72.  
  73. CRT WIDTH OPTION:
  74. The CRT width can be taken from the ENV at the cost of 20 bytes of code.
  75. (I have set up my CRT 1 for a 132 char line width.)
  76.  
  77. IMPLEMENTATION:
  78.  
  79. To incorporate PEEP into the Z33RCP, a few additions are needed.
  80.  
  81. 1) Z33RCP.LIB
  82.     package switch  - peepon  equ  yes
  83.     command macro   - command peep, peepon, false, peep
  84.     wheel equates could also be added
  85.  
  86. 2) Z33RCP.Z80
  87.      if peepon
  88.     include rpeep.lib
  89.      endif
  90.  
  91. END RPEEP12.DOC, false, peep
  92.     wheel equates could also be a