File readme for 2KnotAmplitudes 1.0 for Win95/98/NT/2000/XP  (September 2004)


SYSTEM REQUIREMENTS

Iniitially only the Windows binary files are available in the
compressed zip file: win32-bin-2knots.zip

For Windows, compilation has been tested with Visual C++ Professional
edition, version 6. The Windows source version includes Visual C++
project files to build the executables.

Compilation under Unix is best done using GNU make and g++. The system
was built using Gnu g++ (gcc) version 2.95.3-5.



LIST OF FILES

Executable files:
    bin/*               programB, programB0, programC, and programC0

Documentation files:
    install.txt         Installation instructions (this file)
    doc/usersguide.pdf  User manual (PDF format)

Example files:
   examples/*           Sample movies

INSTALLING 2KNOTS C++ APPLICATIONS (BINARIES ONLY) UNDER WINDOWS

1. Move to a selected directory, and unpack the 2Knots distribution using
WinZip or unzip.

         

     This creates a directory ~/mosml with subdirectories 

     2KnotsC++/          install.txt
	   bin/          programB, programB0, programC, programC0
	   doc/          usersguide.pdf
	   examples/     a few example data files

2. Add C:\2KnotsC++\bin to the PATH variable. 
 
    (This assumes you unpacked the zip file in the C:\ directory.
    If you unpacked it in C:\myhome, add C:\myhome\2KnotsC++\bin
    to the PATH variable.)


    (a) In the case of Windows 95/98/ME your AUTOEXEC.BAT file should 
        contain something like:

          set PATH=C:\dos;  ...  ;C:\2KnotsC++\bin

        The system must be rebooted to enable the new environment 
        variables. 

    (b) In the case of Windows NT/2000/XP, choose 
          Start | Settings | Control Panel | System | Advanced 
                | Environment Variables | System Variables | New
        Double-click on Path and add  ;C:\2KnotsC++\bin  to the Variable Value.

(3) Start any of the applications, such as programB, by entering the
    command line 

        programB

AUTHOR AND CREDITS

The C++ versions of ProgramA, ProgramB, and ProgramC were written by
    Jacob Towber 
    DePaul University, Chicago, IL
and Glenn Lancaster 
    School of CTI,
    DePaul University, Chicago, IL

    Much of the initial work was done by Towber and later split into two
    fairly independent developments - one continuing in C++, and the other
    in Java. 

The Java version was written by 
    Richard Larson 
    University of Illinois, Chicago

    The Java version is available at 

	http://tigger.uic.edu/~rgl/javaknots.html

COPYRIGHT NOTICE
    Copyright (C) 2004

    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 in copyrght/gpl2 for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


AVAILABILITY

    * The main page is at  
        http://condor.depaul.edu/~glancast/2knots
    * The MS Windows executables only (and documentation) are in 
        http://condor.depaul.edu/~glancast/2knots/win32-knots-bin.zip
    * The MS Windows source files plus Visual C++ project files (and
        documentation) are in
        http://condor.depaul.edu/~glancast/2knots/win32-knots-vcpp.zip
    * Unix source files plus GNU make file (and documentation) are in
        http://condor.depaul.edu/~glancast/2knots/win32-knots-unix.zip
