
INSTALL                        TkDesk 1.1                       02.09.1998
--------------------------------------------------------------------------

 	        Building and Installation of TkDesk 1.1


This file describes how to compile and install the source release of
TkDesk.  Linux users may find precompiled dynamic or static (not
requiring Tcl/Tk) binaries at the TkDesk homepage:
http://people.mainz.netsurf.de/~/bolik/tkdesk/


Requirements
------------

If you have to (or want to) compile TkDesk yourself, you'll need either
Tcl/Tk 7.5/4.1 , or better 7.6/4.2 installed on your system.  Tcl/Tk 8.0
is not supported yet.  It will be once [incr Tcl] supports it without
having to come with its own version of Tcl/Tk.  Note that Tcl/Tk 8.0
can peacefully coexist with older versions of Tcl/Tk, provided these
are installed in a separate directory (e.g. /usr/local/tcl7).

If you don't have the right version of Tcl/Tk installed yet you can get
it from ftp://ftp.scriptics.com/pub/tcl or any mirror site.  The files to
download are tcl7.6p2.tar.gz and tk4.2p2.tar.gz.


Compilation
-----------

To compile TkDesk you first have to create the Makefiles for your system
by running "./configure".  If you don't want to install TkDesk underneath
/usr/local, which is the default, do "./configure --prefix=<path>".

Note: TkDesk's configure looks for the file tclConfig.sh and tkConfig.sh
that are installed with Tcl/Tk, usually in the corresponding "lib"
directory.  It looks in a few "standard" places, but if you installed
Tcl/Tk in a non-standard place (e.g. because you already got Tcl/Tk 8.0
installed), you need to point configure to these directories using the
"--with-tcl=DIR" and "--with-tk=DIR" options.  For example, if you 
installed Tcl 7.6 and Tk 4.2 into /usr/local/tcl7, you'd say:

    configure --with-tcl=/usr/local/tcl7 --with-tk=/usr/local/tcl7

The "--with-tk" option can be omitted if tkConfig.sh is in the same 
directory that's given to "--with-tcl".

When configure exits (successfully), run "make".

If you get an error message saying that "ranlib" could not be found:
This error is ignored by make, and you can safely do the same. Some
systems require archives to be ranlib'ed, others don't.

Linux RedHat users:
There may be a missing symbolic link that you have to create yourself
to link TkDesk.  This is the procedure suggested by David Scott:

   1) Make sure you have /lib/libdl.so.1
   2) Run /sbin/ldconfig
   3) cd /lib
   4) ln -s libdl.so.1 libdl.so
   5) Try compiling again


Test Drive
----------

If you'd like to have a look at TkDesk when make is finished but
before installing it, do the following:

   ./testdrive

   
Installation
------------

Just issue the command "make install" to install the TkDesk binaries and
scripts, the Tcl library, and the manual pages. Note that you may have
to become the root user first to gain write access to the installation
directories.

And that's it! You now should be able to start TkDesk from the command
line by typing "tkdesk".


Where To Go From Here
---------------------

Since 1.0b4 there is a short "Quick Start Guide" available that's
automatically displayed when TkDesk is run for the first time.
It's also available from the browser window's "Help" menu.

The TkDesk User's Guide is available both as PostScript in the "doc"
subdirectory (of the directory created when you untar'ed the TkDesk
package), as well as online via the help button of the application bar
or the "Help" menu.

You may also want to take a look inside the contrib subdirectory
of the TkDesk distribution.  It contains some very interesting extensions,
patches and configuration files contributed by users of TkDesk.
Thank you if you're one of them.

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 
Christian.Bolik@mainz.netsurf.de.  In the near future I will improve the
opportunities for you to contribute to TkDesk, so you may want to keep
an eye on the TkDesk web page at

            http://people.mainz.netsurf.de/~bolik/tkdesk/

Enjoy!

     Christian


(Following is the copyright notice for TkDesk.)

#    TkDesk - a file manager for Unix and the X Window System
#    Copyright (C) 1996-1998  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.

