summaryrefslogtreecommitdiffstats
path: root/INSTALL
blob: 92baa9691fa665729ac747805ce8e3136fb78fc5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
			  INSTALLING Qt/X11 Version 3.3.8


You may need to be logged in as root, depending on the permissions of
the directories where you choose to install Qt.


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

	cd /usr/local
	gunzip qt-x11-free-3.3.8.tar.gz	# uncompress the archive
	tar xvf qt-x11-free-3.3.8.tar	# unpack it

    This creates the directory /usr/local/qt-x11-free-3.3.8 containing the
    files from the main archive.

    Rename qt-x11-free-3.3.8 to qt (or make a symlink):

	mv qt-x11-free-3.3.8 qt

    The rest of this file assumes that Qt is installed in /usr/local/qt.


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

    Note that under IRIX the additional LD_LIBRARYN32_PATH and
    LD_LIBRARY64_PATH variables are used for specifying library
    search paths. Set the variable that matches your configuration, or
    see the rld(5) man page for more information.
    On AIX set LIBPATH and on HP-UX set SHLIB_PATH instead of LD_LIBRARY_PATH.

    This is done like this:

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

	QTDIR=/usr/local/qt
	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/qt
	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 are set. Without these the installation will halt with an error
    message.

    Note that the SGI MIPSpro o32 and Sun WorkShop 5.0 targets are no
    longer supported as of Qt 3.3.

3.  Install your license file as $HOME/.qt-license.
    For the free edition and evaluation version, you do not need a license
    file.


4.  Building.

    This step compiles the Qt library, and builds the example programs,
    the tutorial, and the tools (e.g. Qt Designer).

    Type:

	./configure

    This will configure the Qt 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 the examples and the
    tutorial, type:

	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/ for
    information on known issues.


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

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

    If you supplied a custom install directory using the -prefix
    parameter in step 2, you can:

	make install

    This will install Qt onto your machine using the paths you've set.
    (See ./configure -help for more information). If you choose to
    install Qt like this, remember that 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 'libqt.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/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/



That's all.  Qt is now installed.