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

        ---   Build Tix binaries for the Win32 platform   ---

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

    If you are not familiar with Windows or do not have a working
    win32 compiler, you can download a Tix windows binary from

    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.

Supported Compilers
===================

  + MSVC 5.x and 6.x: use makefile.vc
  + Cygwin + gcc:     use makefile.gnu

    If you don't want to pay for the VC++ compiler, you can get Cygwin
    from http://www.cygwin.com/

    Note, if you are using an old version of Cygwin (such as B20), you
    need to upgrade to the latest version of Cygwin from the website
    mentioned above, or else GCC will give you funny errors about
    "duplicated .text section."

    No other compilers are currently supported. If you have Borland
    C++, you can try to make makefile.bc work (it was intended for
    Borland 4.5/5.x.)
   
Customizing your build
======================

    The recommended method of customizing your build is to create a
    file called "Makefile" in this directory. Set the MAKE variables
    that you want to modify. Then, include the makefile.{vc,bc,gnu}.

    You can look at the top of the makefile.{vc,bc,gnu} files for the
    variables that you can modify.

    For example, if you use VC++, and you want to change the version
    of Tcl/Tk to build with, create a Makefile like this:

    ------------------------------------------------------------------
    # My own makefile ...
    TCL_MAJOR 	= 8
    TCL_MINOR 	= 4
    TCL_PATCH 	=
    !include "makefile.vc"
    ------------------------------------------------------------------

    The advantage of this method is you can reuse your customization
    Makefile across different Tix source releases without doing the
    same modifications again and again.

Building the binaries
=====================

    + First, you need to download the Tcl/Tk sources and install them to
      along with Tix inside the same directory. You can download Tcl/Tk from

      http://www.scriptics.com/

    + If you use VC++: build both Tcl and Tk using the win/makefile.vc
      files that come with Tcl and Tk.

    + If you use Cygwin, download the Tcl binary distribution of the
      same version as the Tcl/Tk sources from
      http://www.scriptics.com/ and install it on your PC.

    + Create the customization Makefile for Tix as mentioned above.

    + Execute your favorite MAKE program in this directory.
      E.g., if you use VC++:

        cd win
        nmake

      If you use Cygwin:

        cd win
        make

    This should produce various .DLL and .EXE files in the Release or
    Debug subdirectories.

Testing your build
==================

    Run the following command in this directory to run the Tix
    regression test suite.

        nmake test              -- with VC++, or
        make test               -- with Cygwin

    Run the following command in this directory to run the Tix
    widget demos.

        nmake rundemos          -- with VC++, or
        make rundemos           -- with Cygwin


Installing Tix
==============

    The makefiles in this directory has a crude method of installing
    Tix on your local machine. E.g.,

        nmake install  

    The default installation directory is C:\Program Files\Tcl. You
    can customize this location by setting the INSTALL_DIR variable in
    your customization Makefile.

    Nevertheless, if you're planning a wide distribution of Tix across
    many PC's, you probably need to create an installer program or use
    more advanced administrator tools.

Using Tix in your Tcl scripts
=============================

    Once Tix is installed properly on your machine, simple execute the
    "package require Tix" command in your Tcl scripts to access the
    Tix features.

    See the file ../demos/widget for examples.
