
------------------------------------------------------------------------------
TkDiff v1.0b6                                                   02/08/95
------------------------------------------------------------------------------

TkDiff is a graphical front-end for the standard Unix 'diff' utility.
Its features include:

        + Highlighted difference regions.
        + Side-by-side viewing of files.
        + Linked (synchronized) scrolling of the two files.
        + Random access to difference regions.
        + On-line help.

------------------------------------------------------------------------------
Changes from 1.0b5
------------------------------------------------------------------------------

I removed the iconify/deiconify step (for the main window) from the
startup code.  It seems to have been the cause of one of the nastier
bugs people were seeing.  If somebody can explain it to me, I'm all
ears...  Is this a known Tcl/Tk bug, perchance?

I added the patch that Joe Moss sent (thanks, Joe!) to fix one of the
other problems people were having...

Lastly, I replaced the man page with one whipped up by Warren Jones
(thanks, Warren!).

As you can see, this is (for the most part) just a bug-fix release...

------------------------------------------------------------------------------
Changes from 1.0b4
------------------------------------------------------------------------------

I fixed the 'chdir' problem that people were having...  If you still see
this problem, let me know (I can't imagine why it'd still happen,
though).

I added a "Computing differences..." popup (which goes away on its own)
to let you know that TkDiff is doing something, but isn't yet ready to
show you the differences between your two files.

------------------------------------------------------------------------------
Tar-file Contents
------------------------------------------------------------------------------

This tar file should have contained three things:

        1.  This README.
        2.  The TkDiff wish script.
        3.  A very brief man page (which contains just enough information
            to get you started, and to let you know about the on-line help).

------------------------------------------------------------------------------
Configuration
------------------------------------------------------------------------------

To configure the TkDiff script for your site, you'll need to edit two
lines.  The first is the top-most line in the file:

        #!/usr/bin/env wish-f

Change it to whatever will causes your system run the TkDiff source file
through "wish -f" at startup.

Note that 'wish-f' (as it appears above) is *not* a typo -- there's *no*
space between the 'wish' and the '-f'.  At my site, we've got two or
three different platforms, each with their own set of executables.
'wish-f' is a script that chooses the right version of 'wish' to
execute, and gives it the '-f' flag for free.  I've never had much luck
with:

        #!/path/to/wish -f

for some reason, yet the '/usr/bin/env wish-f' approach has always
worked...

The other change you'll need to make is to the line that looks like:

        set emacs_bindings_file \
                "/homes/klassa/public/lib/tcl-tk-lib/bindings.tk"

Change it so that it points to your copy of Paul Raines' Emacs-bindings
source file.  If you don't have it, don't worry (and don't change this
line, either -- there's no need)...  You just won't get Emacs-style
keybindings in the entry widgets (although the filename entry widgets
will still do filename completion).

If you don't have "bindings.tk", though, I'd recommend that you get it --
it's very handy.  It can be obtained as part of the TkMail
distribution (ftp://bohr.physics.upenn.edu/private/raines).  And if you
don't have TkMail, I'd recommend that you get that, too...

------------------------------------------------------------------------------
"Beta" Status
------------------------------------------------------------------------------

This software is still in a "beta" phase.  It's been tested, but hasn't
been seen by very many people.  If you have suggestions on how I can
make TkDiff better or faster or easier to use, please let me know.
Thanks!

------------------------------------------------------------------------------
Disclaimer
------------------------------------------------------------------------------

THIS SOFTWARE IS PROVIDED BY ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
NO EVENT SHALL JOHN KLASSA OR ALCATEL NETWORK SYSTEMS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.

------------------------------------------------------------------------------
Getting the Latest Version
------------------------------------------------------------------------------

The latest version of TkDiff should always be available from
ftp.aud.alcatel.com.  If it's not there yet, or you don't have access to
ftp, you can always get it by sending mail to klassa@aur.alcatel.com
with the following subject:

        @CMD send-tkdiff-dist

The "@CMD" diverts your mail into my auto-reply mechanism; and the
"send-tkdiff-dist" tells my auto-reply mechanism to send you the latest
version of TkDiff (as a uuencoded, compressed tar file).

------------------------------------------------------------------------------
Reaching the Author
------------------------------------------------------------------------------

I can be reached via klassa@aur.alcatel.com.

Enjoy!
John

--
John Klassa                          919-850-1246             \        /\  /\
Alcatel Network Systems           Subject: @CMD help           \  /\  &  \/  \
Raleigh, NC, USA                     for info...                \/  \/        \
-------------------------------------------------------------------------------
