README file for the tmcm-java-source archive            June 2004
--------------------------------------------

This archive contains the source code for a set of Java applets.
The applets were written for use with a textbook, The Most Complex
Machine, by David Eck.  They are meant to help teach some basic
concepts of computer science.  For more information about the
applets and for a set of lab worksheets that use the applets,
see:    http://math.hws.edu/TMCM/java/

*** NOTE ***  This source code was not originally written with
the intent of making it public.  There are very few comments in
the code.  Some parts of the code are a bit strange because they
were translated from Pascal programs.  So, take the code for
what it's worth...

The source code is contained in the directory named "tmcm".
All the classes for the applets belong to the package named
"tmcm" and to its sub-packages.  The sub-packages correspond
to subdirectories in the tmcm directory.

A directory named "manifest_files" contains manifest files that
are used for creating executable jar files.  These are files 
that can be run as stand-alone applications.  (Very old versions
of Java will not be able to create or use these files.)

The applets were written in Java 1.0, so they use many
deprecated methods whose use is discouraged in Java 1.1 and
later.  When the source code is compiled, you will get 
warning messages about deprecated methods.  The warning 
messages are not errors and will not stop the files from 
being compiled.

The code can be compiled with the "javac" command from
the JDK (Java Development Kit).  To use this command with
classes that are defined in the tmcm package or one of
its sub-packages, you must be in the directory that contains
the tmcm directory, and you have to specify the full path
to the file or files you want to compile.  For example,
to compile all the files in the package tmcm.xSortLab,
you would say

        javac tmcm/xSortLab/*.java      in Linux or UNIX
   or
        javac tmcm\xSortLab\*.java      in a DOS command window.
        
For convenience, I have included script files that will compile
all the classes in the tmcm file.  For Linux/UNIX, there is
a shell script named "compile.sh".  For DOS/Windows, there
is a DOS batch file named "compile.bat".  These scripts
will also build executable jar files for all the applications.
(The Linux/UNIX script might work under MacOS X, but I have
not tested it.)

----------------------------------------------        
David Eck
Department of Mathematics and Computer Science
Hobart and William Smith Colleges
Geneva, NY   14456   USA
Email:  eck@hws.edu
WWW:    http://math.hws.edu/eck/