Jim Veale is seeking
beta testers for Complite


Photo shows Compdeux running in @Macarlo's Warp 4.0

James D. Veale (jdveale@world.std.com) is looking for a few beta testers to try out OS/2 presentation manager ports of Complite and its cousins. Complite is a DOS based utility which performs a word-by-word comparison of programming language source. Split screen displays with correlated scrolling make results easy to interpret.


The OS/2 port, CompDeux, is a true presentation manager application, but retains most of the look and feel of its DOS heritage. CompDeux supports displays up to 200 columns by 60 rows. CompDeux also supports mouse-based scrolling like Complite, which is toggled on and off by chording the mouse buttons.

Demonstration versions of the betas are available on James D. Veale web page at:

http://world.std.com/~jdveale/index.html

The demonstration versions are functional, with some features disabled. Contact information and more detailed descriptions are available on the web page.

IMPORTANT NOTES: Running COMPSHOE in OS/2 Warp 4

***** ALERT ***** By default, the results screen captures the mouse for scrolling. To RELEASE the mouse for normal desktop use, chord the two mouse buttons. In other words, press both mouse
buttons simultaneously.

To CAPTURE the mouse for scrolling, place the mouse pointer over the comparison results window and chord the mouse buttons again.

You can change the font size from the results display by pressing F6 for smaller fonts or shift-F6 for larger fonts. Compdeux uses the "System VIO" font, you cannot change this.


What is COMPSHOE?

COMPSHOE is a demonstration version of COMPDEUX, a native 32 bit presentation manager port of COMPLITE. The time-limited demo is functional but has some features disabled. These disabled
functions include: printouts, saving bounced lines, and wider than 80 column vertical scrolling.

COMPDEUX is an intelligent file comparison utility for programming language source. Compdeux compares different versions on a word-by-word basis and highlights the changes. Words may be separated not only by blanks, but by common programming language delimiters. Split screen, up to 200 column displays with automatic correlated scrolling make quick look results readable and useful.

Compdeux is a native OS/2 presentation manager program.

o Compdeux supports dot-matrix, laser, and PostScript printouts.

o Compdeux handles files up to 100,000 lines and single changes up to 65,000 items, with no limit on the total number of changes.

o Simple Interactive Merge Facility.

o A user specified list of keywords or phrases may be ignored, or equivalenced in the comparison. This handy for dates, changed variable names and acronyms.

o Compdeux has been tested under Warp 4.0 and should run under Warp 3.0 as well. Most options are saved in a parameter file, which can be customized for different applications. Station specific parameter files are available for networks.

o Single User Licenses are available for $40. Site licenses are available.

Getting started

The first time Compdeux is run, a panel is displayed which requests the old and new file names, along with other parameters. A brief description of the options for a parameter appears in the lower half of the screen. The comparison begins when the last parameter is entered.

Several keys have special functions for input panels. The SPACE bar will cycle between various options for a parameter. The ESC key exits the program or backs up to the preceding panel. Pressing ENTER will accept the current parameter option and move the cursor to the next parameter. Pressing CTRL-ENTER will accept the current option, and the default options for all the remaining parameters.

A variety of setup options are available by entering $SETUP for the old file name. Be sure to "enter" your way out of setup options, "escaping" out of setup options will cancel any changes you make.

The results of the comparison are displayed with changes in yellow and matching portions in white. Additional help is available with the F1 function key. Short reminders are shown on the bottom line
and toggled with the space bar.


Installation notes:

The easiest thing to do is simply unzip "COMPSHOE.ZIP" in a directory of your choice. If you copy the executable "COMPSHOE.EXE" and use a PostScript printer, be sure to copy COMPSHOE.PSH" to the same directory.

COMPSHOE ONLY: Wider than 80 column Vertical scrolling is disabled in the demo, but you can still maximize or resize the results window and see how it looks. The comparison portion of printouts is disabled in the demo, but you can still $SETUP for your printer. The header and footer for a comparison is still printed. You can bounce lines in the demo to see how the feature works, but you can't save the results with F12.

Compdeux uses up to 16 mb to display the results of a comparison.If this isn't enough, a temporary swap file is created on the disk.

Compdeux creates a parameter file named "XUEDPMOC.PRM". Normally this file is created in the same directory as the executable. Options are also available to install Compdeux on a network or to maintain different parameter configurations.

Compdeux creates a number of work files in the temporary directory specified by the "TMP" environment variable. These are deleted upon normal termination.


COMPTIG - A Rigorous Complite
with Contiguous Match Preference

COMPTIG is a special version of Complite based on a theoretically rigorous comparison engine, with a contiguous match preference. The user can specify that a contiguous sequence of matching words be weighted more heavily in the comparison than a similar number of isolated matches.

Consider the example below with two sequences of 10 characters each ('A B C x A x A x A x' and 'A o A o A o A A B C'). At most 4 characters can be matched, the four capital A's. This is what Comptig will do with the contiguous match preference suppressed.

However you may find the contiguous matching sequence of 'ABC' more useful in many applications. This is what Comptig picks with a contiguous match preference of 2. The contiguous sequence of 3 matches is chosen over the 4 isolated matches.

-----------------+----------------------------+------------------------
 Original        | Contiguous Match           | Contiguous Match
 Sequences       | Preference = 1             | Preference = 2
                 | (i.e. no preference)       |
-----------------+----------------------------+------------------------
                 |                            |
  1.   A   A     |           1.  1.A          |                     1.A
  2.   B   o     |                            |                     2.o
  3.   C   A     |     2.B            2.o     |                     3.A
  4.   x   o     |     3.C                    |                     4.o
  5.   A   A     |     4.x                    |                     5.A
  6.   x   o     |                            |                     6.o
  7.   A   A     |           5.  3.A          |                     7.A
  8.   x   A     |                            |
  9.   A   B     |     6.x            4.o     |            1.  8.A
 10.   x   C     |                            |            2.  9.B
                 |           7.  5.A          |            3. 10.C
                 |                            |
                 |     8.x            6.o     |      4.x
                 |                            |      5.A
                 |           9.  7.A          |      6.x
                 |                            |      7.A
                 |    10.x            8.A     |      8.x
                 |                    9.B     |      9.A
                 |                   10.C     |     10.x
                 |                            |
-----------------+----------------------------+------------------------

Comptig vs. Complite Issues

Comptig is available in a bundle with Complite. A single user license covering both Complite and Comptig is available for $45. Additional limited release products are available at ten dollar increments.

The time-limited demo below is functional with some features disabled. Disabled functions include: printouts, saving bounced lines, and vertical scrolling in 132 column modes. Comptig requires a 386 or better processor with hardware floating point, Pentium II class processors are recommended.


COMPSIB - limited release

COMPSIB provides unique capabilities for dealing with branched sets of source code. Compsib works with 3 source files at a time, but it is NOT a 3-way merge. Compsib can be used to maintain separate branches as well merge them. Some scenarios where Compsib is useful are:

The user interface for Compsib is nearly identical to Complite, but three input files are specified instead of two. The three input files are known as:

Compsib displays the results of a comparison between the Sibling and Revision, while suppressing the changes between the Sibling and Master.

In other words, Compsib shows you the changes made in the Revision as they apply to the Sibling. The interactive merge or "selective bounce" feature can then be used to apply those changes to the sibling. Now with regard to the original scenarios: