;
VCOMP: VISUAL TEXT FILE COMPARISON                 ( V  - General Information)
 
  		      <<<<  VCOMP 2.0  COMMANDS  >>>>


    ;   Start               E   Echo cmd                  G   Find
    A   End                 Z   Switch - <sp>             H   Rpt Find
    F   Next Screen         N   Next Screen - <cr>        O   Mark
    J   Prev Screen         C   Compare                   0   Go Mark
    D   Next Line           U   Re-sync  - <tab>          P   Print from Mark
    K   Prev Line           Q   Sync Char                 T   Type Line
    S   Jump 5 Lines        W   Window                    I   Init Printer
    L   Back 5 Lines        R   Read More                 X   Exit 
:v
		  VCOMP - VISUAL TEXT FILE COMPARISON 

SYNTAX:	VCOMP [DU:|DIR:]FILE1 [DU:|DIR:][FILE2] [/]
	Both files are text.   "/" automatically wildcards the  file names  to
        save typing.   In that case  the  first  match on the disk is the file
        opened.  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 displayed  in
standout  mode.    Lines  wider  than  the  CRT  are  truncated.    A  printer
initialization string (up to 16 bytes) may be installed (see INIT).



Version 2.0 Notes:
1. Easily customized with its installation program.
2. Screen display has been cleaned up.
3. The command line may be wild-carded with the "/" option (same as BCOMP).
4. Supports file date/time stamping via new DSLIB.
5. Console input and output via direct bios calls.
6. Added calls to TINIT, DINIT.
7. Program, including help screen, is 5k.

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 c u
			     COMPARING TEXTS  



 C - 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.

 <TAB> - 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:   (default is ':')
	Ask for  a character to RE-SYNC to.   May be set on fly.   Alternative 
        to  the default setting  might  be <tab>  to paragraph  align two text 
        files.
: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 
	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.   The installation is
	done with VCINST.COM.  Default values 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 controlcharacters which
        the BDOS will pass.  Edit the line with ^X, del, etc.
:z e w
			 MOVING BETWEEN TEXTS 




 <sp> - SWITCH FILES:   Toggle
	Swap files.  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 n ; x
			 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)        X   Exit
