source: trunk/README.OS2@ 152

This is Beta 1 of Qt version 4.5.1 for OS/2 and eCS.

This document contains a brief information on the OS/2
version of the Qt library. Please visit the project page at

  http://svn.netlabs.org/qt4/wiki

to get more information and the latest news and to report bugs.


REQUIREMENTS

In order to compile the Qt library, you will need the following tools:

  - One of the OS/2 Warp 4, OS/2 Warp 4.5 or eComStation operating systems.

  - InnoTek GCC compiler version 3.3.5 CSD3 or above (not tested).
    You can download a copy of the compiler using the following link:

      ftp://ftp.netlabs.org/pub/gcc/GCC-3.3.5-csd3.zip

  - Patched OpenWatcom linker which you can download from:

      ftp://ftp.netlabs.org/pub/gcc/wl-hll-r1.zip

    Note that if you use IBM ILINK (no matter what version), you will
    not be able to build the debug version of the library due to
    bugs/limitations of ILINK.

  - GNU Make 3.81beta1 or above (not tested) available at:

      http://unix.os2site.com/pub/binary/make/make-3_81beta1-bin-static.zip

After unpacking the GCC archive, you will have to set up the compiler
environment by invoking gccenv.cmd from the bin subdirectory with the
correct arguments (type gccenv.cmd -? for help). For the OpenWatcom
linker, specify WLINK as the second argument. You will also need to perform
the following steps:

  - Make sure the selected linker and the make utility are in PATH.

  - Make sure CMD.EXE is your command line processor (the generated makefiles
    will rely on its 'copy', 'if' and other commands).

  - set LIBRARY_PATH=C:\OS2\DLL;C:\MPTN\DLL where C: is your boot drive.

  - set QMAKESPEC=os2-g++

  - set QTDIR=<path_to_Qt4_sources>

When the environment is set up, go to the directory where you unpacked the
Qt4 source tree and type:

  configure.cmd

This will set up the library (create necessary configuration and include files)
and build the qmake utility.

Then go to the src subdirectory and type:

  qmake
  make

This will compile and link the library. Note that by default both the release
and the debug version of the library are built (please be patient, it may take
quite some time depending on your hardware). The release and debug libraries can
co-exist in the same source tree and may be used in parallel: all the debug DLLs
get a 'd' letter in their name preceeding the Qt major version number and use
separate directories for object files.

Once the library is successfully built, you may try to compile the demos
and examples by visiting the individual example's subdirectory in the source
tree and typing 'qmake' followed by one of 'make', 'make release' or
'make debug' in that subdirectory.


CURRENT LIMITATIONS

  1. configure.cmd is not yet capable of generating the main Makefile and
     individual Makefiles for modules and examples. This needs to be done by
     hand (as described above).

  2. Beta 1 can only use one font at the moment, C:\PSFONTS\HELV.PFB.
     Make sure this file exists.

  3. Make sure you have the LANG environment variable properly set.
     The format is ll_CC[.codepage] where ll is the language code,
     CC is the country code and codepage is the optional code page
     to use. If LANG is missing or invalid, string conversion operations
     may work incorrectly resulting in distorted text input or output.

  4. Some functionality of the already available Qt classes may be limited or
     unimplemented. If you find such a case and there is no ticket for it
     in the bug tracker, feel free to add one.

  5. There is no Network module yet, so networking applications will
     not compile.

  6. No native PM style.

  7. No QDesigner, QLinguist and QAssistant.

  8. No Drag&Drop, no printer support, no sound. See the project roadmap for
     more information on the progress and current limitations:

       http://svn.netlabs.org/qt4/roadmap


CREDITS

Dmitry A. Kuminov (development)
Silvan Scherrer (management)

netlabs.org (hosting & support)

Nokia Corporation (original Qt library)

We also want to THANK all individuals and organizations who made the donations
to this project and helped to make it happen. Please visit

  http://qt.netlabs.org/en/site/index.xml

to get the full list of sponsors and to find information on how you can support
the project.



Qt is a trademark of Nokia Corporation and/or its subsidiary(-ies).
OS/2 and OS/2 Warp are trademarks of the IBM Corporation and/or its subsidiary(-ies).
eComStation is a trademark of Serenity Systems International and/or its subsidiary(-ies).
Etc.