Installing TQt/X11

You may need to be root, depending on the permissions of the directories where you choose to install TQt.

Unpack the archive if you have not done so already:
```
    cd /usr/local
    gunzip qt-x11-version.tar.gz    # uncompress the archive
    tar xf qt-x11-version.tar       # unpack it
```
This creates the directory /usr/local/qt-version containing the files from the main archive.
Rename qt-version to qt (or make a symlink):
```
    mv qt-version qt
```
The rest of this file assumes that TQt is installed in /usr/local/qt.
Set some environment variables in the file .profile (or .login, depending on your shell) in your home directory. Create the file if it is not there already.
- TQTDIR -- the directory in which you're building TQt
- PATH -- to locate the tqmoc program and other TQt tools
- MANPATH -- to access the TQt man pages
- LD_LIBRARY_PATH -- for the shared TQt library
This is done like this:
In .profile (if your shell is bash, ksh, zsh or sh), add the following lines:
```
    TQTDIR=/usr/local/qt
    PATH=$TQTDIR/bin:$PATH
    MANPATH=$TQTDIR/man:$MANPATH
    LD_LIBRARY_PATH=$TQTDIR/lib:$LD_LIBRARY_PATH

    export TQTDIR PATH MANPATH LD_LIBRARY_PATH
```
In .login (in case your shell is csh or tcsh), add the following lines:
```
    setenv TQTDIR /usr/local/qt
    setenv PATH $TQTDIR/bin:$PATH
    setenv MANPATH $TQTDIR/man:$MANPATH
    setenv LD_LIBRARY_PATH $TQTDIR/lib:$LD_LIBRARY_PATH
```
After you have done this, you will need to login again, or re-source the profile before continuing, so that at least $TQTDIR is set. The installation will give an error message and not proceed otherwise.
On AIX set LIBPATH and on HP-UX set SHLIB_PATH instead of LD_LIBRARY_PATH.
Note that the SGI MIPSpro o32 and Sun WorkShop 5.0 targets are no longer supported as of TQt 3.3.
Install your license file as $HOME/.qt-license. For the free edition and evaluation version, you do not need a license file.
Compile the TQt library, and build the example programs, the tutorial and the tools (e.g. TQt Designer) as follows.
Type:
```
    ./configure
```
This will configure the TQt library for your machine. Note that GIF support is turned off by default. Run ./configure -help to get a list of configuration options. Read PLATFORMS for a list of supported platforms.
To create the library and compile all examples and the tutorial:
```
    make
```
If you have problems, see http://www.trolltech.com/platforms/.
In very few cases you may need to run /sbin/ldconfig or something similar at this point if you are using shared libraries.
If you have problems running the example programs, e.g. messages like
```
    can't load library 'libtqt.so.2'
```
you probably need to put a reference to the qt library in a configuration file and run /sbin/ldconfig as root on your system. And don't forget to set LD_LIBRARY_PATH as explained in 2) above.
The online HTML documentation is installed in /usr/local/qt/doc/html/ The main page is /usr/local/qt/doc/html/index.html. The man pages are installed in /usr/local/qt/doc/man/. The documentation is also accessible using TQt Assistant.

You're done. TQt is now installed.

Trademarks

TQt 3.3.8