home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR8 / VDIFF05.ZIP / VDIFF.DOC next >
Text File  |  1993-04-04  |  5KB  |  107 lines
  1.  
  2.                    VDiff v0.50 Documentation 04/04/93
  3.  
  4.                           A Full Screen Visual
  5.  
  6.             Line-By-Line DIFF Utility For The SemWare Editor
  7.  
  8.                           Written By Jim Susoy
  9.  
  10.  
  11. All suggestions/bug reports are welcome, please send them to me via internet
  12. mail at susoy@qdeck.com or through the SemWare support BBS.
  13.  
  14. If you make any interesting changes, please send them to me and I'll
  15. incorporate them into the next release.
  16.  
  17. Description:
  18.  
  19.     This macro set provides a line-by-line diff of two files.  It highlights
  20.     all the differences currently on the screen at once, providing a
  21.     "visual" diff. As you move down through the files, unresolved differences
  22.     scroll of the top of the screen and new differences (if any) become
  23.     highlighted as they come onto the screen.
  24.  
  25. Features:
  26.  
  27.     o    Highlights all visible differences at once.
  28.     o    Displays both files side by side in vertical windows (file1 & file2)
  29.     o    Scrolling of files is syncronized
  30.     o    file2 may be scrolled independently of file1
  31.     o    file2 may be edited directly to resolve differences
  32.  
  33.  
  34. Usage:    mVisualDiff(integer highattr)
  35.  
  36.             Vdiff will prompt you for the two files to diff.
  37.             highattr is the attribute VDiff should use to
  38.             highlight the DIFFs betweeen the files.
  39.  
  40.             When envoked, VDIFF will prompt for file1, this is the file that
  41.             you want to compare from (not the file that differences will
  42.             be resolved in).  file2 is the file that differences are resolved
  43.             in (though you can copy lines from file2 to file1, you can't
  44.             directly edit file1).  After file2's filename has been entered,
  45.             VDIFF will display both files on the screen in vertical window.
  46.          The window on the left is file1, and the window on the right is
  47.          file2.  All differences between the two files that are currently
  48.          visible on the screen are automatically highlighted in file2 (the
  49.          right window).  This means that if 12 lines do not match, 12 lines
  50.          will be highlighted in file2 simultaneously.
  51.  
  52.          You can then cursor or page down to the line and replace the line
  53.          in file2 with the line in file1 by pressing <CTRL CursorRight>.
  54.          If you wanted to copy the line the other way, (file2 to file1) you
  55.          would press <CTRL CursorLeft>.
  56.  
  57.          I use this alot to compare functions within files.  Since other
  58.          changes in the files may mean that a given function may not start
  59.          on the same line in both files, you can scroll file2 independently
  60.          of file1.  This allows you to get to the start of the function you
  61.          want in file1, then adjust file2 (using <ALT CursorUp> and
  62.          <ALT CursorDown>) so that both are starting on the same screen row.
  63.          Once they are in sync on the screen, you can use the syncronized
  64.          command to move through the functions and resolve the differences.
  65.  
  66.          That's all there is to it.  It's real simple to use (No Fluff At ALL!)
  67.          I am currently working on a version that takes the output from a
  68.          DIFF utility (Currently GNU's DIFF) and uses that information to
  69.          highlight (and resolve) differences between files.  This will be a
  70.          TRUE byte-by-byte diff when it is done (as opposed to a line DIFF).
  71.  
  72. Keys:
  73.  
  74.     The following keys are available when you are viewing/resolving the
  75.     differences between files:
  76.  
  77. <Escape>             Done
  78.  
  79. Syncronized Actions:
  80. <CursorUp>           Moves Syncronized cursor up
  81. <CursorDown>            Moves syncronized cursor down
  82. <CursorRight>        Moves Syncronixed cursor right
  83. <CursorLeft>            Moves Syncronixed cursor left
  84. <PgUp>               Moves syncronized cursor one page up
  85. <PgDn>               Moves syncronized cursor one page down
  86. <CTRL PgUp>          Moves syncronized cursor to the start of the file
  87. <CTRL PgDn>          Moves syncronized cursor to the end of the file
  88. <CTRL Home>                Moves syncronized cursor to the first line in the window
  89. <CTRL End>           Moves syncronized cursor to the last line in the window
  90. <CTRL CursorRight>   Moves the line on the syncronized cursor in the file1
  91.                             (the left window) to the corresponding line in file2
  92.                             (the right window)
  93. <CTRL CursorLeft>        Moves the line on the syncronized cursor in file2
  94.                             (the right window) to the corresponding line in file1
  95.                             (the left window)
  96. <CTRL CursorUp>      Rolls the text up in both windows through the
  97.                             syncronized cursor (cursor doesn't move)
  98. <CTRL CursorDown>        Rolls the text down in both windows through the
  99.                             syncronized cursor (cursor doesn't move)
  100.  
  101. Actions That Only Affect file2:
  102. <ALT CursorUp>            Rolls the text in file2 up one line through the cursor
  103. <ALT CursorDown>        Rolls the text in file2 down one line through the cursor
  104. <All Standard Keys>    That are not remapped as above
  105.  
  106.  
  107.