home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / sysutl / 1kutils3.lbr / PEEP13.DZC / PEEP13.DOC
Encoding:
Text File  |  1987-11-15  |  4.8 KB  |  135 lines
  1. PEEP.COM:  Text File Viewer
  2. Version 1.3  -  5 NOV 87
  3.  
  4. Version 1.3 Update:
  5.   - V 1.2 introduced a minor bug with major import - typing a non-existent
  6.     command crashed the program!  Very sorry about that.
  7.   - LF's are stripped to make room for a few more K of file.
  8.   - Responds to ^C,^R,^E,^X as per WordStar convention.
  9.  
  10. Version 1.2 Update:
  11.   - File printing available in "L" version.
  12.   - Tab expansion done internally.  No more line wrap problems.  Long lines 
  13.     are truncated on CRT but sent whole to printer.
  14.   - One line of overlap when scrolling.
  15.   - High bit masking done immediately to avoid problems with listing and 
  16.     finding.
  17.  
  18. FEATURES:
  19.  
  20. 1.  PEEP is a small program intended as a RAM disk resdient utility
  21.     (a major reason for keeping it to 1k size)
  22.     for viewing and printing text files in a flexible way.
  23.  
  24. 2.  You can do all of the things needed to look through the file
  25.     without moving from the home row. (page, scan, find, etc.)
  26.     No need to keep a (callused) finger on the CTRL key.
  27.  
  28. 3.  Before being displayed, characters are high bit masked.  Control
  29.     characters (except CR, LF, and TAB) are printed in "^" format.
  30.     Thus WordStar files and captured files from a BBS are viewable.
  31.  
  32. 4.  PEEP reads the whole file into available memory.  If the file is
  33.     too big, it reads what does fit, and you can get the rest
  34.     with the R command.
  35.  
  36. 5.  You can set a place marker in the text.
  37.  
  38. 6.  Files may be printed out from the place marker.
  39.  
  40. 7.  The installation file (PEEPINST.ASM) is for terminal installation.
  41.     As is, the program is compatible with Wyse, Televideo, et. al.
  42.  
  43.     The source contains screen dependent code for:
  44.         INSERT LINE : esc, E
  45.         ERASE TO END OF LINE : esc, T
  46.         HOME CURSOR : 1eh  (^^)
  47.         GOTOXY : esc, =, row+20h, col+20h
  48.         DIM VIDEO ON AND OFF : esc ')' and esc '('
  49.  
  50.     These are most easily altered with the PEEPINST.ASM file.
  51.  
  52.  
  53. USAGE:
  54.  
  55. Commands are not intended to be mnemonic but are grouped physically for
  56. ease of use.  (Don't panic!  Essentially, the right hand moves ahead and
  57. the left hand moves back through the text.  The main commands are mirror
  58. images, e.g. left index - ahead one screen, right index - back one screen.)
  59.  
  60.                                      ---
  61. Usage: PEEP <ufn>                               Go To Mark  | 0 |
  62.                                      ---
  63.  
  64.                          Read   Type          Init Printer  Mark   Print
  65.                           ---    ---                  ---    ---    ---
  66.                          | R |  | T |                | I |  | O |  | P |
  67.                           ---    ---                  ---    ---    ---
  68.      ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
  69.     | A |  | S |  | D |  | F |  | G |  | H |  | J |  | K |  | L |  | ; |
  70.      ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
  71.      End   Scan   Next   Next    Find   Find   Prev    Up  R/Scan   Top
  72.                   Line  Screen         Again  Screen  Line
  73.  
  74.  
  75.          X - Exit    <sp> - Hop 10 lines    <cr> - Next Screen (F)
  76.  
  77.  
  78. Details ->
  79.  
  80. A Display final screen.                ; Display first screen.
  81.  
  82. S Scroll continuously forward          L Scroll back until key pressed.
  83.  
  84. D Move forward one line of text        K Move back one line of text
  85.  
  86. F Move forward one screen              J Move back one screen
  87.  
  88. G Find a string                        H Repeat find
  89.   - Search is forward
  90.   - If found, string is contained in the top line of the screen
  91.  
  92.  
  93. R - READ:
  94.     If PEEP beeped when reading in the file, additional text may be
  95.     read in.  The new text replaces text currently in memory with one
  96.     screen of overlap.  The beginning of the text can be re-read with
  97.     additional R commands.
  98.  
  99. O - MARK:
  100.     Sets a pointer to the beginning of the line at top of screen.
  101.     (Home cursor position).  The marker is initialized to the beginning
  102.     of the file.
  103.  
  104. 0 - GO TO MARK:
  105.     Instant return to the marker.
  106.  
  107. I - INIT:
  108.      Send initialization string to printer.  It is installed with the
  109.     PEEPINST overlay.
  110.  
  111. P - PRINT:
  112.     Send text from MARK to bottom of current screen to printer.
  113.     Abort listing with ^C.  Although long lines are truncated on the
  114.     terminal display, they are sent whole to the printer.
  115.  
  116. T - TYPE:
  117.     Type a line to the printer, e.g. comments.  A blank line sends a
  118.     CRLF to the printer.
  119.  
  120.  
  121.                  ----
  122. Known bugs:
  123. 1.  The FIND function uses BDOS function 10.  Injudicious use of ^P, ^U
  124.     etc. can lead to unexpected results.
  125.  
  126.  
  127. Note:  PEEP is a bare-bones version of VIEW.  The same style of file viewing
  128. is also used in VCOMP (compare two text files) and BCOMP (compare two binary
  129. files).  The latter three are for ZCPR3 users.  PEEP is also available as
  130. an RCP segment.
  131.  
  132. Oct 1987  Rob Friefeld  4607 Colorado St., Long Beach, CA  90814
  133. 213-434-7338 (voice)
  134. Suggestions and complaints welcome.
  135.