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 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168
|
/****************************************************************************
** $Id$
**
** Installation page
**
** Copyright (C) 2000-2002 Trolltech AS. All rights reserved.
**
** This file is part of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Trolltech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** This file may be distributed and/or modified under the terms of the
** GNU General Public License version 2 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.
**
** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
** licenses may use this file in accordance with the Qt Commercial License
** Agreement provided with the Software.
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
** information about Qt Commercial License Agreements.
** See http://www.trolltech.com/qpl/ for QPL licensing information.
** See http://www.trolltech.com/gpl/ for GPL licensing information.
**
** Contact info@trolltech.com if any conditions of this licensing are
** not clear to you.
**
**********************************************************************/
/*! \page installation.html
\title Installation
The installation procedure is different for the different Qt platforms:
\list
\i \link install-x11.html Qt/X11 \endlink
\i \link install-win.html Qt/Windows \endlink
\i \link emb-install.html Qt/Embedded \endlink
\endlist
*/
/*! \page install-x11.html
\title Installing Qt/X11
You may need to be root, depending on the permissions of the directories
where you choose to install Qt.
\list 1
\i Unpack the archive if you have not done so already:
\code
cd /usr/local
gunzip qt-x11-version.tar.gz # uncompress the archive
tar xf qt-x11-version.tar # unpack it
\endcode
This creates the directory /usr/local/qt-\e version containing the
files from the main archive.
Rename qt-\e version to qt (or make a symlink):
\code
mv qt-version qt
\endcode
The rest of this file assumes that Qt is installed in /usr/local/qt.
\i 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.
\list
\i QTDIR -- wherever you installed Qt
\i PATH -- to locate the moc program and other Qt tools
\i MANPATH -- to access the Qt man pages
\i LD_LIBRARY_PATH -- for the shared Qt library
\endlist
This is done like this:
In .profile (if your shell is bash, ksh, zsh or sh), add the
following lines:
\code
QTDIR=/usr/local/qt
PATH=$QTDIR/bin:$PATH
MANPATH=$QTDIR/man:$MANPATH
LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export QTDIR PATH MANPATH LD_LIBRARY_PATH
\endcode
In .login (in case your shell is csh or tcsh), add the following lines:
\code
setenv QTDIR /usr/local/qt
setenv PATH $QTDIR/bin:$PATH
setenv MANPATH $QTDIR/man:$MANPATH
setenv LD_LIBRARY_PATH $QTDIR/lib:$LD_LIBRARY_PATH
\endcode
After you have done this, you will need to login again, or
re-source the profile before continuing, so that at least $QTDIR
is set. The installation will give an error message and not
proceed otherwise.
\i Install your license file. For the free edition, you do not need
a license file. For Professional and Enterprise editions, install
your license file as described in your distribution.
\i Compile the Qt library, and build the example programs,
the tutorial and the tools (eg. the Designer) as follows.
Type:
\code
./configure
\endcode
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 examples and the tutorial:
\code
make
\endcode
If you have problems, see
\l http://www.trolltech.com/platforms/.
\i 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
\code
can't load library 'libqt.so.2'
\endcode
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.
\i 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/
\endlist
You're done. Qt is now installed.
*/
/*! \page install-win.html
\title Installing Qt/Windows
The Qt/Windows distribution is distributed as a self-extracting archive
with a built-in installer. Just follow the installation wizard.
*/
|