;
VCOMP: VISUAL TEXT FILE COMPARISON                 (V - General Information)
 
  		       <<<< VCOMP 1.3  COMMANDS >>>>
 ---                                                             ---
|ESC|  Halt Listing                                  Go To Mark | 0 |
 ---                                                             ---
     Set           Echo                 Auto   Re-
     Sync  Window  Mode   Read  Type  Compare  Sync   Init   Mark  Print        
     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
    | Q |  | W |  | E |  | R |  | T |  | Y |  | U |  | I |  | O |  | P |
     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
    | A |  | S |  | D |  | F |  | G |  | H |  | J |  | K |  | L |  | ; |
     ---    ---    ---    ---    ---    ---    ---    ---    ---    ---
     End   Next   Next   Next    Find   Rpt     Up     Up     Up    Top
           x 5    Line  Screen          Find  Screen  Line   x 5

   X - Exit    <sp> - Switch Files    <cr> - Next Screens    <?,/> - Help
:v
		  VCOMP - VISUAL TEXT FILE COMPARISON

SYNTAX:	VCOMP [DU:|DIR:]FILE1 [DU:|DIR:][FILE2]
	Both files are text.  If no FILE2, then FILE1 is read twice.

SYSTEM:	Z3CPR TOOL.  Install with Z3INS.  Requires CRT with at least 80 cols x
	24 lines plus TCAP support for EREOL, CLS, and addressable cursor.

PURPOSE:
	1) Find the differences between two similar files.
	   Example:  VCOMP VERS1.Z80 VERS2.Z80 
		     VCOMP TEXT1 TEXT1.BAK
	2) View dissimilar files simultaneously.
	   Example:  VCOMP MYPROG.Z80 MYPROG.HLP

Each file is displayed on a half screen.  Control characters are dispslayed
in standout mode.  Lines wider than the CRT are truncated.  A printer
initialization string (up to 16 bytes) may be installed (see INIT).

Version 1.3 Notes:
1. READ command has been fixed.  When a text doesn't fit in memory, a READ
   will keep the last screen and read in another chunk of text.
2. RSX check on memory allocation.
3. Many minor changes and buglet fixes.

Version 1.2 Notes:
1. The divider and filename displays have been moved left to avoid a possible
   line wrap.
2. Command line syntax altered to permit specifying du: only for FILE2
   e.g. <VCOMP file1 b0:> will compare same file on default and b0:  It is
   necessary to specify file in default du: first, if any.  <VCOMP b0:file1>
   will get two looks at b0:file1 and NOT comparison with file1 in default du:

:q y u
			    COMPARING TEXTS 




Y - AUTO-COMPARE:
	Find the next line in which the files differ.  Display both files at
	that line.  If the display did not start with the files in sync, then
	you will only move a single line ahead.  If no difference is found,
	an EOF message shows on the status line.

U - RE-SYNC:
	Re-align display of files to facilitate comparison.  The command
	simply uses a preset character for a double FIND.  When comparing 
	source code files, the default ':' will line up on the next label.

Q - SET SYNC:
	Ask for a character to RE-SYNC to.  Default is ':'.
:o 0 p i t
			   MARK AND PRINT
O - MARK:
	Set a pointer to the top line of the current screen.  MARK is both
	a place marker AND the beginning of text sent to the  printer.

0 - GO TO MARKER:
	Return display to marker set with the O command.
	The marker is initialized to the beginning of the text.

P - PRINT:
	List text from Mark to bottom of current screen.  Only the currently
	selected file will be printed.  ESC or ^C will halt the listing.

I - INITIALIZE PRINTER:
	Send installed initialization string to printer.  Locations are:
	   10BH - # of bytes in string (up to 16 [10H]).  10CH - bytes.
	   Currently these are: 1,0D,00 ... 00.

T - TYPE:
	Type a line to be sent to printer. (e.g. comments, labels)
	<CR> sends a return.  Can also send ^L line feed or other control
	characters which the BDOS will pass.  Edit the line with ^X, del, etc.
:e w  
			MOVING BETWEEN TEXTS




<sp> - SWITCH FILES:  Toggle
	Cursor moves from one text to the other.

E - ECHO MODE:  Toggle
	Echo mode repeats a command for both files so you can move through
	them in tandem.  To avoid confusion (?) R - READ MORE and 
	P - PRINT do NOT echo.  You can do double finds, set double markers, 
	etc.  The screen divider shows a reminder when in echo mode.

W - WINDOW:     Toggle
	View one of the files on a full screen.  Disables E,Y, and U functions.
:g h r
				FIND

G - FIND:
	Find a string (up to 20 characters).  The search is forward only
	and is case insensitive.  Since the BDOS read string function is used,
	it is best to avoid entering ^P.  If the display is garbled somehow,
	refresh the screen by entering "?", then go back to viewing.

H - REPEAT FIND:	
	Repeat find on the same string.  The string is not changed when
	switching files, so a FIND in one file and a RPT FIND in the other
	will have the desired effect.


				READ

R - READ:
	If VCOMP printed a "memory full" message, additional text may be
	read in.  The new text replaces text currently in memory.  If there
	is no more to read, you may start again at the top of the file.
:a s d f g h j k l ;
				MOVING THROUGH TEXT

       Left Hand                           Right Hand
       ---------                           ----------
A  End of text.                     ;  Start of text.

S  Ahead 5.  Top line centers.      L  Back 5.  Bottom line centers.

D  Next line.                       K  Previous line.

F  Next screen.                     J  Previous screen.

G  Find a string.                   H  Repeat find.
	 -The search is forward only.
	 -Case is ignored.
	 -If found, the string is on the top line.
	 -If not found, a message says so.

<cr>  Next screen, both files.  (Same as echo F)
nd, the string is on the top line.
	 -If not found, a message says so.

<cr>  Next screen, both files.  (Same as