Read Me

What this is:

TkDiff is a Tcl/Tk front-end to diff for Unix/Linux, Windows, and MacOS.

TkDiff knows how to work with several revision control systems:
CVS, Subversion, Git, SCCS, RCS, PVCS, BitKeeper, Perforce, Accurev, Mercurial
and ClearCase. It's only tested on the free and open source ones.

================================================================================
Requirements:

As a 'pure' Tcl implementation, the runtime requirements are limited to an
appropriate level of Tcl/Tk support:

Versions *Prior* to V4.3 of TkDiff, needs at least V8.0 of Tcl/Tk and Wish
Versions *At/After* V4.3 of TkDiff, needs at least V8.5 or Tcl/Tk and Wish

Exceeding these requirements (more recent Tcl/Tk releases) is DESIGNED
to be generally harmless, as it is INTENDED to transparently adapt

================================================================================
Platforms:

On Linux or Unix, simply invoke it from the command line.
tkdiff --help will list the options.

On MacOS, an old version of wish (tk8.5) is installed with the OS, but it's
been deprecated for years and it works poorly if at all. The Homebrew tcl-tk
package is an excellent replacement. Then, you can invoke tkdiff from the
terminal just as on Unix/Linux, or you can double-click on it in the Finder,
and a terminal will open and run it.

On Windows, you must find diff.exe somewhere. You must install Wish on your
computer. You can use ActiveTcl from www.activestate.com or get it from the
tcl/tk project on Sourceforge. To run on Windows, it's easiest to rename tkdiff
to tkdiff.tcl. Then when you double-click on it, it will open in Wish. You can
of course make a desktop shortcut for it.

================================================================================
Additional Assistance:

TkDiff has an EXTENSIVE builtin Help description of nearly every aspect of
its operation, default settings, expected behaviors, interaction scenarios and
even optional User re-configurations that are permitted. As such, there is no
acompanying "manual page" in the distribution as it would be singularly HUGE.

================================================================================
License:

This program is free software; you can redistribute it and/or modify it  under
the terms of the GNU General Public License as published by the  Free Software
Foundation; either version 2 of the License, or (at your  option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or  FITNESS
FOR A PARTICULAR PURPOSE.  See the GNU General Public License  for more
details.

You should have received a copy of the GNU General Public License along with
this program; if not, see <https://www.gnu.org/licenses/>.

================================================================================
Credits:

TkDiff is Copyright (C) 1994-2006 by John M. Klassa, among others:
Copyright (C) 1998      by Bryan Oakley
Copyright (C) 1999-2001 by AccuRev Inc.
Copyright (C) 2004      by Tom Dunne
Copyright (C) 2004-2025 by Dorothy Robinson ("dorothyr")
Copyright (C) 2017-2025 by Michael-M ("vampm")

Many of the toolbar icons were created by Dean S. Jones and used with his
permission. These icons have the following Copyright:

Copyright(C) 1998 by Dean S. Jones
dean@gallant.com
http://www.gallant.com/icons.htm
http://www.javalobby.org/jfa/projects/icons/

Others not coverred by the above are the work of Michael-M