TclProp, OAT, and TkOAT - installation instructions.

RCS:  $Id: README,v 1.1 1996/12/03 02:50:54 safonov Exp safonov $


The distribution is packaged in 3 different forms, with TclProp included
in each of the three: 

  - TclProp-2.0p1.tar.gz     : patches to Tk 4.1 core. 4.2 patches to come...

  - TclProp-2.0p1-src.tar.gz : pre-patched Tk 4.1 core

  - TclProp-2.0p1-bin.tar.gz : pre-compiled wish4.1 binaries for Solaris,
	         	       Linux, and Irix. More platforms to come...

The following instructions will explain the common installation.


Unarchive the distribution.
gunzip -c | tar xvf TclProp-2.0.p1.tar.gz

(substitute a different archive name if you are using a pre-patched 
 or binary distribution).

This will create, in the current directory, the following directories:

  - TclProp
      Contains the Tcl formula manager and propagation engine. This is a 
      Tcl-only package. Some examples of TclProp formulas are in file 
      examples.tcl. Look at sample startup files in this directory,
      .tclshrc.sample and .wishrc.sample, for information how to
      initialize TclProp and required loadable extensions.

  - oat
      Contains the loadable extension OAT (Object Attribute Traces).

      To compile it, do the following:
        - run configure:
            ./configure --enable-shared
        - run make
            make
      This should create a shared (.so) library liboat.so for the 
      OAT extension. Use the Tcl `load' command to load it into the 
      interpreter.

  - tkoat
      Contains the loadable extension TkOAT (Tk Object Attribute Traces).
      It provides traces on Tk widget attributs and canvas item attributes.

      To compile it, do the following:
         - run configure:
           ./configure --enable-shared
        - run make
           make
      This should create a shared (.so) library libtkoat.so for the 
      TkOAT extension. Use the Tcl `load' command to load it into the 
      interpreter.

  - file README.

The following instructions are specific to each packaging of the distribution.

  - The source patch distribution, TclProp-2.0.p1.tar.gz, creates a patch
    file, tk4-tkoat.patch. Change to the tk4.1 top directory (the one
    containing generic/, unix/ etc) and run the patch command:

      patch -p1 < "PATH-TO-PATCH"/tk4-tkoat.patch

    Configure and compile tk4.1 with shared libraries as usual. Note that 
    at present, only Tk with the plus patches applied can be dynamically 
    loaded.

  - The pre-patched distribution, TclProp-2.0-src.p1.tar.gz, creates
    the full source tree for tk4.1 in the current directory. Configure
    and compile wish with shared libraries as usual:

      cd tk4.1; configure --enable-shared; make

  - The binary distribution, , TclProp-2.0-bin.p1.tar.gz, creates
    the usr/local/ hierarchy for tk4.1 in the current directory.
    Architecture-specific files are in ./usr/local/${OSTYPE}.
    wish4.1 binaries are in ./usr/local/${OSTYPE}/bin; shared libraries
    for tk 4.1, oat, and tkoat are in ./usr/local/${OSTYPE}/lib.
    Currently Solaris 2.5, Linux-ELF, and Irix 5.x are supported.

    The architecture-independent files are in the ./usr/local/lib,
    ./usr/local/include, and ./usr/local/man.

  


