home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / v.lbr / V0.HZP / V0.HLP
Encoding:
Text File  |  1991-11-18  |  8.3 KB  |  297 lines
  1. ;
  2.                                       V.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                8k (58)   85DA  0.6        Bridger Mitchell 4/90    Z3COM16
  6.  
  7.   1- Syntax  2- TCAP Requirements  3- Multi-file Viewing  4- Configuration    
  8.  
  9.    V is a quad-directional file-viewer for ZCPR3.   It uses an in-memory cache 
  10. to make the most recently read sectors of  a  file  available  for  re-viewing 
  11. without additional disk reads.  This allows reverse viewing of crunched files,
  12. up to the limit of available memory.   If, when going in reverse, the cache is
  13. exhausted,  V will  automatically restart  the  uncrunching  process  from the 
  14. beginning of the file and display the first lines.
  15.  
  16.    Viewing of adjacent lines/screens  is  rapid  for  both  ascii and crunched 
  17. files.   Going to the End is  also  quick in ascii,  but results in some delay 
  18. uncrunching a large file -- the entire file must be uncrunched first.
  19. :1
  20.  
  21.    Syntax   V filename.typ
  22.             V //                           <--  help screen
  23.             V filespec1 ... filespecN      <--  multiple-file viewing
  24.  
  25.                ^C  -->  moves to next file           "
  26.                ^R  -->  moves to previous file       "
  27.                ^X  -->  exits the program            " 
  28.  
  29. A filespec is an ambiguous filename and type, preceded by  an optional  DU: or
  30. DIR: specification (e.g., *.DOC; WORK:MENU??.TXT; A15:*.*; FOO.BAR).
  31.     
  32. To search forward, enter "Gstring<cr>"
  33.    UPPERcase matches exactly
  34.    lowercase matches lower or upper
  35.    '?' matches any character
  36. "G<cr>" finds next match
  37.  
  38. See control menu at top of screen.  
  39. The Z-system 'arrow' keys are also supported.
  40. :2
  41.  TCAP Requirements - 1/2 
  42.  
  43.    The termcap requirement is the  addition of three  strings to  the standard
  44. Z-System termcap.  These definitions are already setup in files of type ".NZT"
  45. (New Z-System Termcap),  available on major Z-Nodes.   If your  terminal isn't 
  46. already there,  you  can  add  definitions  following the  initialization  and 
  47. deinitialization strings.   Here's  an example for the Wyse-50.   NOTE:   This 
  48. uses the  STANDARD termcap specification  (not the one in  experimental use in 
  49. early 1989 by J. W. Wright).
  50.  
  51.     DEFB    'TERMINALNAME'    ; 13 bytes
  52.     db    0        ; reserved
  53.  
  54.     [ ... next part of termcap omitted...]
  55.  
  56.     DEFB    ESC,')',0    ; SO - Standout on string
  57.     DEFB    ESC,'(',0    ; SE - Standout end string
  58.     DEFB    0        ; TI - Terminal init string
  59.     DEFB    0        ; TE - Terminal de-init string
  60.  TCAP Requirements - 2/2 
  61.  
  62. ;
  63. ; 3 extensions to standard TCAP follow immediately after "TE"
  64. ;
  65.     DEFB    ESC,'R',0    ; DL - Line Delete
  66.     DEFB    ESC,'E',0    ; IL - Line Insert
  67.     DEFB    ESC,'Y',0    ; CD - Clear to End of Screen String
  68. ;
  69. ; ... the rest of the termcap ...
  70. ;
  71. :3
  72.  Multi-File Viewing 
  73.  
  74.    V maintains a ring of all  matching files.   ^X will move to the next file; 
  75. ^R moves back to the previous file.  ^C exits the program.   Because  the ring 
  76. is virtual,  V should  work  on  any  size disk,  regardless  of the number of
  77. directory entries.   (These and all other control commands may be rebound; see 
  78. below).   A list of excluded filespecs is tested; files such as COM, REL, LBR,
  79. !!!TIME&.DAT,  etc. will be skipped automatically.   You can extend this table
  80. by patching near the start of V.
  81.  
  82.     
  83.    V uses an in-memory cache to make the most recently read sectors of  a file 
  84. available for re-viewing without additional disk reads.   This  allows reverse 
  85. viewing of crunched files,  up to the limit  of  available  memory.   If, when 
  86. going in reverse, the cache is  exhausted,  V  will  automatically restart the 
  87. uncrunching  process  from the  beginning of  the file and  display  the first
  88. lines.
  89. :4
  90.  Configuration - 1/11 
  91.  
  92. You can change the keys that control V by assembling a modified version of the
  93. code below:
  94.  
  95. ;
  96. ; offsets from 100h for configuration areas
  97. ;
  98. CONFIGBUF    equ    20h
  99. HELPBUF        equ    80h
  100. EXCLUDEBUF    equ    200h
  101.  
  102. SPACE    equ    20h
  103. TAB    equ    09h
  104. CR    equ    0dh
  105. LF    equ    0ah
  106.  Configuration - 2/11 
  107.  
  108.    1. These are the bindings that control the  V screen.  In  addition  to the 
  109.       one to three keys for each command, V automatically picks up the cursor-
  110.       control keys ("arrow" keys) from  the  Z-System  tcap and uses them,  in 
  111.       addition to the bindings in these tables.
  112.  
  113.    2. To change the bindings, set the equates for your preferences, reassemble
  114.       this file to HEX, and overlay onto V.COM.  
  115.  
  116.    3. Enter exactly 3 bytes for each binding.   Use uppercase for all keys.  V 
  117.       automatically converts a  typed lower case key to upper case.  Use a nul 
  118.       to indicate the absence of a binding.
  119.  
  120.    4. Edit the help screen to match your choice of bindings.
  121.  Configuration - 3/11 
  122. ;
  123. K_up1    equ    ','
  124. K_up2    equ    'P'-'@'    
  125. K_up3    equ    0
  126. ; and, automatically, Z3TCP's left arrow key
  127. ;
  128. k_pgup1    equ    '<'
  129. K_pgup2    equ    TAB
  130. K_pgup3    equ    'Z'-'@'
  131. ; and, automatically, Z3TCP's left arrow key
  132.  
  133. K_dn1    equ    '.'
  134. K_dn2    equ    SPACE
  135. K_dn3    equ    'N'-'@'
  136. ; and, automatically, Z3TCP's up arrow key
  137.  
  138. K_pgdn1    equ    '>'
  139. K_pgdn2    equ    CR
  140. K_pgdn3    equ    'V'-'@'
  141. ; and, automatically, Z3TCP's down arrow key
  142.  Configuration - 4/11 
  143.  
  144. ;
  145. K_left1    equ    'L'
  146. K_left2    equ    'A'-'@'
  147. K_left3    equ    0
  148. ;
  149. K_rt1 equ    'R'
  150. K_rt2 equ    'E'-'@'
  151. K_rt3 equ    0
  152. ;
  153. K_beg1    equ    'B'
  154. K_beg2    equ    0
  155. K_beg3    equ    0
  156. ;
  157. K_end1    equ    'E'
  158. K_end2    equ    0
  159. K_end3    equ    0
  160.  Configuration - 5/11 
  161.  
  162. ;
  163. K_goto1    equ    'G'
  164. K_goto2    equ    'S'
  165. K_goto3    equ    0
  166. ;
  167. K_nxtf1    equ    'X'-'@'
  168. K_nxtf2    equ    0
  169. K_nxtf3    equ    0
  170. ;
  171. K_prvf1    equ    'R'-'@'
  172. K_prvf2    equ    0
  173. K_prvf3    equ    0
  174. ;
  175. K_exit1    equ    'C'-'@'
  176. K_exit2    equ    0
  177. K_exit3    equ    0
  178. ;
  179.  Configuration - 6/11 
  180.  
  181. ;
  182. subttl    '---------- KEY BINDINGS ----------'
  183. ;
  184. ; Each V function has three possible key values.
  185. ; V ignores case.
  186. ; If you use fewer than three keys, use nulls for the remainder.
  187. ;
  188. ;;    org    CONFIGBUF
  189. ;
  190. beginconfig:
  191. ;
  192.     db '__UP:'    
  193. k.up:    db    K_up1,K_up2,K_up3    ; Scroll one line up    
  194. ;
  195.     db 'PGUP:'
  196. k.pgup:db    K_pgup1,K_pgup2,K_pgup3    ; Scroll one page (screen) up    
  197.  Configuration - 7/11 
  198.  
  199. ;
  200.     db '__DN:'
  201. k.down:    db    K_dn1,K_dn2,K_dn3    ; Scroll one line down
  202. ;
  203.     db 'PGDN:'
  204. k.pgdown:db    K_pgdn1,K_pgdn2,K_pgdn3    ; Scroll one page (screen) down
  205. ;
  206.     db 'LEFT:'
  207. k.left:    db    K_left1,K_left2,K_left3    ; Scroll to left
  208. ;
  209.     db 'RGHT:'
  210. k.right:db    K_rt1,K_rt2,K_rt3    ; Scroll to right
  211. ;
  212.     db 'BEGN:'
  213. k.begin:db    K_beg1,K_beg2,K_beg3    ; Display beginning of file
  214. ;
  215.     db '_END:'     
  216. k.end:    db    K_end1,K_end2,K_end3    ; Display end of file
  217.  Configuration - 8/11 
  218.  
  219. ;
  220.     db 'GOTO:'
  221. k.goto:    db    K_goto1,K_goto2,K_goto3    ; Goto (search) for string 
  222. ;
  223.     db 'NXTF:'
  224. k.nextfile:db    K_nxtf1,K_nxtf2,K_nxtf3    ; View next file
  225. ;
  226.     db 'PRVF:'
  227. k.prevfile:db    K_prvf1,K_prvf2,K_prvf3    ; View previous file
  228. ;
  229.     db 'EXIT:'
  230. k.exit:db    K_exit1,K_exit2,K_exit3    ; Exit from V.
  231. ;
  232. .list
  233. configlen    equ    $-beginconfig
  234. ;
  235. test0 equ     HELPBUF-CONFIGBUF-configlen
  236.     ds    HELPBUF-CONFIGBUF-configlen    
  237. .xlist
  238.  Configuration - 9/11 
  239.  
  240. subttl    '---------- HELP AND USAGE ----------'
  241. ;
  242. ;;    org    HELPBUF
  243. ;
  244. ; Edit the message to correspond to the key bindings.
  245. ;
  246. helpmessage:
  247. ;
  248. db 'V  commands (in addition to Z-System arrow keys):',cr,lf
  249. db lf
  250. db '1 line down  .  SP ^N       1 line up   , ^P',cr,lf
  251. db '1 page down  >  CR ^V       1 page up   < ^Z',cr,lf
  252. db 'n pages      digit          n pages     digit',cr,lf
  253. db lf
  254. db 'right        R              left        L',cr,lf
  255. db 'beginning    B              end         E',cr,lf
  256. db 'next file    ^X             prev. file  ^R',cr,lf
  257. db 'goto/search  G              exit        ^C',cr,lf
  258. db 0
  259.  Configuration - 10/11 
  260.  
  261. ;
  262. helpmsglen equ $-helpmessage
  263. .list
  264. ;!!! ERROR -- help message is too long.
  265.  
  266. test2 equ     EXCLUDEBUF-HELPBUF-helpmsglen
  267.     ds    EXCLUDEBUF-HELPBUF-helpmsglen
  268. ;
  269. .xlist
  270. subttl    '---------- FILE EXCLUSION LIST ----------'
  271. ;
  272. ;
  273. exclude_cnt:
  274.     db    ??excnt        ;; number of items in list
  275. .xlist
  276. exclude_tbl:
  277.  Configuration - 11/11 
  278.  
  279. ; ruler:    '--11 bytes-'
  280.     db    '!!!TIME&DAT'
  281.     db    '????????SWP'
  282.     db    '????????BIN'
  283.     db    '????????C?M'
  284.     db    '????????R?L'
  285.     db    '????????Z?L'
  286.     db    '?????????Y?'
  287.     db    '????????LBR'
  288.     db    '????????BSX'
  289.     db    '????????RSX'
  290.     rept    5*11        ;; space for more
  291.     db    0FFh        ;; list terminator
  292.     endm
  293. ??excnt equ ($-exclude_tbl)/11
  294.     db    0
  295. ;
  296. ; end vkeys.lib
  297.