
                          TIX 4.0 INSTALLATION NOTES
                                       
  REQUIREMENTS
  
   This version of Tix requires Tk 4.0 and Tcl 7.4.
   
  INSTALLING TIXWISH
  
   This release of Tix supports the GNU autoconf utility. It should
   compile and run with little or no effort on any UNIX-like system that
   approximates POSIX, BSD, or System V and runs the X Window System. I
   know that it runs on Sun and SGI workstations and also works on Linux
   boxes.
   
   Please follow steps when compiling and installing Tix:
    1. Make sure that this directory and the corresponding release of Tcl
       and Tk are both subdirectories of the same directory. In short, if
       you store the source distributions in the directory
       /home/blah/src/, then it should directory structure should look
       like this,:

       /home/blah/src/tcl7.4/
       /home/blah/src/tk4.0/
       /home/blah/src/Tix4.0b2/

    2. Type "./configure" in the directory Tix4.0b2/src. This runs a
       configuration script created by GNU autoconf, which configures Tix
       for your system and creates a Makefile. The configure script
       allows you to customize the Tix configuration for your site; for
       details on how you can do this, check out the autoconf
       documentation at
       http://csugrad.cs.vt.edu/manuals/autoconf/autoconf_toc.html .
       
       There are several options for running "./configure". You can type
       "./configure --help" for a list of all the options. The options
       that are specific for this version of Tix are:
          + --enable-xpm: This will enable the XPM image reader in the
            Tix library. If you choose this option, you must have the Xpm
            library installed on your system. The Xpm library is usually
            installed on "modern" Unix/X systems as /usr/lib/libXpm.a. If
            you don't have it on your system, you can get a copy of the
            Xpm library from
            ftp://ftp.cis.upenn.edu/pub/ioi/xpm-3.4e.tar.gz.
          + --enable-debug: If you choose this option, the Tix library
            will be compiled with debug information.
          + --enable-patches: If you want to use the tixMwm command, you
            must enable this flag.
   
       
       You can specify these options as command line arguments to
       ./configure. For example:

       % ./configure --enable-xpm

    3. Type "make" in the directory Tix4.0b2/src. This will create a
       library archive called "libtix.a" and an interpreter application
       called "tixwish" that allows you to type Tcl commands
       interactively or execute script files.
       
    4. If the make fails then you'll have to personalize the Makefile for
       your site or possibly modify the distribution in other ways. First
       check the file docs/Porting.html to see if there are hints for
       compiling on your system. If you need to modify Makefile, there
       are comments at the beginning of it that describe the things you
       might want to change and how to change them.
       
    5. Type "make install" to install Tix's binaries and script files in
       standard places. In the default configuration information will be
       installed in /usr/local so you'll need write permission on this
       directory. If you'd like to use a default installation directory,
       you can change the "exec_prefix" and "prefix" definitions in the
       Makefile.
       
    6. At this point you can play with Tcl by invoking the "tixwish"
       program and typing Tcl commands. However, if you haven't installed
       Tix then you'll first need to set your TIX_LIBRARY environment
       variable to hold the full path name of the "Tix4.0b2/library"
       subdirectory. You could try doing the following in the Unix C
       Shell or Bourne Shell
       
     env TIX_LIBRARY=/PATH/TO/TIX/SOURCES/library ./tixwish
   If you haven't installed Tcl and/or Tk then you'll need to set your
       TCL_LIBRARY and TK_LIBRARY environment variable as well (see the
       Tcl and Tk README files for information on this).
       
   If you have trouble compiling Tix, I'd suggest looking at the file
   docs/Porting.html. It contains information that people have sent me
   about changes they had to make to compile Tix in various environments.
   I make no guarantees that this information is accurate, complete, or
   up-to-date, but you may find it useful. If you get Tix running on a
   new configuration and had to make non-trivial changes to do it, I'd be
   happy to receive new information to add to docs/Porting.html. I'm also
   interested in hearing how to change the configuration setup so that
   Tix compiles on additional platforms "out of the box". 
   
   Back to the Tix Documentation Master Index 
     _________________________________________________________________
   
   Last modified Jul 21 23:56 --- Serial 806544116
