README for GISWxprintglue (=Xprint glue for Solaris) package

This package contains the Xprint glue (startup and configuration files)
which are currently missing in Solaris to use Xprint-based applications
(like Mozilla, Phoenix, Eclipse, Motif2, Qt etc.)

For futher information please consult the Xprint FAQ (available under
/opt/GISWxprintglue/docs/Xprint_FAQ.txt after installation - or see
http://xprint.mozdev.org/ for the newest version) and/or
http://xprint.mozdev.org/

Installation requirements:
==========================
The following Solaris patches are REQUIRED to gurantee correct behaviour of
this package:
* Solaris 2.7/SPARC:
  106541-27   SunOS 5.7: Kernel Update Patch
  107443-17   SunOS 5.7: packaging utilities patch
  107650-08   OpenWindows 3.6.1 X11R6.4 Xprint Extension Patch
  107654-10   OpenWindows 3.6.1: X11R6.4 LBX & XRX Extensions Patch
  107656-11   OpenWindows 3.6.1 libXt Patch
  108376-44   OpenWindows 3.6.1: Xsun Patch
  115228-01   CDE 1.3: dtksh patch
* Solaris 2.7/x86:
  106542-27  SunOS 5.7_x86: Kernel Update Patch
  107444-17  SunOS 5.7_x86: packaging utilities patch
  107651-08  OpenWindows 3.6.1_x86: X11R6.4 Xprint Extension Patch
  107655-10  OpenWindows 3.6.1_x86: X11R6.4 LBX & XRX Extensions Patch
  107657-09  OpenWindows 3.6.1_x86: ERC X11R6.4 Extension Patch
  108377-39  OpenWindows 3.6.1_x86: Xsun Patch

* Solaris 2.8/SPARC:
  108652-74   X11 6.4.1: Xsun patch
  108897-01   X11 6.4.1 Xprint patch
  110934-14   SunOS 5.8: pkgtrans, pkgadd, pkgchk, pkgmk and libpkg.a patch
  114956-02   CDE 1.4: dtksh patch
* Solaris 2.8/x86:
  108653-63   X11 6.4.1_x86: Xsun patch
  110934-14   SunOS 5.8: pkgtrans, pkgadd, pkgchk, pkgmk and libpkg.a patch

* Solaris 2.9/SPARC:
  112785-26   X11 6.6.1: Xsun patch
  113713-03   SunOS 5.9: pkginstall Patch
* Solaris 2.9/x86:
  112786-15   X11 6.6.1_x86: Xsun patch
  114568-02   SunOS 5.9_x86: usr/sadm/install/bin/pkginstall Patch


Installation:
============
1. Install the package:
  % /usr/sbin/pkgadd -d GISWxprintglue.pkg

2. Start Xprint server side:
  a) reboot
    or
  b) start the Xprint servers manually using
     % /etc/init.d/xprint start
     % sleep 30
     and restart your user CDE sessions (e.g. re-login.)

3. Verification:
  After (re-)login into CDE the env variable ${XPSERVERLIST} should be
  set and
  % /opt/GISWxprintglue/bin/xplsprinters
  should list all available printer queues.


Deinstallation:
===============
1. Stop Xprint servers:
  % /etc/init.d/xprint stop

2. Remove the package
  % /usr/sbin/pkgrm GISWxprintglue


Known bugs/issues:
==================
- Printing may remove spaces when monotype fonts (like "-monotype-arial-*")
  are being used by the PostScript driver.
  This is a bug in the Solaris Xprint server binary (/usr/openwin/bin/Xprt).

  Various bug reports have been filed, see
  - SunSolve bugid 4843234 
  - http://xprint.mozdev.org/bugs/show_bug.cgi?id=3353 ("Solaris Xprt looses
    space when rendering with '-monotype-arial-*'-fonts")
  - http://bugzilla.mozilla.org/show_bug.cgi?id=199957 ("Solaris 8 Mozilla
    removes spaces for text within <font face="Arial">...</font>")

  Solution:
    Please apply the patches listed in the section "Installation requirements"
    of this document.
  
  Known workarounds:
  - Remove the '-monotype-arial-*' fonts from the font path
  - Use an alternate Xprint server like available in the "GISWxprint" package
    (this package is identical to the "GISWxprintglue" package except that it
    uses a Xprint server build from xprint.mozdev.org sources and not the
    /usr/openwin/bin/Xprt binary from Solaris)
  - Mozilla-only: Adding
    -- snip --
    user_pref("print.xprint.font.rejectfontpattern",
    "fname=-dt-.*;scalable=.*;outline_scaled=false;xdisplay=.*;xdpy=.*;ydpy=.*;xdevice=.*|" + 
    "fname=-monotype-arial.*;scalable=.*;outline_scaled=.*;xdisplay=.*;xdpy=.*;ydpy=.*;xdevice=.*");
    -- snip --
    to prefs.js works around the problem (see
    http://bugzilla.mozilla.org/show_bug.cgi?id=199957#c6 , too).

- Not all paper sizes defined in the "PSdefault" printer models may be
  available since the Xprint drivers(including the PostScript DDX) within
  Xprt will validate those lists against a buildin list and this list may
  not have been updated yet in Solaris's version of Xprt.


Reporting bugs:
===============
Please send bug reports/comments/questions to 
mailto:roland.mainz@nrubsig.org or
mailto:xprint@mozdev.org

