Changeset 576 for trunk/README.OS2

Timestamp:

Feb 18, 2010, 1:39:37 AM (15 years ago)

Author:

Dmitry A. Kuminov

Message:

configure.cmd: Enabled printing by default.

File:

• trunk/README.OS2 (modified) (4 diffs)

trunk/README.OS2

@@ -46 +46 @@
 
       http://unix.os2site.com/pub/binary/make/make-3_81beta1-bin-static.zip
+
+  - eCUPS 1.3.11 or later to support printing in Qt. The eCUPS WPI is available
+    at:
+
+      ftp://ftp.netlabs.org/incoming/eCUPS003.wpi   or
+      ftp://ftp.netlabs.org/pub/ecups/eCUPS003.wpi
+
+    Linking against eCUPS also requires pthread.lib:
+
+      http://web.os2power.com/download/lib/pthread-20100217-os2.zip
 
   - LxLite 1.3.3 or above (not tested) if you want Qt DLLs and application
@@ -90 +100 @@
       set PATH=D:\Coding\Qt4\bin;%PATH%
       set BEGINLIBPATH=D:\Coding\Qt4\bin;%BEGINLIBPATH%
+
+  - Install the eCUPS WPI archive to enable printing support. If this WPI is
+    installed, the Qt build system will pick up all necessary libraries
+    automatically. Otherwise, you will need to use the following environment
+    variables to tell it where to look for CUPS:
+
+      set CUPS_INCLUDEPATH=X:\Path\to\CUPS\include
+      set CUPS_LIBS=X:\Path\to\CUPS\lib\libcups.a
+
+    Note that if the eCUPS WPI is not installed and these variables are not set,
+    printing support will be completely disabled in the resulting Qt build.
+
+    You will also need to make sure that pthread.lib is placed somewhere in your
+    system library path so that the compiler can find it.
 
 Note that the QTDIR environment variable used by previous Qt versions is not
@@ -317 +341 @@
 
 
+PRINTING SUPPORT
+
+Starting with version 4.6.1, Qt for OS/2 supports printing through the CUPS
+framework (provided that this support is enabled when building Qt, see the
+respective sections in the beginning of this document). The OS/2 implementation
+of the CUPS framework is provided by the eCUPS package available at
+http://svn.netlabs.org/ecups/.
+
+The Qt Runtime detects the presence of eCUPS in the system on the fly and talks
+to the CUPS daemon directly, bypassing the standard OS/2 printing subsystem.
+This means that in order to print from Qt applications, you don't need to create
+and configure printer objects using the standard OS/2 system printer setup
+procedure -- you only need to install eCUPS and configure your printers in
+there. Please refer to the eCUPS user manual to obtain the detailed instructions
+on how to configure CUPS printers.
+
+
+
 CURRENT LIMITATIONS
 
@@ -368 +410 @@
      relevant parts of code so they should still build.
 
-  9. No QAssistant, no printer support (QT_NO_PRINTER and QT_NO_PRINTDIALOG are
-     defined). No IPV6 support in the network module (QT_NO_IPV6 is defined).
+  9. No QAssistant. No IPV6 support in the network module (QT_NO_IPV6 is
+     defined).
 
   See the project roadmap for more information on the current progress and