This is Qt version %VERSION%.

Qt is a comprehensive cross-platform C++ application framework. With

this pre-release you can make advanced graphical applications and

utilize TCP/IP connections. All modules except Qt3Support are available

on Maemo 5.

INSTALLING Qt

Follow the instructions in the INSTALL file.

REFERENCE DOCUMENTATION

The Qt reference documentation is available locally in Qt's doc/html

directory or at http://doc.trolltech.com/4.6-snapshot/index.html

SUPPORTED PLATFORMS

For this release, the official Maemo 5.0 SDK has been tested.

Device testing was done on a N900 with PR 1.1 (Version 2.2009.51-1)

HOW TO REPORT A BUG

We have set up a special mailing list for feedback on the Maemo port.

Feedback or questions all go to this list.

To join, send a mail with the subject set as "subscribe" to:

    qt-maemo-feedback-request@trolltech.com

To report bugs, use the public bug tracking tool at

    http://bugreports.qt.nokia.com/

Make sure to include "Maemo 5" in the "Component" list of your bug report.

Always include the following information in your bug report:

the version of Qt you are using, and what configure options it was

compiled with.

If the problem you are reporting is only visible at run-time, try to

create a small test program that shows the problem when run. Often,

such a program can be created with some minor changes to one of the

many unit tests in Qt's tests/auto directory.

KNOWN ISSUES

   * OpenGL ES 2 is not stable

                   INSTALLING Qt for Maemo Version %VERSION%

Note: These instructions only apply if you choose to build your own version

of Qt. For most users, we suggest to install the pre-made Qt binaries that

are in Maemo's "extras-devel" repository. See

    http://wiki.maemo.org/Qt4_Hildon

for details.

1.  Install needed IDE and SDKs

    Make sure you have the following installed:

    - Scratchbox

    - Maemo 5 SDK

    Both are available from Forum Nokia:

    http://www.forum.nokia.com/Tools_Docs_and_Code/Tools/Platforms/Maemo/

    Follow the Maemo 5 SDK installation instructions.

    For OpenGL ES 2 support for scratchbox ARM (not for scratchbox x86 targets!),

    the packages opengles-sgx-img-common-dev and libgles2-sgx-img-dev are required.

    If they are not already installed, run the following command:

        fakeroot apt-get install opengles-sgx-img-common-dev libgles2-sgx-img-dev

    Note: If these packages cannot be found, you probably forgot to do step 7 of the

          Scratchbox installation instructions:

          " 7. Proceed further to accept the EULA in order to obtain

               the Nokia proprietary binary packages. These Nokia binaries

               are essential for the complete functionality of the Maemo SDK."

           See http://wiki.maemo.org/Documentation/Maemo_5_Final_SDK_Installation

2.  Install Qt

    Uncompress the package into any directory, e.g. $HOME/qt

3.  Configure Qt

    To configure Qt for Maemo 5 for ARM, do:

        cd $HOME/qt

        configure -maemo5 -opengl es2 --prefix=/opt/yourorganization

    For x86, OpenGL ES 2 is not available, so the opengl parameter can be omitted:

        configure -maemo5 --prefix=/opt/yourorganization

    For other options, type "configure -help" to get a list of all available

    options.

5.  Build Qt

    To build Qt, type:

        make

    To install Qt to its destination folder, type:

        make install

    Congratulations, Qt is now ready to use.

    We hope you will enjoy using Qt.