
   Installation of TkDesk 1.0a2
----------------------------------------------------------------------------

1. TkDesk 1.0a2 requires either Tcl 7.4 and Tk 4.0 or Tcl 7.5 and Tk 4.1.
   Older versions will not work!
   
   If you're not sure if you have the right version of Tcl/Tk installed,
   or if you have Tcl/Tk installed at all, try to
   
   a) execute wish4.0 or wish4.1. If your shell finds this command, you
      have the right version installed. Skip to point 2 below.
   b) execute wish. If this command succeeds, type "set tk_version" at
      wish's command prompt. Press return. You should see "4.0" or greater.
      
   If you don't have Tcl/Tk, or not the right version, you currently have 
   to get Tcl 7.4/Tk 4.0 or Tcl 7.5/Tk 4.1 and install these independently
   from TkDesk. Current versions of Tcl/Tk are available from 
      
      ftp://ftp.smli.com/pub/tcl
      ftp://ftp.aud.alcatel.com/tcl/ftp.smli.com
      ftp://sunsite.doc.ic.ac.uk/packages/tcl-archive/ftp.smli.com
      ftp://ftp.uni-paderborn.de/unix/tcl/alcatel/ftp.smli.com
      
   and lots of other mirror sites. Don't forget to also get and apply 
   any patch files for the current version. These can be found in the
   same directory. Instructions for patching, compiling and installing
   are included in the respective packages.
      
   LINUX USERS: There are precompiled versions of Tcl/Tk available from
   ftp://sunsite.unc.edu/pub/Linux/devel/lang/tcl amd all its mirrors.
   Even shared libraries for a.out and ELF systems are included.
   If you're running Slackware 3.0 you might have Tcl/Tk already installed,
   try executing wish. Else you can find it on Slackware's tcl disk.
      
2. Once you have installed Tcl/Tk, you have to edit a few things in the
   Makefile respectively GNUmakefile if you are using GNU make (default
   on Linux machines).

   If you're running Linux with Slackware 3.0, you can directly proceed
   to step 3 since the Makefile is already set up for you! That is,
   provided you have already installed the Tcl/Tk packages from Slackware's
   tcl disk.
   
   The Makefile contains lots of comments, so it should be pretty clear
   what you have to edit where.
   
3. Configure the included excerpt from BTL 2.1 and [incr tcl] 1.5 by 
   executing:
   
   % make config 
   
   in your shell (don't type the %). You can ignore most of the output
   of this command, especially the ones concerning installation.

   If you are asked for any paths during this step, interrupt by pressing
   Control-C and make sure that the paths you entered in the Makefile are
   correct, e.g. that they actually contain the Tcl/Tk libraries etc.
   Then just execute "make config" again.

   IMPORTANT: You *have to* use the BLT excerpt that comes with TkDesk.
   External libraries will not work! That is because versions older then
   BLT 2.1 don't work either with Tk 4.0 or Tk 4.1, and stock BLT 2.1
   contains a serious bug that keeps bgexec from working. And if your
   concerned about your disk space: The BLT part of TkDesk is only about
   50 kB compiled, so that really shouldn't hurt.
   
4. Compile everything by typing 

   % make

   If you'd like to have a look at TkDesk before installing it, do
   the following:
   1) Comment out the 5th line in the file tkdesk, that's the one
      beginning with "set tkdesk(library)"
   2) Start tkdesk with the command
      % ./tkdesksh tkdesk -configdir ./tcldesk/configs

5. Install TkDesk by typing

   % make install

   If you're upgrading from an earlier version of TkDesk, you're
   ~/.tkdesk directory will not be overwritten. In fact, a ~/.tkdesk
   directory is now only created when TkDesk is run for the first time
   and only if this directory does not exist yet. But have a look at
   the CHANGES file and the default configuration files (in the
   configs subdirectory of TkDesk's library directory, typically
   /usr/local/lib/TkDesk) for new configuration variables.


And that's it! You now should be able to start TkDesk from the command line
by typing "tkdesk". There is some help on using TkDesk available online, this
will hopefully grow with upcoming further releases of TkDesk. The principal
rule is to click on everything with all your mouse buttons (not simultaneously,
though :-)).

If you get an error when executing tkdesk saying something like
"-n: command not found", make sure the head of tkdesk looks like this
(apart from the actual path to tkdesksh):

#!/bin/sh
#-*- tcl -*- \
exec /usr/local/bin/tkdesksh "$0" "$@"

If you have a stray -n somewhere, delete it and everything should work
fine. If not, please tell me about it.

I hope you enjoy TkDesk! If you have any suggestions for the further 
development of TkDesk, or in the unlikely event of finding a bug, or fancy
helping with the further development of TkDesk, please send me an email to 
zzhibol@rrzn-user.uni-hannover.de. I'd also appreciate it if you just told
me what you think about TkDesk in general.

Have fun! Christian

(Following is the copyright notice for TkDesk.)

#    TkDesk - a file manager for Unix and the X Window System
#    Copyright (C) 1996  Christian Bolik
#
#    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; either version 2 of the License, or
#    (at your option) any later version.
#
#    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.
#
#    You should have received a copy of the GNU General Public License
#    along with this program; if not, write to the Free Software
#    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#    See the file "COPYING" in the base directory of this distribution
#    for more.



