Instructions for installing the plugin on all versions of Unix are below.
Also, in the accompanying FAQ file are answers to some commonly asked
questions. Here are the installation instructions:

INSTALLING
==========

0. Ensure that you are using a supported version of Unix.

   The supported versions are: Solaris 2.x, SunOS 4.1, Solaris 2.x on X86,
   Linux, Irix 5.3 and later, Digital Unix on Alphas, HP-UX 9.x and later.

   ***If you are not using one of the above platforms, the plugin will
   install but will not be used by Navigator when it executes***

   We intend to support more versions of Unix over time. As Netscape
   makes support for plugins available on each platform, we will attempt
   to support the plugin on that platform. If you know of a platform on
   which Netscape Navigator supports plugins and for which we have not
   yet released the Tcl plugin, send email to jyl@eng.sun.com if you want
   us to support that platform. Also please mention in your email if you are
   willing to be an early tester of releases of the plugin on that platform.

1. Exit from any running instances of Netscape Navigator.

   Ensure that you do not have any copies of Netscape Navigator running
   presently. Navigator is sensitive to cache conflicts arising from the
   concurrent execution of multiple copies of itself. Check also that you
   are not using Navigator on another computer under the same login, if
   your home directory is shared with that other computer; in this case
   the cache is also shared, and Navigator may have problems.
   
2. Run the install.sh program in the directory where you unpacked the
   plugin distribution.

   For each platform, unpacking the tar file creates a directory (called
   a "staging area") containing all the materials for installing the
   plugin. The name of the directory reflects the system for which this
   distribution is targetted. For example, on Solaris 2.x the name of
   the staging area is "solaris2". Cd to the staging area to start the
   installation procedure.

   Install.sh attempts to start "wish" (the Tk shell) to run a graphical
   install. This will succeed if you have "wish" installed, and fail
   otherwise. The "wish" based install gives you the option to do an easy
   install (the default) a site-wide install, or a custom install. The
   difference between these methods is that using the custom install and
   site-wide install methods you are able to specify directories where the
   plugin shared library (the ".so" file) and the Tcl libraries will be
   installed, whereas in the easy install method these are chosen by the
   install. The default directories in custom install mode and the
   pre-chosen ones in easy mode are:

	Plugin ".so" is installed in <your home dir>/.netscape/plugins
	Libraries are installed in <your home dir>/.tclplug

   The default directories in the site-wide install mode are:

	Plugin ".so" is installed in /usr/local/lib/netscape/plugins
	Libraries are installed in /usr/local/lib/netscape/tclplug

   If you quit the "wish" based install without installing, or if an
   error occurs (e.g. because the graphical install is unable to start
   because "wish" is not installed) you are offered the option of going
   on with the install through a "sh" based method. If you want to go on
   installing with this method, answer the series of questions it asks
   and the install will put the files where you specified. The default
   choices for the "sh" based install of where to put the installed
   files is the same as above.

   IMPORTANT: If you use the "sh" based install, read the questions it
   asks and the choices it offers carefully. To accept an offered choice
   hit <RETURN> - **do not** answer "y" or "yes" unless that is one of
   the offered options.

   If you installed the plugin shared library in a location different from
   the above recommended defaults, you may have to set the environment
   variable NPX_PLUGIN_PATH to point at the directory where the ".so" file
   was installed. This ensures that Navigator will be able to find the
   plugin when it starts.

   If you installed the Tcl libraries in a location different from the
   recommended defaults, you may have to set the environment variable
   TCL_PLUGIN_DIR to point at where the libraries are installed. This
   will enable the plugin to find these libraries at runtime.
   
   The installation procedure produces a log file containing a trace of
   all the actions taken during installation. The name of that log file
   is prominently displayed during installation (in the graphical install)
   and printed out at the end of install (in the shell based install).
   Please include this file in any trouble reports.

   The installation procedure offers to restart Netscape Navigator and
   test the plugin. This option is available in the graphical install by
   pressing the "Test It!" button after the installation completes, or
   in the "sh" based install at the end of installing. If the plugin does
   not appear to work correctly, you are offered the option of submitting
   a trouble report in the graphical install, by pressing the button marked
   "Submit Trouble Report". The report will be initialized to a copy of the
   install log file. You may edit the report to add any additional relevant
   information.

   The information below instructs you how to test the plugin. The install
   procedure will visit <URL:http://www.sunlabs.com/tcl/plugin/applets.htm>
   during testing, to let you exercise the plugin. If you decide to not
   test the plugin during the installation, you may use Step 3 and on at a
   later time to test the plugin.

3. Restart Navigator.

   The preferred version for using this plugin is Navigator 3.0b5 or later.
   ***THE PLUGIN WON'T WORK WITH NAVIGATOR 2.x***

4. Pull down the Help->About plug-ins menu item to display the page
   describing the installed plugins. The page should list the Tcl plugin.
   Send email to <URL:mailto:jyl@eng.sun.com> if the page is not showing
   the Tcl plugin as being installed.

   The FAQ (included in this distribution) provides hints about what can
   go wrong during installation; view Questions 13 and 14.

5. Visit the demos at <URL:http://www.sunlabs.com/tcl/plugin/index.html>.
   If you experience a problem viewing any of these demos, please send
   email to <URL:mailto:jyl@eng.sun.com> describing the problem. Please
   include the log file produced during installation in any trouble
   reports you submit. It'll save time, because if you do not include it
   I will just ask you to mail it to me.

Thank you for using the plugin! We intend to continue enhancing the plugin
with more features in upcoming releases. Visit our page describing the
planned features, <URL:http://www.sunlabs.com/tcl/plugin/plans.html> to see
what is already planned!
