RCS $Id: README.txt,v 1.3 2001/02/27 06:42:12 ioilam Exp $

        ---   Build Tix binaries for the Unix platforms   ---

Before you start
================

    The Tix home page is at

    http://tixlibrary.sourceforge.net/

    This site also has more information in case you get stuck, such as
    who to contact for questions.

Required Tcl/Tk versions
========================

    You need Tcl/Tk 8.0 or later. Prior versions are no longer
    supported. Tcl 8.3.2 is the recommended version.

Install the Tcl/Tk/Tix sources
==============================

    You need to put the Tcl/Tk/Tix sources in the same directory. For
    example:

        /src/tcl8.3.2
        /src/tk8.3.2
        /src/tix8.2.0

    The example shell commands in the following sections assume the
    sources are installed as above. You need to change them if your
    sources are installed somewhere else.

Build Tcl and Tk
================

    You must build Tcl and Tk first before building Tix. See the
    README files in the Tcl and Tk source directories for more
    info. Here's an example:

        cd /src/tcl8.3.2/unix
        ./configure --enable-shared
        make

        cd /src/tcl8.3.2/unix
        ./configure --enable-shared
        make

Run the Tix configure script
============================

    To see the options for the Tix configure script:

        cd /src/tix8.2.0/unix
        ./configure --help

    In most cases, you want to enable these options:

        ./configure --enable-stubs --enable-shared

    You may also want to set the --prefix and --exec-prefix options if
    you want to install Tix at a directory other than /usr/local.

    If you have several versions of Tcl/Tk sources installed in your
    source directory, you can use the --with-tcl and --with-tk options
    to choose which version to build Tix with.

Build Tix
=========

    After you run the configure script, you'd get a Makefile for
    building Tix. Then, just invoke the "make" command to build the
    Tix binaries.

        cd /src/tix8.2.0/unix
        make

Test Tix
========

    You may want to run the Tix regression test suite to see if things
    work as expected:

        cd /src/tix8.2.0/unix
        make test

    You can also run the Tix widget demos:

        cd /src/tix8.2.0/unix
        make rundemos

Install Tix
===========

    When you're satisfied with the Tix build, you can install it by
    invoking:

        cd /src/tix8.2.0/unix
        make install

    This by default will install the Tix files into the following
    places:

        /usr/local/bin/tixwish8.2             executable
        /usr/local/lib/libtix8.2.so           shared library
        /usr/local/lib/tix8.2/*.tcl           script library
        /usr/local/man/mann/*.n               man pages

    The installation directory may be set using the --prefix and
    --exec-prefix options  to the configure script.

    You may also need to install Tcl and Tk if you haven't already
    done so.

Test the installation
=====================

    To make sure everything works after "make install", do this:

        env TCL_LIBRARY= TK_LIBRARY= TIX_LIBRARY= \
            /usr/local/bin/tixwish /src/tix/tests/all.tcl

    This will ensure Tcl/Tk and Tix can work without any environment
    settings.
