home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / VC140.ZIP / MANUAL.DOC < prev    next >
Text File  |  1992-03-20  |  32KB  |  832 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                    Visual Compare
  16.  
  17.                                     Version 1.40
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                      A file comparison utility for programmers.
  49.  
  50.  
  51.         Copyright Notice
  52.  
  53.         Copyright (C) John R. Whitney 1991, 1992
  54.         All rights reserved.
  55.  
  56.  
  57.         Trademarks
  58.  
  59.         CompuServe is a registered trademark of CompuServe, Inc.
  60.  
  61.         IBM and OS/2 are registered trademarks of International Business
  62.         Machines Corporation.
  63.  
  64.         Lotus is a registered trademark of Lotus Development Corporation.
  65.  
  66.         Intel is a registered trademark of Intel Corporation.
  67.  
  68.         Microsoft is a registered trademark of Microsoft Corporation.
  69.  
  70.  
  71.         Disclaimer and Agreement
  72.  
  73.         Visual Compare is supplied as is, without any warranty.  To the
  74.         extent permitted under applicable law, Whitney Software, Inc.
  75.         disclaims all warranties, either express or implied, including but
  76.         not limited to implied warranties of merchantability and fitness for
  77.         a particular purpose.
  78.  
  79.         In no event shall Whitney Software, Inc. be liable for any damages
  80.         whatsoever (including, without limitation, damages for loss of
  81.         business profits, business interruption, loss of business
  82.         information, or other pecuniary loss) arising out of the use of or
  83.         inability to use this Whitney Software, Inc. product, even if Whitney
  84.         Software, Inc. has been advised of the possibility of such damages.
  85.         Some states do not allow the exclusion of liability for consequential
  86.         or incidental damages, so the above limitation may not apply to you.
  87.  
  88.         Visual Compare is a "shareware program" and is provided at no charge
  89.         to the user for evaluation.  Feel free to share it with your friends,
  90.         but you may not give it away altered or as part of another system.
  91.         The essence of "user-supported" software is to provide personal
  92.         computer users with quality software without high prices, and yet to
  93.         provide incentive for programmers to continue to develop new
  94.         products.  If you find this program useful and find that you are
  95.         using Visual Compare and continue to use Visual Compare after a
  96.         reasonable trial period, you must make a registration payment of $49
  97.         to Whitney Software, Inc.  The $49 registration fee will license one
  98.         copy for use on any one computer at any one time.  You must treat
  99.         this software just like a book.  An example is that this software may
  100.         be used by any number of people and may be freely moved from one
  101.         computer location to another, so long as there is no possibility of
  102.         it being used at one location while it's being used at another.  Just
  103.         as a book cannot be read by two different people at the same time.
  104.  
  105.  
  106.         Commercial users of Visual Compare must register and pay for their
  107.         copies of Visual Compare within 30 days of first use or their license
  108.         is withdrawn.  See the file LICENSE.DOC for a site-license agreement.
  109.  
  110.         Anyone distributing Visual Compare for any kind of remuneration must
  111.         first contact Whitney Software, Inc. for authorization.
  112.  
  113.         You are encouraged to pass a copy of Visual Compare along to your
  114.         friends for evaluation.  Please encourage them to register their copy
  115.         if they find that they can use it.  All registered users will receive
  116.         a copy of the latest version of Visual Compare.
  117.  
  118.  
  119.         Technical Support
  120.  
  121.         If you have any questions or comments regarding Visual Compare,
  122.         please send them to CompuServe ID 70661,3463 or:
  123.  
  124.         Whitney Software, Inc.
  125.         P.O. Box 4999
  126.         Walnut Creek, CA 94596 USA
  127.  
  128.  
  129.         Table of Contents
  130.         _____________________________________________________________________
  131.  
  132.  
  133.         Introduction ...................................................... 1
  134.  
  135.         Starting Visual Compare ........................................... 2
  136.  
  137.         Visual Mode ...................................................... 13
  138.  
  139.         Miscellaneous Notes .............................................. 14
  140.  
  141.         Version History .................................................. 15
  142.  
  143.  
  144.         Introduction                                                        1
  145.         _____________________________________________________________________
  146.  
  147.  
  148.         This manual describes how to use the Visual Compare program to
  149.         compare two program source files.  This manual and the Visual Compare
  150.         program were written for programmers.
  151.  
  152.         Using Visual Compare's visual mode you can easily see the differences
  153.         between two program source files and you can also selectively discard
  154.         differences in order to quickly undo some of the changes that were
  155.         made.
  156.  
  157.         Visual Compare requires an IBM Personal Computer or 100% compatible
  158.         running DOS version 2.1 or later or OS/2 version 1.1 or later.
  159.  
  160.         Visual Compare uses a compare algorithm that has been mathematically
  161.         proven to always produce a shortest possible sequence of insertions
  162.         and deletions that will convert file one to file two.
  163.  
  164.  
  165.         Starting Visual Compare                                             2
  166.         _____________________________________________________________________
  167.  
  168.  
  169.         There are two ways to control the start of Visual Compare:
  170.  
  171.         1. Through arguments specified on the Visual Compare command line.
  172.  
  173.         2. Through commands specified in the Visual Compare initialization
  174.            file.
  175.  
  176.  
  177.         Visual Compare Command Line
  178.  
  179.         Run Visual Compare with no arguments to see a list of the available
  180.         command line arguments.
  181.  
  182.         The form of the Visual Compare command line is as follows:
  183.  
  184.              VCOMP fileone filetwo [options]
  185.  
  186.  
  187.         VCOMP
  188.  
  189.         The name of the program module for the DOS version.  VCOMPP is the
  190.         name of the program module for the OS/2 version.
  191.  
  192.  
  193.         fileone
  194.  
  195.         The first of two files you wish to compare.
  196.  
  197.  
  198.         filetwo
  199.  
  200.         The second of two files you wish to compare.
  201.  
  202.  
  203.         If fileone or filetwo ends with a backslash (\) symbol, the filename
  204.         (file name and optional extension) from the other fileone or filetwo
  205.         command line argument is appended.  This can be convenient if file
  206.         one and file two are in different subdirectories and have the same
  207.         filename.  For example:
  208.  
  209.              VCOMP \OLD\ \NEW\SUPER.C
  210.  
  211.         is equivalent to
  212.  
  213.              VCOMP \OLD\SUPER.C \NEW\SUPER.C
  214.  
  215.  
  216.         Starting Visual Compare                                             3
  217.         _____________________________________________________________________
  218.  
  219.  
  220.         If fileone or filetwo has a file name consisting of an asterisk (*)
  221.         symbol, the file name from the other fileone or filetwo command line
  222.         argument is substituted.  For example:
  223.  
  224.              VCOMP *.BAK SUPER.C
  225.  
  226.         is equivalent to
  227.  
  228.              VCOMP SUPER.BAK SUPER.C
  229.  
  230.  
  231.         options
  232.  
  233.         The following options may be specified with a leading / or -,
  234.         whichever you prefer:
  235.  
  236.         /B
  237.  
  238.         Same as the BLACKANDWHITE initialization file command.
  239.  
  240.         Use /B to tell Visual Compare that you have a monochrome display
  241.         attached to your computer.
  242.  
  243.         Visual Compare can usually determine whether you have a color or
  244.         monochrome display.  If you have a color display, Visual Compare
  245.         takes advantage of this and uses colors on the screen.
  246.  
  247.         However, if you have a CGA (Color Graphics Adapter), Visual Compare
  248.         can't tell whether you have a monochrome or color display.  Since
  249.         Visual Compare will assume you have a color display, you may wish to
  250.         use /B to tell Visual Compare otherwise.
  251.  
  252.  
  253.         /Tn
  254.  
  255.         2-64
  256.         Default value: 8
  257.  
  258.         Same as the TABWIDTH initialization file command.
  259.  
  260.         Specifies the tab width to be used when expanding tabs or compressing
  261.         spaces.
  262.  
  263.  
  264.         /25
  265.  
  266.         Displays 25 lines in visual mode.
  267.  
  268.  
  269.         Starting Visual Compare                                             4
  270.         _____________________________________________________________________
  271.  
  272.  
  273.         /43
  274.  
  275.         Displays 43 lines in visual mode if you have an EGA (Enhanced
  276.         Graphics Adapter).
  277.  
  278.  
  279.         /50
  280.  
  281.         Displays 50 lines in visual mode if you have a VGA (Video Graphics
  282.         Array).
  283.  
  284.  
  285.         /S[-]
  286.  
  287.         Writes an edit script to standard output that will consist of a
  288.         shortest possible sequence of insertions and deletions that will
  289.         convert file one to file two.
  290.  
  291.         Specify /S- to write the edit script in reverse order (from the end
  292.         of file to the beginning of file).  This can be useful if you are
  293.         using an editor to convert file one to file two using the edit
  294.         script, since modifying the end of file one will not effect the line
  295.         numbers in the edit script that refer to earlier lines in file one.
  296.  
  297.  
  298.         /C
  299.  
  300.         Writes a composite file to standard output that is the same as the
  301.         composite file displayed in visual mode except that strings are used
  302.         to delimit text unique to file one or file two instead of colors.
  303.  
  304.         Use the ONESTART, ONEEND, TWOSTART, and TWOEND initialization file
  305.         commands to specify the strings used to delimit text unique to file
  306.         one or file two.  By default, ONESTART equals "$$$$$  fileone START
  307.         $$$$$", ONEEND equals "$$$$$  fileone END  $$$$$", TWOSTART equals
  308.         "$$$$$  filetwo START  $$$$$", and TWOEND equals "$$$$$  filetwo END
  309.         $$$$$."  Where "fileone" and "filetwo" represent the fileone and
  310.         filetwo command line arguments.
  311.  
  312.         One reason you might use this option is to run Visual Compare from
  313.         within your editor in order to display output similar to that
  314.         displayed in visual mode, in an editor window while you edit file two
  315.         or file one in another editor window.
  316.  
  317.  
  318.         Starting Visual Compare                                             5
  319.         _____________________________________________________________________
  320.  
  321.  
  322.         /D
  323.  
  324.         Writes a file to standard output that consists of information about
  325.         each difference.  The information consists of the corresponding file
  326.         positions for file one and file two, whether the difference is an
  327.         insertion or deletion, and the number of lines inserted or deleted.
  328.  
  329.         You might use this option to interface a program of your own design
  330.         to Visual Compare.
  331.  
  332.  
  333.         /En
  334.  
  335.         0-32736
  336.         Default value: 32736
  337.  
  338.         The edit distance is defined as the length of a shortest possible
  339.         sequence of insertions and deletions that will convert file one to
  340.         file two.
  341.  
  342.         Use /En to set the maximum edit distance.  If you specify a value
  343.         greater than 32736, Visual Compare will use 32736.  If while
  344.         comparing files the maximum edit distance is exceeded, Visual Compare
  345.         will display an appropriate message and abort.
  346.  
  347.         Use this option if you are comparing files that may be too different
  348.         for the comparison to be useful and you don't want to wait for Visual
  349.         Compare to complete the comparison if the comparison won't be useful.
  350.  
  351.  
  352.         /I
  353.  
  354.         Same as the IGNORE initialization file command.
  355.  
  356.         Ignores leading space and tab characters when comparing lines.  Use
  357.         /I if you are not interested in changes in the indentation of lines.
  358.  
  359.  
  360.         /K
  361.  
  362.         Same as the CASE initialization file command.
  363.  
  364.         Considers upper-case and lower-case letters equivalent when comparing
  365.         lines.
  366.  
  367.  
  368.         Starting Visual Compare                                             6
  369.         _____________________________________________________________________
  370.  
  371.  
  372.         Visual Compare Initialization File
  373.  
  374.         Visual Compare automatically processes an initialization file called
  375.         VCOMP.INI at the start of execution.
  376.  
  377.         Visual Compare first looks for VCOMP.INI in the current working
  378.         directory.  If it doesn't find VCOMP.INI, it next looks in the
  379.         directories specified by the PATH environment variable.
  380.  
  381.         The initialization file commands can be abbreviated.  For example,
  382.         the TABSOUT command can be entered as TABS, TABSO, TABSOU, or
  383.         TABSOUT.  The shortest legal abbreviation for a command is indicated
  384.         by showing that portion of the command in uppercase and the rest of
  385.         the command in lowercase.
  386.  
  387.         Some of the initialization file commands have command line option
  388.         counterparts.  If both the initialization file command and the
  389.         corresponding command line option are specified, the command line
  390.         option will override.
  391.  
  392.         The available initialization file commands are as follows:
  393.  
  394.         Attributes
  395.  
  396.         Use ATTRIBUTES to control the colors Visual Compare uses on the
  397.         screen.
  398.  
  399.         An attribute value is associated with each type of field that Visual
  400.         Compare displays.  The following table lists the seven different
  401.         field types displayed by Visual Compare.  Use ATTRIBUTES to specify
  402.         an attribute value for each field type, in the order of the table
  403.         below.
  404.  
  405.         Field                Description
  406.         ----------------------------------------------------------
  407.         Common               lines common to file one and file two
  408.         Delete               lines deleted from file one
  409.         Insert               lines inserted from file two
  410.         Function             function key and file name lines
  411.         Window               help and prompt windows
  412.         Error                error message windows
  413.         Key                  keys in help and prompt windows
  414.  
  415.         Attribute values are numbers ranging from 0 to 255.  Different
  416.         attribute values cause text to appear in different colors,
  417.         highlighted, blinking, etc.  On most display adapters that handle
  418.         color, you can use the following table to determine the attribute
  419.         value corresponding to a given color.  Add the number corresponding
  420.         to the desired foreground color to the number corresponding to the
  421.         desired background color.  To also get blinking, add 128.
  422.  
  423.  
  424.         Starting Visual Compare                                             7
  425.         _____________________________________________________________________
  426.  
  427.  
  428.         Foreground           Background
  429.         -------------------------------
  430.         0 black              0 black
  431.         1 blue               16 blue
  432.         2 green              32 green
  433.         3 cyan               48 cyan
  434.         4 red                64 red
  435.         5 magenta            80 magenta
  436.         6 brown              96 brown
  437.         7 white              112 white
  438.         8 gray
  439.         9 light blue
  440.         10 light green
  441.         11 light cyan
  442.         12 light red
  443.         13 light magenta
  444.         14 yellow
  445.         15 bright white
  446.  
  447.         On a MDA (Monochrome Display Adapter), the available attribute values
  448.         are 7 for normal text, 15 for highlighted text, 65 for underlined
  449.         text, and 112 for reverse video text.  To also get blinking, add 128
  450.         to any of these values.
  451.  
  452.         Examples:
  453.  
  454.              ATTRIBUTES 27 28 26 30 63 79 15
  455.  
  456.         The default attribute values used by Visual Compare on a CGA (Color
  457.         Graphics Adapter), an EGA (Enhanced Graphics Adapter), or a VGA
  458.         (Video Graphics Array).
  459.  
  460.              ATTRIBUTES 7 112 15 7 112 112 15
  461.  
  462.         The default attribute values used by Visual Compare on a MDA
  463.         (Monochrome Display Adapter).
  464.  
  465.  
  466.         Starting Visual Compare                                             8
  467.         _____________________________________________________________________
  468.  
  469.  
  470.         Blackandwhite
  471.  
  472.         Same as the /B command line option.
  473.  
  474.         Use BLACKANDWHITE to tell Visual Compare that you have a monochrome
  475.         display attached to your computer.
  476.  
  477.         Visual Compare can usually determine whether you have a color or
  478.         monochrome display.  If you have a color display, Visual Compare
  479.         takes advantage of this and uses colors on the screen.
  480.  
  481.         However, if you have a CGA (Color Graphics Adapter), Visual Compare
  482.         can't tell whether you have a monochrome or color display.  Since
  483.         Visual Compare will assume you have a color display, you may wish to
  484.         use BLACKANDWHITE to tell Visual Compare otherwise.
  485.  
  486.  
  487.         Case
  488.  
  489.         Same as the /K command line option.
  490.  
  491.         Use CASE to tell Visual Compare to consider upper-case and lower-case
  492.         letters equivalent when comparing lines.
  493.  
  494.  
  495.         EXPanded
  496.  
  497.         YES or NO
  498.  
  499.         Visual Compare keeps the contents of the files you are comparing in
  500.         memory.  The DOS version of Visual Compare can use up to four
  501.         megabytes of DOS and EMS (Lotus-Intel-Microsoft Expanded Memory
  502.         Specification, version 3.0 or later) memory or DOS and XMS (eXtended
  503.         Memory Specification) memory to store your files.  If Visual Compare
  504.         detects that EMS memory is present in your system, it will
  505.         automatically use it.  If EMS memory is not detected and XMS memory
  506.         is detected, Visual Compare will automatically use XMS memory.
  507.  
  508.         The EXPANDED command is ignored by the OS/2 version of Visual
  509.         Compare.
  510.  
  511.         Use EXPANDED NO to tell Visual Compare to ignore any EMS memory in
  512.         your system, and to use only DOS and possibly XMS memory.  You may
  513.         need to use EXPANDED NO if your EMS driver is not compatible with
  514.         Visual Compare.  You may also want to use EXPANDED NO for performance
  515.         reasons.
  516.  
  517.  
  518.         Starting Visual Compare                                             9
  519.         _____________________________________________________________________
  520.  
  521.  
  522.         EXTended
  523.  
  524.         YES or NO
  525.  
  526.         Visual Compare keeps the contents of the files you are comparing in
  527.         memory.  The DOS version of Visual Compare can use up to four
  528.         megabytes of DOS and EMS (Lotus-Intel-Microsoft Expanded Memory
  529.         Specification, version 3.0 or later) memory or DOS and XMS (eXtended
  530.         Memory Specification) memory to store your files.  If Visual Compare
  531.         detects that EMS memory is present in your system, it will
  532.         automatically use it.  If EMS memory is not detected and XMS memory
  533.         is detected, Visual Compare will automatically use XMS memory.
  534.  
  535.         The EXTENDED command is ignored by the OS/2 version of Visual
  536.         Compare.
  537.  
  538.         Use EXTENDED NO to tell Visual Compare to ignore any XMS memory in
  539.         your system, and to use only DOS and possibly EMS memory.  You may
  540.         need to use EXTENDED NO if your XMS driver is not compatible with
  541.         Visual Compare.  You may also want to use EXTENDED NO for performance
  542.         reasons.
  543.  
  544.  
  545.         Height
  546.  
  547.         25, 43, or 50
  548.  
  549.         Use HEIGHT to tell Visual Compare how many lines to display in visual
  550.         mode.  You must have either an EGA (Enhanced Graphics Adapter) or a
  551.         VGA (Video Graphics Array) for this command to have any effect.
  552.  
  553.  
  554.         Ignore
  555.  
  556.         Same as the /I command line option.
  557.  
  558.         If you are not interested in changes in the indentation of lines, use
  559.         IGNORE to tell Visual Compare to ignore leading space and tab
  560.         characters when comparing lines.
  561.  
  562.  
  563.         SHadow
  564.  
  565.         YES or NO
  566.  
  567.         Use SHADOW to tell Visual Compare whether or not windows should have
  568.         shadows.
  569.  
  570.  
  571.         Starting Visual Compare                                            10
  572.         _____________________________________________________________________
  573.  
  574.  
  575.         SNowcontrol
  576.  
  577.         YES or NO
  578.  
  579.         The IBM Color Graphics Adapter (CGA) requires special programming to
  580.         prevent "snow" from appearing on the screen when a program changes
  581.         the contents of the screen.  The special programming slows down
  582.         screen updating and is not necessary for most other display adapters.
  583.         If Visual Compare detects a MDA (Monochrome Display Adapter), an EGA
  584.         (Enhanced Graphics Adapter), or a VGA (Video Graphics Array), it does
  585.         not "desnow."  If Visual Compare detects a CGA, it will try to
  586.         determine whether "desnowing" is necessary.
  587.  
  588.         The SNOWCONTROL command is ignored by the OS/2 version of Visual
  589.         Compare because OS/2 automatically performs "desnowing" if necessary.
  590.  
  591.         If you suspect that Visual Compare is "desnowing" when it is not
  592.         necessary, you may want to use SNOWCONTROL NO which will allow Visual
  593.         Compare to run faster.
  594.  
  595.         If your computer "locks up" when you run Visual Compare, use
  596.         SNOWCONTROL NO.
  597.  
  598.         If Visual Compare incorrectly determines that your CGA does not
  599.         require "desnowing", you can force Visual Compare to "desnow" by
  600.         using SNOWCONTROL YES.
  601.  
  602.  
  603.         TABSout
  604.  
  605.         Use TABSOUT to tell Visual Compare to compress spaces in the
  606.         composite file to tab characters (using the default tab width of 8 or
  607.         the tab width specified by the TABWIDTH initialization file command
  608.         or the /Tn command line option) before writing the composite file to
  609.         disk.  Spaces appearing after the first single or double quote on a
  610.         line are not compressed and single spaces are not changed to tab
  611.         characters.
  612.  
  613.         TABSOUT effects the composite file written to disk by the visual mode
  614.         F2 write function and has no effect on the composite file written to
  615.         standard output by the /C command line option.
  616.  
  617.  
  618.         Starting Visual Compare                                            11
  619.         _____________________________________________________________________
  620.  
  621.  
  622.         TABWidth
  623.  
  624.         2-64
  625.         Default value: 8
  626.  
  627.         Same as the /Tn command line option.
  628.  
  629.         Specifies the tab width to be used when expanding tabs or compressing
  630.         spaces.
  631.  
  632.  
  633.         TRailing
  634.  
  635.         YES or NO
  636.         Default value: YES
  637.  
  638.         Use TRAILING to tell Visual Compare whether or not trailing space and
  639.         tab characters at the end of lines should be discarded.
  640.  
  641.  
  642.         ONEStart
  643.  
  644.         "string" or 'string'
  645.         Default value: "$$$$$  fileone START  $$$$$"
  646.  
  647.         If the /C command line option is specified, ONESTART specifies the
  648.         string to be written to standard output at the start of text that is
  649.         unique to file one.  The "fileone" in the default value represents
  650.         the fileone command line argument.
  651.  
  652.  
  653.         ONEEnd
  654.  
  655.         "string" or 'string'
  656.         Default value: "$$$$$  fileone END  $$$$$"
  657.  
  658.         If the /C command line option is specified, ONEEND specifies the
  659.         string to be written to standard output at the end of text that is
  660.         unique to file one.  The "fileone" in the default value represents
  661.         the fileone command line argument.
  662.  
  663.  
  664.         Starting Visual Compare                                            12
  665.         _____________________________________________________________________
  666.  
  667.  
  668.         TWOStart
  669.  
  670.         "string" or 'string'
  671.         Default value: "$$$$$  filetwo START  $$$$$"
  672.  
  673.         If the /C command line option is specified, TWOSTART specifies the
  674.         string to be written to standard output at the start of text that is
  675.         unique to file two.  The "filetwo" in the default value represents
  676.         the filetwo command line argument.
  677.  
  678.  
  679.         TWOEnd
  680.  
  681.         "string" or 'string'
  682.         Default value: "$$$$$  filetwo END  $$$$$"
  683.  
  684.         If the /C command line option is specified, TWOEND specifies the
  685.         string to be written to standard output at the end of text that is
  686.         unique to file two.  The "filetwo" in the default value represents
  687.         the filetwo command line argument.
  688.  
  689.  
  690.         Working
  691.  
  692.         YES or NO
  693.  
  694.         Use WORKING to tell Visual Compare whether or not to display the
  695.         "Working" message.
  696.  
  697.  
  698.         Here is an example initialization file:
  699.  
  700.              SN NO
  701.              TABW 4
  702.              ONES "!!!!!  fileone START  !!!!!"
  703.              ONEE "!!!!!  fileone END  !!!!!"
  704.              TWOS '!!!!!  filetwo START  !!!!!'
  705.              TWOE '!!!!!  filetwo END  !!!!!'
  706.  
  707.         Don't "desnow", use a tab width of 4, and if the /C command line
  708.         option is specified, use the given strings to delimit text unique to
  709.         file one or file two.
  710.  
  711.  
  712.         Visual Mode                                                        13
  713.         _____________________________________________________________________
  714.  
  715.  
  716.         Visual Compare can be run in batch mode by using the /C, /S, or /D
  717.         command line option.  However, most of the time you will probably run
  718.         Visual Compare in visual mode.  In visual mode you can easily see the
  719.         differences between two program source files and you can also
  720.         selectively discard differences in order to quickly undo some of the
  721.         changes that were made.
  722.  
  723.         If the /C, /S, or /D command line option is not given, Visual Compare
  724.         will enter visual mode.  In visual mode you will be presented with a
  725.         scrollable display of a composite of file one and file two.  The
  726.         composite file consists of lines that are common to file one and file
  727.         two, lines unique to file one (deleted from file one), and lines
  728.         unique to file two (inserted from file two).  Invoke the F1 help
  729.         function to see a list of the available functions and their keys.
  730.  
  731.         To selectively discard differences, use the F7 remove one function,
  732.         the F8 remove two function, the Del key, and the Shift-Del key to
  733.         remove insertions and deletions from the composite file.  Then invoke
  734.         the F2 write function to write the modified composite file to disk.
  735.         All lines in the composite file except those that have been removed
  736.         will be written to disk.  When you invoke the F2 write function, you
  737.         will be prompted for a composite file name.
  738.  
  739.         Use the F5 show/hide function to display insertions and deletions
  740.         that have been removed.  Use the F4 number function to mark the
  741.         removed insertions and deletions.  Use the Ins and Shift-Ins keys to
  742.         unremove insertions and deletions.  To use the Ins or Shift-Ins key
  743.         to unremove an insertion or deletion, you must first position the
  744.         cursor on the removed insertion or deletion (the removed insertion or
  745.         deletion must be displayed with the F5 show/hide function).
  746.  
  747.         If there are lines that are too long to be completely displayed, use
  748.         the right and left arrow keys, the End key, and the Home key to
  749.         horizontally scroll the display.  The End key will scroll the display
  750.         so that the last character of the longest displayed line is visible.
  751.  
  752.  
  753.         Miscellaneous Notes                                                14
  754.         _____________________________________________________________________
  755.  
  756.  
  757.         Lines in file one and file two can be delimited with Cr, Lf, or
  758.         Cr-Lf.  The maximum allowed line length in file one and file two is
  759.         2048 characters.  The maximum number of lines that file one and file
  760.         two each can contain is 16368.  The maximum number of lines that the
  761.         composite file can contain is 16368.
  762.  
  763.         Visual Compare will normally terminate with a return code of 1.
  764.         However, if Visual Compare determines that file one and file two are
  765.         identical, it will display an appropriate message and terminate with
  766.         a return code of 0.  Also, if Visual Compare encounters an error
  767.         condition while not in visual mode, it will display an appropriate
  768.         message and terminate with a return code of 2.
  769.  
  770.         Visual Compare performs a line-oriented comparison.  It is possible
  771.         for Visual Compare to compare two files that are not the same at the
  772.         byte level and report that they are identical.  This can happen for
  773.         six reasons.  First, the lines in the files are not all delimited in
  774.         the same manner.  For example, lines in one file are delimited by Cr
  775.         and lines in the other file by Cr-Lf.  Second, one file has an
  776.         end-of-file character (Ctrl-Z) and the other does not.  Third, tab
  777.         characters can cause this to happen, because tab characters are
  778.         expanded to spaces before the comparison takes place.  Fourth,
  779.         trailing space and tab characters at the end of lines can cause this
  780.         to happen, because, by default, trailing space and tab characters at
  781.         the end of lines are discarded before the comparison takes place.
  782.         (To change the default, see the TRAILING initialization file
  783.         command.)  Fifth, the /I command line option or the IGNORE
  784.         initialization file command can cause this to happen, because they
  785.         tell Visual Compare to ignore leading space and tab characters when
  786.         comparing lines.  Sixth, the /K command line option or the CASE
  787.         initialization file command can cause this to happen, because they
  788.         tell Visual Compare to consider upper-case and lower-case letters
  789.         equivalent when comparing lines.
  790.  
  791.  
  792.         Version History                                                    15
  793.         _____________________________________________________________________
  794.  
  795.  
  796.         Version 1.32
  797.  
  798.         Released March 5, 1992.
  799.  
  800.         First shareware version.
  801.  
  802.  
  803.         Version 1.40
  804.  
  805.         Released March 20, 1992.
  806.  
  807.  
  808.         New Features
  809.  
  810.         1. Support for XMS (eXtended Memory Specification) memory.
  811.  
  812.         2. The maximum allowed line length in file one and file two was
  813.            increased from 255 to 2048 characters.
  814.  
  815.         3. The ability to consider upper-case and lower-case letters
  816.            equivalent when comparing lines.
  817.  
  818.         4. The ability to not discard trailing space and tab characters at
  819.            the end of lines.
  820.  
  821.         5. The ability to substitute for a file name consisting of an
  822.            asterisk (*) the file name from the other fileone or filetwo
  823.            command line argument.
  824.  
  825.         6. The ability to substitute the fileone command line argument for
  826.            "fileone" in strings specified by the ONESTART and ONEEND
  827.            initialization file commands.  The ability to substitute the
  828.            filetwo command line argument for "filetwo" in strings specified
  829.            by the TWOSTART and TWOEND initialization file commands.
  830.  
  831.         7. The termination return codes were changed.
  832.