Xlpq V1.0.2 - Little frontend to lpq, lprm and lpc using the Xforms library.
Copyright (C) 1996 Christoph Neerfeld (Christoph.Neerfeld@home.ivm.de).

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

--------------------------------------------------------------------------


Most changes in this version were written by Dimitrios P. Bouras <dbouras@hol.gr>
Thank you very much.


NEW: Version 1.0.2 (patch level 2)
----------------------------------
- compiles with xforms v0.88
- some gui and color changes
- requires '-send' option to send a file with lpr


DESCRIPTION
-----------

This program is for people that don't like typing 'lpq -P printerxyz' or 
'lprm -P printerXYZ jobNN', and for peoble having users that don't know how 
to type these commands.

It is just a small frontend to lpq, lprm and lpc. It shows what is currently in
the printer queue, lets you select different queues and lets you delete printjobs.
You may even disable queueing and printing if you are root.

It does not change the queues by itself, but executes one of the commands lpq, lprm, lpc.
So this program should be save as long as lpq, lprm and lpc are save. But as usual 
you use this program at your own risk. Read the GPL for details.


WHAT YOU NEED
-------------

You need X11, of course.
Xforms V0.88 - it may work with older versions of Xforms, but this is not tested.
lpq, lprm, lpc.
properly configured /etc/printcap ( Email me, if you have any problems with this;
                                    if my program has problems reading your printcap,
                                    not if you have problems setting up your printcap
                                    for printing!)

INSTALL
-------

First run './configure', then
'make' should do; 'make install' copies the executable 'xlpq' into /usr/local/bin.
If you don't like this, put it somewhere else in your path. 'xlpq' is the only file
you have to install.

DOCUMENTATION
-------------

ONLY HERE ! There is no man file, or other documentation.

xlpq [ [-h] [-P printer] [-send file] [-bg #6-digit hex color>]
       [-geometry [=][<W>{xX}<H>][{+-}<XO>{+-}<YO>] ]

Without any arguments xlpq searches for the environment variable PRINTER and tries to
display the contents of the corresponding queue. If PRINTER is not set, it displays
the contents of the first printer in your printcap file.

With the file argument you may use xlpq as a replacement for lpr. You don't have to type
'lpr text; xlpq' but may type directly 'xlpq -send text'. xlpq executes lpr for you.
The -P option specifies the spool area to use.
Currently no other options to lpr are supported.

Using xlpq is straight forward: look at it yourself, it is quite selfexplanatory.
Just one word to the 'Auto' button: if this button is pressed, xlpq rereads the current
printqueue every five seconds so you don't have to hit the 'Update' button every time.

If you get the message 'This is a priviliged command', than you have to be root or any other
priviliged user to execute this command and if you try to remove a printjob of another user,
this is silently ignored.

VERSION
-------

This version was written by Dimitrios P. Bouras <dbouras@hol.gr>
He asked me to distribute this version but it is probably the last one.
I ported xlpq to a program called klpq which is part of the KDE project.

If someone likes to take the xforms version over, please contact me.

REPORTING BUGS and SUGGESTIONS
------------------------------
send bugreports concerning xlpq to Christoph.Neerfeld@home.ivm.de

TODO
----


BUGS
----
no man page


