   *** INSTALLATION INSTRUCTIONS FOR TKNET VERSION 1.1 ***

                    12 April, 1996

NOTE:  If you are upgrading from version 0.9 or 1.0 , please read 
       the file UPGRADE.TXT before following the instructions
       contained within this file.


REQUIRED SOFTWARE
-----------------

TkNet requires Tk version 4.0 or greater, and Tcl version 7.4
or greater.  This software, if you don't already have it, may be
obtained from (amongst other places):

	ftp://sunsite.doc.ic.ac.uk/packages/tcl

For those of you who are lucky enough to be running a current
(read 3.0/3.01) Slackware or similar ELF system, I have a set
of precompiled binaries/libraries including Tk4.0, Tcl7.4 and
Expect 5.19 (see below).  All these binaries contain compiled
in support for X-pixmaps (xpm).  The distribution is called
wish_full and may be obtained from:

   ftp://ftp.logica.com/pub/kempsonc/tknet

Alternatively, source for an xpm aware wish (xpmwish) may
be obtained from the above site and also from:

	ftp://merv.philosophy.lsa.umich.edu/pub/

Note that you will probably need to make a link from xpmwish
to wish.

Note on Expect:  TkNet does *not* require Expect for normal 
operation.  However certain features of TkNet (for example
password prompting during connection) are disabled if you
are not running expectk.  You will be notified at run-time
should you attempt to use such functionality and your system
does not support it.  If you *do* install expect, create
a link from expectk to wish, so that TkNet will use the
expect interpreter.

HOW TO INSTALL
--------------

Review the files RELEASE.TXT, INSTALL.TXT and UPGRADE.TXT
as necessary.

Unpack the tar file in the root directory - you will need
to be root to do this. This will extract TkNet into 
/usr/local/bin and will create a directory /usr/local/lib/TkNet 
into which is placed the help text (and configuration files 
later on).  A modules directory is created under this 
directory which contains the TkNet code.

[Note:  If you decide to install TkNet to a location other than
 the default, you will need to modify the file TkNet so that
 the variable GLOBAL_INCLUDE points to the correct directory.
 The directory modules must always be a subdirectory of this
 directory]


CONFIGURATION
-------------

Still as root, run up the software by typing TkNet.  You will 
be warned if the versions of Tk or Tcl that you are using are
incorrect.

Once the main screen has appeared, enter the setup screen 
Options->Environment...  and enter the information for your site.
The default is my home setup.  For more information on the
item click the mouse on the label associated with the item.
Once you have completed the setup click Close or File->Save.
Answer Global to the dialog asking you where to save the 
options to (otherwise it will save them to your home directory).

Now enter the script setup screen Option->Scripts.  Help
text is available - read it!  Again save the setup to 
the global file.  Repeat with the launcher setup (if
desired).

Finally configure the screen appearance using the menu items
under Options. Save the options to the global file.  For
help on the options, see Help on Menus under the help menu.

Test out the configuration!  If it works, good, if not, 
re-enter the setup screen and try again.

###############################################################
#    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 (version 2 of the License).
#
#    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 
#    for more details.
#
#    For a copy of the GNU General Public License, write to the 
#    Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
#    MA 02139, USA.
###############################################################

