----------------------------------------------------------------------

			       tkWorld

		     Wes's Own Real Lazy Desktop
			Written By Wes Bailey
			
			 bailey@phys.ksu.edu
	     http://www.phys.ksu.edu/~bailey/tkWorld.html

----------------------------------------------------------------------

INSTALLATION
------------
It's a piece of cake.  From the tkWorld-0.03 directory prompt, just
follow the example below:

	HendrixRules:/tkWorld-0.03> wish bin/tkWinstall.tcl

A nice GUI will come up and have a form to fill out.  Once you are
done, click on the install button and away it goes.  Error messages
should be pretty clear.  If you do encounter any errors at all,
consult the notes below depending on your install mode:

        SINGLE USER
        ROOT

SINGLE USER MODE
----------------
The first entry is Bin Path.

	Default: $HOME/bin

This is where the controlling Bourne Shell scripts will live.  If this
directory does not exists, then you can either create it, or supply a
different path.  NOTE THIS DIRECTORY MUST BE IN YOUR PATH!

The second is the path of the Bourne Shell.  To find this
just type:

	HendrixRules:~> which sh
	/bin/sh
	HendrixRules:~>

In principle any shell should work (Bash, ash, zsh, ksh, csh, tcsh,
and pdksh).  I use Bash as my Bourne Shell interpreter and I have not
encountered any problems.

NOTE: Use the form path/shell because this string gets directly
inserted into the controlling script.

ROOT MODE
---------
The first entry is the Source Path.

	Default: /usr/local/src/tkWorld-0.03

This is where all of the source files will live so that everyone in
your system has access to them via the controlling shell scripts.
After installation, you will be able to remove the local copy of the
tkWorld-0.03 directory that you are currently in.

From this point, see SINGLE USER MODE for a description of the other
entries.  The only difference is the default Bin Directory is
/usr/local/bin.

TROUBLESHOOTING
---------------
If the installation is successful and all the paths are set up
correctly, you should be able to type the following at the prompt:

	HendrixRules> tkGrep

and the application will come on screen.  The worst case scenario is
that you type at the prompt where this INSTALLATION file lives:

	HendrixRules~/tkWorld-0.03> sh bin/tkGrep.tcl

The bin/ is necessary for the application to access it's images/ doc/
and include/ files.

If you installed in SINGLE USER MODE, and the application does not
work, make sure that the BIN directory exists using this trick
	
        HendrixRules:~> ls | sed 's/bin/EXISTS/g' | grep EXISTS
        EXISTS
	HendrixRules:~>

If for some reason this directory does NOT exist, then something went
wrong with the installation script.  If it does exist, then make sure
it is in your path using the following example as a guide

	HendrixRules:~> echo $HOME
	/home/wesb
        HendrixRules:~> echo $PATH | sed -e 's/:/\
        > /g' -e 's/\/home\/wesb\/bin/INPATH/g' | grep INPATH
        INPATH
	HendrixRules:~>

Using sed is a little trick to save you eyes from looking at stuff
that is not obvious.  The last \ on the 3rd line stands for a carriage
return, and the > means the shell is still making your command.  

If you cannot get this little trick to work, then just echo $PATH and
look for your_home_directory/bin.

More of the same applies for ROOT MODE.  The tkWorld paradigm is that
each application has it's own driving Bourne Shell script which lives
in $PATH.  The shell script will spawn a shell, switch to the
directory where the applications live, then execute the command sh
bin/[application].tcl.  This shell then executes the wish shell and
the application comes on the screen.  There are no symbolic links, or
restrictions on the number of users using each application this way.
Here is an example diagram of the process:

	$HOME> tkGrep
        |
        |-> /usr/local/bin/tkGrep*
            |
            |-> /bin/sh
                |
                |-> cd /usr/local/src/tkWorld-0.03
                |
                |-> wish bin/tkGrep.tcl
                    |
                    |-> application GUI
                |
                |-> exit
            |
            |-> exit
        |
        $HOME>

If the application does not come on screen, then debug each step in
the process above, checking permissions and file existence.

As a last resort, visit the tkWorld Homepage at

	http://www.phys.ksu.edu/~bailey/tkWorld.html

and send a bug report.
