Tcl/Tk Browser Plugin SOURCE release
====================================

    http://www.tcl.tk/software/plugin/ 
    http://tcl.ActiveState.com/software/plugin/
    http://tclplugin.sourceforge.net/

    tclplugin-core at lists.sourceforge.net

 { If you are not familiar with the compilation of programs
   on your platform, see the URL above for a binary (executable)
   distribution for your platform }

Version 3 of the Tcl plugin was redeveloped by ActiveState.  It is based on
Tcl 8.4, but it should build equally well with any higher Tcl/Tk version.

BUILD INSTRUCTIONS:
-------------------
  A prerequisite to building the plugin is a non-statically built Tcl/Tk
  *8.4.1 or greater* set of binaries.  An installation of ActiveTcl will
  suffice.

  The following instructions apply for Unix and Windows (using the cygwin
  environment on Windows).

  1. Create a directory to contain the interim objects, like so:
     mkdir -p ~/build/plugin/
     cd ~/build/plugin/

  2. In the build directory /path/to/plugin/sources/configure with:
            --with-mozilla=<path where you want to install the plugin>
	and:
	    --prefix=/path/to/installed/(Active)Tcl8.4+
	or:
	    --with-tcl=<path to tcl8.4 *build* dir>
	    --with-tk=<path to tk8.4 *build* dir>
     The --prefix option is preferred.

     If you want a personal install, use:
	    --with-mozilla=$HOME/.netscape (for Netscape4)
	or  --with-mozilla=$HOME/.mozilla (for Netscape7 or Mozilla)

  3. make
  4. make install
     This will place the plugin runtime libraries in:
	    /path/to/tcl/lib/nptcl<version>
     And the plugin dll binary in the client browser's plugin directory.
     On Unix, /path/to/tcl/lib/nptcl<version>/installed.cfg must have the
     ::plugin(executable) var set to an 8.4+ wish binary.

  On Windows, the Tcl/Tk dlls must be on the PATH and on Unix they must
  be in the LD_LIBRARY_PATH or equivalent (LIBPATH or SHLIB_PATH).
  It may be possible to do without the LD_LIBRARY_PATH limitation on
  Unix, but Mozilla seems to overload LD_LIBRARY_PATH against us.

=== MAC OS X ===

    See the README in the Mac directory for more information.
