v.doc	vers. 0.4B   2/2/90	Bridger Mitchell (Plu*Perfect Systems)

	V -- quad-directional Z-System file viewer


V now supports multiple files, with usage:

	V filespec1 ... filespecN

A filespec is an ambiguous filename and type, preceded by an optional
DU: or DIR: specification.  Some valid filespecs are:

	*.DOC
	WORK:MENU??.TXT
	A15:*.*
	FOO.BAR
	
V maintains a ring of all matching files.  ^C will move to the
next file; ^R moves back to the previous file.  ^X exits the
program. Because the ring is virtual, V should work on any size
disk, regardless of the number of directory entries. 

A list of excluded filespecs is tested; files such as COM, REL, LBR,
!!!TIME&.DAT, etc. will be skipped automatically.  You can extend this
table by patching near the start of V.   

Check the help screen ("V //") and experiment with the
keys displayed on the control menu at the top two lines of
V.  In addition, the Z-System "arrow" keys are also supported.

V uses an in-memory cache to make the most recently read sectors
of a file available for re-viewing without additional disk reads.
This allows  reverse viewing of crunched files, up to the limit
of available memory.  If, when going in reverse, the cache is
exhausted, V will automatically restart the uncrunching process
from the beginning of the file and display the first lines.

Viewing of adjacent lines/screens is rapid for both ascii and
crunched files.  Going to the End is also quick in ascii, but
results in some delay uncrunching a large file -- the entire
file must be uncrunched first.

The termcap requirement is the addition of three strings to the
standard Z-System termcap.  These definitions are already setup
in files of type ".NZT" (New Z-System Termcap), available on
major Z-Nodes.  If your terminal isn't already there, you can add
definitions following the initialization and deinitialization
strings.   Here's an example for the Wyse-50.  Note carefully
that there are now two DIFFERENT termcap definitions in
use.  (At this writing the extended definition has not yet been
released.)  V will work with either, provided they conform to
the definition of the extended-tcap flag bit.

	DEFB	'TERMINALNAME'	; 13 bytes
	db	0		; reserved
	db	flags14		; if bit 7 is set, this is an
				; EXTENDED termcap
	db	flags15

	[ next part of termcap omitted...]

	DEFB	ESC,')',0	; SO - Standout on string
	DEFB	ESC,'(',0	; SE - Standout end string
	DEFB	0		; TI - Terminal init string
	DEFB	0		; TE - Terminal de-init string
;
; Extensions to Standard TCAP
;
	DEFB	ESC,'R',0	; DL - Line Delete
	DEFB	ESC,'E',0	; IL - Line Insert
;
; If this is an EXTENDED tcap (bit 7 of flag14 set), the
; next two strings must be present (or 2 nuls).
; If bit 7 of flag14 is NOT set, these two strings must NOT
; be present.
; V does not use these two strings, but must be able to find the 
; following clear-to-end-of-screen string correctly.

	defb	ESC,'G%+0',0	; SA - set attributes
	defb	'0248',0	; AT - available attributes
;
	DEFB	ESC,'Y',0	; CD - Clear to End of Screen String
;