Installation

This section describes how to install, configure and build the Qt Toolkit under OS/2.

Requirements

In order to build the Qt Toolkit Version 3 under OS/2 or eComStation you need the following tools:

• Compiler: Innotek GCC 3.3.2 for OS/2 beta 4 updated to CSD1.
  Download and install according to the installation instructions (usr\doc\GCC-3.2.2\Install.os2).
• Linker: IBM ILINK 3.08, a part of the IBM Visual Age C/C++ 3 distribution updated to version 3.08.
  You need only two files, BIN\ILINK.EXE and DLL\CPPOM30.DLL. If you already have IBM Visual Age C/C++ installed, you don't need to do anything else. Otherwise, copy the above two files to some directory.
  Note: A separate distribution of IBM ILINK 5.0 available through the software subscription will not work, because it has some serious bugs related to exporting large amounts of symbols.
• Make utility: GNU Make 3.81beta1. Just unzip the file make.exe to some directory.

Check that the above tooks work, and then proceed to the following step.

Building Qt

1. Unzip the contents of the Qt for OS/2 distribution archive to some directory.
2. Go to that directory, run the configure.cmd script and follow on-screen instructions.
   You will be prompted to enter directories where the script will search for the required tools and to configure the library type you want to build. Note that it is not necessary to remember a full path to a tool -- you can specify an upper-level directory or simply a root directory of the drive you have installed the tools onto.
3. Wait until the compilation process is finished.

If the compilation process fails, you can inspect the file build.log created in the installation directory.

After the Qt library is successfully compiled and built, it is recommended that you place the qt.cmd script that was generated in the installation directory to some of the directories listed in your PATH environment variable and use it as a command line wrapper to work with the Qt Toolkit: run tutorials and examples, compile your own programs, etc. The script sets up the environment necessary for the Qt Toolkit and for all other tools and simply passes all command line arguments to the command line interpreter. For example, in order to run the last Qt tutorial application, go to the subdirectory tutorial\t14 located inside the installation directory and execute the following command (provided that you have already placed qt.cmd somewhere in the PATH):

qt.cmd t14.exe

To recompile the tutorial you can type

qt.cmd make