
                                   Visual Tcl

                      An Application Development Environment
                             For the Tcl/Tk language

                        Copyright 1996-1999, Stewart Allen
                           Maintained by Christian Gavin


 TABLE OF CONTENTS

   I.   Introduction
   II.  Installation
   III. Requirements


 I. INTRODUCTION

   Visual Tcl is a freely-available, cross-platform application development
   for the Tcl/Tk language.

   Visual Tcl is covered by the GNU General Public License.
   Please read the LICENSE file for more information.


 II. INSTALLATION

    o  Unzip or untar Visual Tcl into a permanent location. On Unix, we
       recommend /usr/local/vtcl. On Windows, a good default is
       "C:\Program Files\vTcl". On Macintosh, I recommend you do this
       inside of the folder in which Tcl/Tk was installed. It is important
       to note that on Windows, you must use WinZip (www.winzip.com) or
       another zip which supports long file names and nested directories.
       This is the most common difficulty Windows users encounter.


                                    UNIX

    o  Run the ./configure script in the location where you installed vTcl.
       This script will run and attempt to find the best WISH shell.  This
       script will write out a startup script called vtcl that you can then
       use to start Visual Tcl.

    o  If a WISH is not found, or you want to use a different WISH, edit the
       "vtcl" shell script.
       Change PATH_TO_WISH to the location of the wish binary
       Change VTCL_HOME to the directory you installed vTcl in.

    o  Put vtcl in your path (/usr/local/bin or /usr/bin) or change your
       path to include $(VTCL_HOME)

    o  Make sure your DISPLAY environment variable is set and type "vtcl".


                              WINDOWS 95 and NT

    o  Make SURE you use Winzip from http://www.winzip.com
       Other zip programs fail to preserve long file names and nested
       directory structures.

    o  If you wish to create "shortcuts" to the vt.tcl icon, make sure
       you edit the "startup directory" to the base installation directory
       for Visual Tcl.

    o  You will need to associate all ".tcl" files with the Wish appplication.
       This is usually done by default by the newest Tcl/Tk packages for
       Windows.

    o  Double-click on "vtcl.tcl" icon.


                                  MACINTOSH

    o  Start the Wish shell interpreter.

    o  "cd" to the Folder in which Visual Tcl was installed.

    o  Type "source vtclmac".


 III. REQUIREMENTS

    Tcl8.03 and Tk8.03 or newer. You can obtain a binary for most platforms
    from http://www.scriptics.com/. If not, source code is also available.
    
    ITcl/Tk 3.0 or newer.


                                      --
                              stewart@neuron.com
                                cgavin@dnai.com
			      damon@unreality.com
