home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / vrac / vmerge12.zip / README.TXT < prev    next >
Text File  |  1995-06-19  |  8KB  |  256 lines
  1.  
  2.  
  3.                                VMERGE
  4.  
  5.                              Version 1.2
  6.  
  7.                       Visual Diff / Merge Program
  8.  
  9.  
  10.  
  11.            1. Overview
  12.            -----------
  13.  
  14.         VMERGE is an easy to use program designed to help people in
  15.      merging files.
  16.  
  17.         Those who have tried once to combine two similar versions of
  18.      a program knows how difficult it is. There are always some lines
  19.      which get forgotten or misplaced.
  20.  
  21.         There are some command-line utilities, able of comparing files
  22.      and producing list of differences between them, but these programs
  23.      will often scarcely help, because one should still perform a merge
  24.      manually, cutting lines alternately from the files.
  25.  
  26.         VMERGE will make merge much easier by letting you to choose
  27.      between the differing portions in a single mouse click.
  28.  
  29.         VMERGE is only a visual shell. It does not contain a file-
  30.      comparing engine and uses FC program ( which comes with MS-DOS ).
  31.      But its interface is quite natural and have proved to be effective
  32.      in merges. I hope it will help you too.
  33.  
  34.  
  35.  
  36.         2. Software license
  37.         -------------------
  38.  
  39.         VMERGE 1.2 is not a Public Domain and is not a freeware.
  40.      VMERGE 1.2 is copyright (c) 1995 by Olga Golosovker.
  41.      Users are granted without any charge the right to reproduce,
  42.      distribute and use copies of VMERGE 1.2, subject to the following
  43.      limitations, provided that all the supplied files should be hold intact.
  44.      VMERGE 1.2 or any of the accompanying files may not be modified in
  45.      any respect, including disassembling or patching, without explicit
  46.      permission of the author.
  47.  
  48.         The author hereby disclaims all  warranties  relating to this
  49.      software, whether expressed or implied, including without
  50.      limitation any implied warranties of merchantability or fitness
  51.      for a  particular  purpose.  The author will not be liable for
  52.      any special, incidental, consequential, indirect or similar
  53.      damages due to loss of data or any other reason. This includes,
  54.      but is not limited to, computer hardware, computer software,
  55.      operating systems, and any computer or computing accessories.
  56.      The person using the software bears all risk as to the quality
  57.      and performance of the software.
  58.  
  59.         The author is in no way obligated to support for VMERGE, or
  60.      to provide future versions of VMERGE 1.2 unless the user registers
  61.      for them (see registration information).
  62.  
  63.  
  64.  
  65.         3. Registration information
  66.         ---------------------------
  67.  
  68.  
  69.         To become a registered user of VMERGE, complete and return this
  70.      form along with the indicated license fee.  The license fee should be
  71.      paid by check in U.S. dollars. Once you register for the program, you
  72.      will be sent the most current version of the program(request the disk
  73.      if you need). If you register for the future updates you will be
  74.      notified about all the future updates of the program which you might
  75.      receive for postal fee only.
  76.  
  77.      Remit to:      Olga Golosovker,
  78.                     Havacelet 16/10,
  79.                     Nesher,
  80.                     Israel.
  81.  
  82.  
  83.      ====================    ORDER     FORM   ==========================
  84.  
  85.  
  86.         Name: ___________________________________________________
  87.  
  88.      Company: ___________________________________________________
  89.  
  90.      Address: ___________________________________________________
  91.  
  92.               ___________________________________________________
  93.  
  94.  
  95.      Please accept this registration fee for VMERGE v1.2.
  96.  
  97.      [ ] Please send me (check the box) :
  98.  
  99.         [ ]  Disk with the program by mail.
  100.         [ ]  The program by e-mail (address attached).
  101.               Internet E-mail: ___________________________________________
  102.  
  103.  
  104.      ________________________________________     _______________
  105.                      SIGNED                             DATE
  106.  
  107.  
  108.      Registration fee - Choose one or more of the following options:
  109.  
  110.  
  111. ____  VMERGE v1.2 registration.......................$ 15.00     $ _______
  112.       (Does not include disk).
  113.  
  114. ____  VMERGE v1.2 and future updates registration....$ 20.00     $ _______
  115.       (Does not include disk).
  116.  
  117. ____  Add $2 if you require the 3 1/2" disk                      $ _______
  118.  
  119.  
  120. ____  Postage, prepaid...............................$  3.00     $ _______
  121.  
  122.  
  123.                                                       TOTAL      $ _______
  124.  
  125.  
  126.  
  127.         4. Using VMERGE
  128.         ----------------
  129.  
  130.              a) General
  131.              -----------
  132.  
  133.         VMERGE main window contain two file panes and menu. There are 3
  134.      items in the menu:    File, Options and About. File opens a submenu
  135.      with the following items:
  136.          File 1 - for choosing the first file name
  137.          File 2 - for choosing the second file name
  138.          Diff   - display files differences
  139.          Write  - write the results (available only for registered users)
  140.          Quit   - just this.
  141.      Options opens a submenu with 2 items:
  142.          Line Numbers - display line numbers along with text
  143.          Compress spaces - consider a sequence of white spaces as a single
  144.                           space
  145.  
  146.      There is also a quick menu available in the file panes. It's opened
  147.      by pressing the right mouse button. The menu contains following items:
  148.          Next - go to the next differing segment
  149.          Previous  - go to the previous differing segment
  150.          Pick Left - chooses all the unresolved differences from the left file
  151.          Pick Right - the same from the left file
  152.          Unselect All - dismiss all the choices made so far
  153.  
  154.  
  155.              b) Merging files
  156.              ----------------
  157.  
  158.      1) Open files to be merged. The files will be displayed in file panes.
  159.         If "Line Numbers" option was selected then the lines will be
  160.         enumerated.
  161.  
  162.      2) Select Diff from File menu. The program will color the differing
  163.         sections of both files in 2 colors - green and yellow. Yellow lines
  164.         are blank lines that should be added to the file to match segment in
  165.         the second file. Lines are colored green if the matching lines
  166.         of second file either differ or are missing at all (in this case
  167.         lines of the second file are yellow colored).
  168.  
  169.      3) For each of the differing segments you should select one of the
  170.         files by clicking left mouse button over the colored text.
  171.         Selected segments will become blue.
  172.  
  173.      4) Select "Write" from the File menu and choose the output file name.
  174.         The results will be written to the file.
  175.  
  176.         NOTE : If the file already exists it will be overridden. The original
  177.                file will be saved under the name <name>.bak to prevent data
  178.                loss.
  179.  
  180.  
  181.           c) Keyboard shortcuts
  182.           ---------------------
  183.  
  184.        Ctrl+F1 - load left file
  185.        Ctrl+F2 - load right file
  186.        Ctrl+D  - display files differences
  187.        Ctrl+W  - write out the results.
  188.        Ctrl+N  - Next differing section
  189.        Ctrl+P  - Previous differing section
  190.  
  191.  
  192.           d) Warning messages
  193.           -------------------
  194.  
  195.     1) "Files are too different" - files differ too much. The program will
  196.       probably miss some of the differences, but most of them will still
  197.       be displayed.
  198.  
  199.     2) "You have unresolved differences" - there are differing segments
  200.       where none of the files was selected.
  201.  
  202.  
  203.  
  204.       5. Requirements
  205.       ---------------
  206.  
  207.     1) 80286+ Processor
  208.  
  209.     2) Windows 3.xx
  210.  
  211.  
  212.  
  213.       6. Known Bugs and Features
  214.       --------------------------
  215.  
  216.    *  VMERGE is unable to handle files larger than 64k.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.       7.  What is new in this version(relative to v1.03)
  223.       --------------------------------------------------
  224.  
  225.    *  Improved white spaces compression mode
  226.  
  227.    *  Does not use FC program
  228.  
  229.  
  230.  
  231.        8. Next version(V1.21) features .
  232.        ---------------------------------
  233.  
  234.     *  Files larger than 64k.
  235.  
  236.     *  Adjustable tab size
  237.  
  238.  
  239.  
  240.       9. Address
  241.       ----------
  242.  
  243.     stdmail:
  244.  
  245.         Olga Golosovker,
  246.         16/10 Havacelet,
  247.         Nesher,
  248.         Israel, 36731
  249.  
  250.      e-mail (Internet):
  251.  
  252.         olga@isg.co.il
  253.  
  254.  
  255.      I will be thankful for any comments and bug reports.
  256.