
Xprint server for Linux/AIX/IRIX README

8th release of the Xprt (X11 print server) build from xprint.mozdev.org sources

Disclaimer:
We do not guarantee that any source code or executable code available from the 
in this package is Year 2000 compliant, works in any way or may not eat your
harddisk alive.

Please read the the Xprint_FAQ.txt how to configure Xprint.

* Installation and usage 
  (short version, reading the Xprint_FAQ.txt first is better):
a) For the impatient, the hurry or if you do not have the "root"-password or if 
   you do not want to try this as "root":
     1. Unpack the tarball to your favourite dir:
       % mkdir /tmp/test_xprint
       % cd /tmp/test_xprint
       % gunzip -c xprint_linux_tarball.tar.gz | tar -xvf -

     2. Start the Xprint server
        ("./run_xprint_from_tarball.sh" is a wrapper script
        for the "/etc/init.d/xprint" script which tells that script where the
        Xprint server files are currently be located.)
       % cd xprint
       % ./run_xprint_from_tarball.sh start
  
     3. Set the ${XPSERVERLIST} env var (and/or put this into your shell profile,
        do not forget to specify the _full_ path to the "run_xprint_from_tarball.sh"
        script):
       # sh
       % XPSERVERLIST="`./run_xprint_from_tarball.sh get_xpserverlist`"
       % export XPSERVERLIST
       
       # ksh/bash syntax
       % export XPSERVERLIST="$(./run_xprint_from_tarball.sh get_xpserverlist)"

     4. Verifying that Xprint is running and working 
       (this is usually "done" by /usr/X11R6/bin/xplsprinters - but the
        "./run_xprint_from_tarball.sh" / "/etc/init.d/xprint" scripts provide
        a wrapper for that tool, too):
       % ./run_xprint_from_tarball.sh lsprinters

     5. Run the application you want to use
       % /usr/local/bin/bin/mozilla

     * Alternatively you can replace step [3] and [5] with:
       % ./run_xprint_from_tarball.sh wrapper /usr/local/bin/bin/mozilla
  
a) If you have adminstrator priviledges ("root") on your machine:
  # There are binary and source RPMs for Linux, *.deb packages for Debian and
  # *.pkg packages for Solaris available at http://xprint.mozdev.org,
  # the tarball installation is only for those platforms which are not coverd
  # by the list above or for those people who only want to run Xprint per-user
  # without installing it permanently <--

  1. Make sure that you eliminate any existing Xfree86-based Xprt servers.
     All Xprt binares build from Xfree86 sources up to today are broken and
     will not work.
     Example:
     % which Xprt
     /usr/X11R6/bin/Xprt
     % mv /usr/X11R6/bin/Xprt /usr/X11R6/bin/Xprt_xf86_disabled

  2. Copy the files in dist/usr into the matching dirs on your hard disk:
     Example:
     % (cd install; chmod -R og=u,og-w . ; tar -cf - usr etc) | (cd / ; tar -xf -)

  3. Start X print server:
     % /etc/init.d/xprint start

  4. Make the info available where the applications can find Xprint server(s):
     For all users (maybe in /etc/profile):
     % XPSERVERLIST="`/etc/init.d/xprint get_xpserverlist`"
     % export XPSERVERLIST
     (this step is optional for systems which support /etc/profile.d/ ; the tarball
     comes with /etc/profile.d/xprint.sh and /etc/profile.d/xprint.csh which will
     set the XPSERVERLIST env var for all users if the Xprint servers are running)

    # Do not set $DISPLAY to the Xprt server. You still need your normal
    # Xserver for your video card(=framebuffer) - Xprt is only for your
    # printer(s).

  5. Verifying that Xprint is running and working 
    % /usr/X11R6/bin/xplsprinters
      OR
    % ./run_xprint_from_tarball.sh lsprinters

* Top two of the issues on Linux (all items from the FAQ):
  ("P"=problem, "B"=background, "S"=solution", "W"=Workaround)
  1. P: "Printing works but the printout is covers only 1/4 of the page"
     B: This is usually an indicator for a wrong DPI setting. The default
        "PSdefault" model config uses 300DPI but some printers use 600DPI.
     W: Edit ${XPCONFIGDIR}/C/print/attributes/document and replace the line
        "*default-printer-resolution: 300" with
        "*default-printer-resolution: 600"
     S: Create a model-config for your printer which only contains attributes
        supported by your printer (read the docs... :)
   
  2. P: "Printing works but I get large borders..."
     B: Same issue as issue [2] - wrong DPI
     S: Check the DPI value and adjust it as described in [2]. Common DPI
        values are 240, 300, 360, 400 and 600 DPI.

More info will follow when I have time, take a look at the Xprint pages at
http://xprint.mozdev.org/ in the meantime...

----

Bye,
Roland

-- 
  __ .  . __
 (o.\ \/ /.o) roland.mainz@nrubsig.org
  \__\/\/__/  MPEG specialist, C&&JAVA&&Sun&&Unix programmer
  /O /==\ O\  TEL +49 2426 901568 FAX +49 2426 901569
 (;O/ \/ \O;) 


