Add Qt3 development HEAD version

1 files changed, 300 insertions, 0 deletions

diff --git a/doc/installation.doc b/doc/installation.doc
new file mode 100644
index 0000000..e7e5703
--- /dev/null
+++ b/doc/installation.doc
@@ -0,0 +1,300 @@
+/****************************************************************************
+**
+** Installation page
+**
+** Copyright (C) 2000-2008 Trolltech ASA.  All rights reserved.
+**
+** This file is part of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free
+** Software Foundation and appearing in the files LICENSE.GPL2
+** and LICENSE.GPL3 included in the packaging of this file.
+** Alternatively you may (at your option) use any later version
+** of the GNU General Public License if such license has been
+** publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing requirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file.  Licensees holding valid Qt
+** Commercial 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 WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+/*! \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 install-mac.html Qt/Mac \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 \c /usr/local/qt.
+
+\i  Set some environment variables in the file \c .profile (or \c .login,
+    depending on your shell) in your home directory. Create the
+    file if it is not there already.
+
+    \list
+    \i QTDIR -- the directory in which you're building 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 \c .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 \c .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 \c $QTDIR
+    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 Qt 3.3.
+
+\i  Install your license file as \c $HOME/.qt-license.
+    For the free edition and evaluation version, you do not need a license
+    file.
+
+\i  Compile the Qt library, and build the example programs,
+    the tutorial and the tools (e.g. \link designer-manual.book Qt
+    Designer\endlink) 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 \c{./configure -help}
+    to get a list of configuration options. Read \c 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 \c /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 \c /sbin/ldconfig as root on your system.
+    And don't forget to \c set LD_LIBRARY_PATH as explained in 2) above.
+
+\i  The online HTML documentation is installed in \c /usr/local/qt/doc/html/
+    The main page is \c{/usr/local/qt/doc/html/index.html}.
+    The man pages are installed in \c{/usr/local/qt/doc/man/}.
+    The documentation is also accessible using \link assistant.book Qt
+    Assistant\endlink.
+\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.
+
+*/
+*/
+
+/*! \page install-mac.html
+
+\title Installing Qt/Mac
+
+You may need to be logged in as 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 /Developer
+    gnutar xzf qt-mac-version.tar.gz
+\endcode
+
+    This creates the directory /Developer/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 unpacked in \c /Developer/qt.
+
+\i  Set some environment variables in the file \c .profile (or \c .login,
+    depending on your shell) in your home directory. Create the
+    file if it is not there already.
+
+    \list
+    \i QTDIR -- the directory in which you're building 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 \c .profile (if your shell is bash, ksh, zsh or sh), add the
+    following lines:
+
+\code
+    QTDIR=/Developer/qt
+    PATH=$QTDIR/bin:$PATH
+    MANPATH=$QTDIR/man:$MANPATH
+    DYLD_LIBRARY_PATH=$QTDIR/lib:$DYLD_LIBRARY_PATH
+
+    export QTDIR PATH MANPATH DYLD_LIBRARY_PATH
+\endcode
+
+    In \c .login (in case your shell is csh or tcsh), add the following lines:
+
+\code
+    setenv QTDIR /Developer/qt
+    setenv PATH $QTDIR/bin:$PATH
+    setenv MANPATH $QTDIR/man:$MANPATH
+    setenv DYLD_LIBRARY_PATH $QTDIR/lib:$DYLD_LIBRARY_PATH
+\endcode
+
+    After you have done this, you will need to login again, or
+    re-source the profile before continuing.
+
+\i  If you have the commercial edition of Qt, install your license
+    file as \c $HOME/.qt-license.
+
+\i  Compile the Qt library, and build the example programs,
+    the tutorial and the tools (e.g. \link designer-manual.book Qt
+    Designer\endlink) as follows.
+
+    Type:
+\code
+    cd $QTDIR
+    ./configure
+\endcode
+
+    This will configure the Qt library for your machine. Note that
+    GIF support is turned off by default. Run \c{./configure -help}
+    to get a list of configuration options.
+
+    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  Once you have built Qt, it is ready to use. If Qt has not been
+    configured with the -static option, then in order to be able to
+    launch Qt applications from the Finder you must place the relevant
+    libraries in a directory where they can be found. We recommend
+    making these symbolic links (if you have configured Qt with -thread
+    please change the libqt below with libqt-mt):
+
+\code
+    ln -sf $QTDIR/lib/libqt.3.dylib /usr/lib
+    ln -sf $QTDIR/lib/libqui.1.dylib /usr/lib
+\endcode
+
+    You may need to have 'administrator' access to do this, (in which
+    case, precede each command with \c sudo', e.g. \c{sudo ln -s ...}). If
+    you use sudo you'll be prompted for the administrator password.
+
+    If you do not have administrator access, or you would prefer to do
+    a user install (rather than system install) of the libraries you
+    can do (if you have configured Qt with -thread please change the libqt
+    below with libqt-mt):
+
+\code
+    ln -sf $QTDIR/lib/libqt.3.dylib $HOME/lib
+    ln -sf $QTDIR/lib/libqui.1.dylib $HOME/lib
+\endcode
+\endlist
+
+That's all! Qt is now installed. Qt's documentation can be read with
+Qt Assistant or by any web browser; the contents page is
+\c $QTDIR/doc/html/index.html.
+
+*/