*****************************************************
   WARNING: the current status of klp is alpha !!!
*****************************************************


What is `klp' ?
---------------

klp is a GUI based replacement/wrapper for lpr/lpq/lprm (or similar in case
of other types of print servers).  It manages the print queue of printers. 
klp is intended for use with the K Desktop Environment <http://www.kde.org>.

You can print by drag&drop documents from KDE's filemanager on it.

You can view the queue and remove items from it.

klp works with several types of print servers:

 - BSD-lpr / LPRng local printers
   You need a local lpd server up and running, as well as locally installed
   copies of lpq/lprm/lpr.

 - BSD-lpr / LPRng remote printers
   This is the best one (the one klp was originally designed for).  You
   don't need anything but klp as it connects directly to the remote print
   server.  You must have access to the remote host, and klp must be
   installed setuid(root).

 - NetWare printers
   You must have local copies of nwqstat/nwdelqjob/nwprint.

 - Future versions may support other types of print servers.  Ask about it,
   it really helps !  (actually, the NetWare support was added because
   people asked for it).  Currently, I'm thinking about PPR and Samba.

klp can dock itself in the panel, still showing the printer status.  The
docked icon also allows printing by drag&drop.

klp's homepage: <http://rulhmpc49.LeidenUniv.nl/~klp>


What do you need ?
------------------

  - You need to have KDE (version 1.0) up and running
  - K libraries & include files
  - Qt libraries & include files (version 1.40 or newer)
  - a compiler


Quick install guide
-------------------

  - unpack klp with `gunzip -c klp-0.2.tar.gz | tar -x'
  - in the (newly created) directory klp-0.2 run `./configure'
  - run `make'
  - run `make install' (probably as root, but not necessarily)
  - if you want to use remote BSD-lpr / LPRng printers, you _must_ make the
    klp binary setuid(root) !
  - done !

(for more information, read the file INSTALL)


Making klp setuid(root) ...
---------------------------

If you use _remote_ BSD-lpr/LPRng printers, you _must_ make the klp binary
setuid(root).  Don't worry ... klp temporarily drops root permissions, and
only reactivates them when strictly needed.  The GUI frontend drops root
permissions altogether.  It's pretty safe.


What is so `alpha' about klp ?
------------------------------

Well ... the fact that it has been tested only by a few persons.
It works for me; it just _might_ work for you too ;-)

What I need is feedback:
  - any ./configure problems ?
  - any compile problems (errors and/or warnings) ?
  - any install problems ?
  - any setup problems ?
  - "garbled" information (or none at all) in the queue list ?
  - any sudden crashes under "normal" operation ?

Look for memory leaks with `ps' (klp uses two processes: a frontend and a
server which share the same binary executable).  Try running klp from a
console, so you can see any errors/warnings printed to stderr.


Known BUGS
----------

Not really bugs that I know of yet, but more like missing features:
  - The diplayed queue may be incorrect for "chained queues", i.e. connecting
    to a lpd daemon that itself is configured for remote printing to another
    lpd daemon.  Instead, try to connect directly to the final lpd daemon in
    the chain.
  - You can't print remote URL's (yet).
  - printing/removing jobs doesn't report success/failure yet.  It appears
    like they always succeed.


Sending feedback
----------------

Besides helping on the TODO list, you can help significantly by sending
feedback.  Please attach any error output from the build fase, or, if you
make it that far, from klp's output to a console.  In case the queue
information is wrong: attach output from running `lpq' or `nwqstat' from the
command line.  Please, don't hesitate sending comments / reports / critisism
/ suggestions.  Such feedback will be silently stripped from any flames, but
otherwise used with all due respect.


Frans van Dorsselaer
<dorssel@MolPhys.LeidenUniv.nl>
