INSTALLING TinyQ FOR Unix


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


1.  Unpack the archive if you have not done so already:

	cd /usr/local
	gunzip tinyq-3.0.6.tar.gz   # uncompress the archive
	tar xf tinyq-3.0.6.tar      # unpack it

    This creates the directory /usr/local/tinyq-3.0.6 containing the
    files from the main archive.

    Rename tinyq-3.0.6 to tinyq (or make a symlink):

	mv tinyq-3.0.6 tinyq

    The rest of this file assumes that TinyQ is installed in /usr/local/tinyq.


2.  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.

	QTDIR		   - the directory in which you're building Qt
	PATH		   - to locate the moc program and other Qt tools
	MANPATH 	   - to access the Qt man pages
	LD_LIBRARY_PATH	   - for the shared Qt library

    This is done like this:

    In .profile (if your shell is bash, ksh, zsh or sh), add the
    following lines:

	QTDIR=/usr/local/tinyq
	PATH=$QTDIR/bin:$PATH
	MANPATH=$QTDIR/doc/man:$MANPATH
	LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

	export QTDIR PATH MANPATH LD_LIBRARY_PATH

    In .login (in case your shell is csh or tcsh), add the following lines:

	setenv QTDIR /usr/local/tinyq
	setenv PATH $QTDIR/bin:$PATH
	setenv MANPATH $QTDIR/doc/man:$MANPATH
	setenv LD_LIBRARY_PATH $QTDIR/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 $QTDIR
    and $PATH 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.


3.  Building.

    This step compiles the TinyQ library, and builds the example programs,
    the tutorial, and the tools (eg. the Designer).

    Type:

	./configure

    This will configure the TinyQ library for your machine.
	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 your platform or compiler is not supported, please contact us at
    qt-bugs@trolltech.com so that we can assist you.  If it is supported
    but you have problems, see http://www.trolltech.com/platforms/


    At this point you have binaries created in $QTDIR (eg. $QTDIR/lib/
    contains libtinyq.so). If, however, you would like to have your TinyQ
    installed in a non-local installation you can run configure with
    options splitting TinyQ into different areas for example:

        ./configure -libdir /usr/local/lib -bindir /usr/local/bin -headerdir /usr/local/include/qt

    Then after a successfull make you can:

        make install 

    This will install Qt onto your machine, with these destination options
    you will able to segment Qt into different places on your system
    (please see ./configure -help for the install option section for more
    help). If you choose to install Qt like this, remember you must set
    your LD_LIBRARY_PATH to match your -libdir and your QTDIR to your
    -headerdir (as described in 2 above).


5.  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 'libtinyq.so.3'

    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.


6.  The online HTML documentation is installed in /usr/local/tinyq/html/
    The main page is /usr/local/tinyq/doc/index.html



That's all.  TinyQ is now installed.