home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / v.lbr / VCOMP.HZP / VCOMP.HLP
Encoding:
Text File  |  1991-11-18  |  6.4 KB  |  164 lines
  1. ;
  2. VCOMP: VISUAL TEXT FILE COMPARISON                 ( V  - General Information)
  3.  
  4.                 <<<<  VCOMP 2.0  COMMANDS  >>>>
  5.  
  6.  
  7.     ;   Start               E   Echo cmd                  G   Find
  8.     A   End                 Z   Switch - <sp>             H   Rpt Find
  9.     F   Next Screen         N   Next Screen - <cr>        O   Mark
  10.     J   Prev Screen         C   Compare                   0   Go Mark
  11.     D   Next Line           U   Re-sync  - <tab>          P   Print from Mark
  12.     K   Prev Line           Q   Sync Char                 T   Type Line
  13.     S   Jump 5 Lines        W   Window                    I   Init Printer
  14.     L   Back 5 Lines        R   Read More                 X   Exit 
  15. :v
  16.           VCOMP - VISUAL TEXT FILE COMPARISON 
  17.  
  18. SYNTAX:    VCOMP [DU:|DIR:]FILE1 [DU:|DIR:][FILE2] [/]
  19.     Both files are text.   "/" automatically wildcards the  file names  to
  20.         save typing.   In that case  the  first  match on the disk is the file
  21.         opened.  If no FILE2, then FILE1 is read twice.
  22.  
  23. SYSTEM:    Z3CPR TOOL.  Install with Z3INS.  Requires CRT with at least 80 cols x
  24.     24 lines plus TCAP support for EREOL, CLS, and addressable cursor.
  25.  
  26. PURPOSE:
  27.     1) Find the differences between two similar files.
  28.        Example:  VCOMP VERS1.Z80 VERS2.Z80 
  29.              VCOMP TEXT1 TEXT1.BAK
  30.     2) View dissimilar files simultaneously.
  31.        Example:  VCOMP MYPROG.Z80 MYPROG.HLP
  32.  
  33. Each file is displayed on a half screen.  Control characters are displayed  in
  34. standout  mode.    Lines  wider  than  the  CRT  are  truncated.    A  printer
  35. initialization string (up to 16 bytes) may be installed (see INIT).
  36.  
  37.  
  38.  
  39. Version 2.0 Notes:
  40. 1. Easily customized with its installation program.
  41. 2. Screen display has been cleaned up.
  42. 3. The command line may be wild-carded with the "/" option (same as BCOMP).
  43. 4. Supports file date/time stamping via new DSLIB.
  44. 5. Console input and output via direct bios calls.
  45. 6. Added calls to TINIT, DINIT.
  46. 7. Program, including help screen, is 5k.
  47.  
  48. Version 1.3 Notes:
  49. 1. READ command has been fixed.   When  a text doesn't  fit in memory,  a READ
  50.    will keep the last screen and read in another chunk of text.
  51. 2. RSX check on memory allocation.
  52. 3. Many minor changes and buglet fixes.
  53.  
  54.  
  55.  
  56. Version 1.2 Notes:
  57. 1. The divider and filename displays have been moved left to avoid  a possible
  58.    line wrap.
  59. 2. Command line syntax altered to  permit specifying du:  only for FILE2 (e.g.
  60.    <VCOMP file1 b0:>  will  compare  same  file  on  default  and  b0:  It  is 
  61.    necessary to specify file in default du: first,  if any.   <VCOMP b0:file1>
  62.    will get two looks at b0:file1 and NOT comparison with file1 in default du:
  63. :q c u
  64.                  COMPARING TEXTS  
  65.  
  66.  
  67.  
  68.  C - AUTO-COMPARE:   
  69.     Find the next line in which the files differ.   Display  both files at
  70.     that line.  If the display did not start with the files in sync,  then
  71.     you will only  move  a single line ahead.   If no difference is found,
  72.     an EOF message shows on the status line.
  73.  
  74.  <TAB> - RE-SYNC: 
  75.     Re-align  display of  files  to  facilitate  comparison.   The command
  76.     simply uses  a  preset character for  a  double FIND.   When comparing 
  77.     source code files, the default ':' will line up on the next label.
  78.  
  79.  Q - SET SYNC:   (default is ':')
  80.     Ask for  a character to RE-SYNC to.   May be set on fly.   Alternative 
  81.         to  the default setting  might  be <tab>  to paragraph  align two text 
  82.         files.
  83. :o 0 p i t
  84.                 MARK AND PRINT 
  85.  O - MARK: 
  86.     Set  a pointer to the top line of the current screen.   MARK is both a
  87.     place marker AND the beginning of text sent to the  printer.
  88.  
  89.  0 - GO TO MARKER: 
  90.     Return  display to  marker  set  with  the O  command.   The marker is 
  91.     is initialized to the beginning of the text.
  92.  
  93.  P - PRINT: 
  94.     List text from Mark  to bottom of current screen.   Only the currently
  95.     selected file will be printed.  ESC or ^C will halt the listing.
  96.  
  97.  I - INITIALIZE PRINTER: 
  98.     Send installed initialization string to printer.   The installation is
  99.     done with VCINST.COM.  Default values are: 1,0D,00 ... 00.
  100.  
  101.  T - TYPE: 
  102.     Type a line to be sent to printer (e.g. comments, labels).  <CR> sends
  103.         a return.  Can also send ^L line feed or other controlcharacters which
  104.         the BDOS will pass.  Edit the line with ^X, del, etc.
  105. :z e w
  106.              MOVING BETWEEN TEXTS 
  107.  
  108.  
  109.  
  110.  
  111.  <sp> - SWITCH FILES:   Toggle
  112.     Swap files.  Cursor moves from one text to the other.
  113.  
  114.  E - ECHO MODE:   Toggle
  115.     Echo mode repeats  a command for  both files  so  you can move through
  116.     them in tandem.  To avoid confusion (?) R - READ MORE and P - PRINT do
  117.         NOT echo.   You can do  double  finds,  set double markers, etc.   The 
  118.         screen divider shows a reminder when in echo mode.
  119.  
  120.  W - WINDOW:      Toggle
  121.     View  one  of  the  files  on  a  full screen.   Disables  E, Y, and U 
  122.         functions.
  123. :g h r
  124.                  FIND 
  125.  
  126.  G - FIND: 
  127.     Find a string  (up to 20 characters).   The search is forward only and
  128.     is case insensitive.   Since the BDOS read string function is used, it 
  129.         is best to  avoid entering ^P.   If the  display is  garbled  somehow,
  130.     refresh the screen by entering "?", then go back to viewing.
  131.  
  132.  H - REPEAT FIND:     
  133.     Repeat find  on  the  same string.   The  string  is  not changed when
  134.     switching files,  so a FIND in one file and  a RPT FIND  in  the other
  135.     will have the desired effect.
  136.  
  137.  
  138.                  READ 
  139.  
  140.  R - READ: 
  141.     If VCOMP printed  a "memory full" message, additional text may be read
  142.     in.   The new text replaces text currently in memory.   If there is no 
  143.         more to read, you may start again at the top of the file.
  144. :a s d f g h j k l n ; x
  145.              MOVING THROUGH TEXT 
  146.  
  147.         Left Hand                             Right Hand 
  148.        -----------                           ------------
  149.  A   End of text.                      ;   Start of text.
  150.  
  151.  S   Ahead 5.  Top line centers.       L   Back 5.  Bottom line centers.
  152.  
  153.  D   Next line.                        K   Previous line.
  154.  
  155.  F   Next screen.                      J   Previous screen.
  156.  
  157.  G   Find a string.                    H   Repeat find.
  158.      -The search is forward only.
  159.      -Case is ignored.
  160.      -If found, the string is on the top line.
  161.      -If not found, a message says so.
  162.  
  163.  <cr>   Next screen, both files.  (Same as echo F)        X   Exit
  164.