From: Kempson Charlie
To: Charlie @ Home
Subject: TkNet 1.0 Installation Instructions
Date: 31 January 1996 11:53

*** INSTALLATION INSTRUCTIONS FOR TKNET VERSION 1.0 ***

                    31st January, 1996

NOTE:  If you are upgrading from version 0.9, 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

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).


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.  If you get an error 'wish : command not found' you
need to obtain and install a wish interpreter.  I recommend
getting xpmwish from:

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

and installing it as /usr/local/bin/wish.

Once the main screen has appeared, enter the setup screen 
Options->Setup...  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.

RELATED SOFTWARE
----------------

Note on su1:  this software allows non-root users to run certain
commands as root.  I use it to give access to networking
functions.  You may be able to replace this command with
sudo/super or by setting the sticky bit on the applications in
question.  Note that I have had reports of su1 not working
correctly on some systems, so your mileage may vary.
su1 may be obtained (in the UK) from:

ftp://sunsite.doc.ic.ac.uk/pub/packages/Linux/sunsite.unc-mirror/system/Admin/su
1.tar.z

NOTE : Although this software has been extensively tested on my
       platform, it is still Beta software.  Please report any
       bugs (short description + stack trace) or any requests for
       enhancements to me at charlie@siren.demon.co.uk or to
       kempsonc@logica.com .


###############################################################
#    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.
###############################################################

