.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KJOBVIEWER 1 "June 2006" "K Desktop Environment" "A print job viewer"
.SH NAME
kjobviewer
\- a print job viewer
.SH SYNOPSIS
\fBkjobviewer\fP [Qt\-options] [KDE\-options] [options] 
.SH DESCRIPTION
\fBKJobViewer\fP is a powerful queue and spool manager. You can view jobs in the different queues waiting for print as well as manipulate jobs in many ways.
.sp 1
The details are, again, as with all other modules of \fBKDEPrint\fP, dependent on the print subsystem in use. \fBCUPS\fP, as is usual now, in this field is the most feature\-complete system for "doing something with jobs that are sent away already and wait for print, possibly on a remote print server".
.sp 1
With kjobviewer you can...
.IP "     \-"
see an overview for a certain queue or see all jobs on all queues;
.IP "     \-"
filter the list to see your "own" jobs only;
.IP "     \-"
sort the pending jobs according to different criteria (size, ownership, job\-ide, job\-name; billing\-tags);
.IP "     \-"
stop a job from printing, putting it into a "held" state;
.IP "     \-"
re\-start a held job;
.IP "     \-"
manually release a job that was sent to "hold" from the client already;
.IP "     \-"
reschedule a job for printing at a specified time;
.IP "     \-"
increase or decrease the job\-priorities (allowed values are 1\-100) to re-arrange the order of automatic printing;
.IP "     \-"
move a job to a different print\-queue;
.IP "     \-"
stop jobs from leaving the queue (while still accepting incoming ones);
.IP "     \-"
reject new incoming jobs (while still printing all the pending ones until the queue is empty);
.IP "     \-"
check and re\-set all job options \-\- even adapt them to another target printet which might have a complete different set of commands;
.IP "     \-"
view the existing and re\-assign a new job\-billing tag to a job;
.IP "     \-"
pop up on screen a nicely formatted report of IPP attributes for any job and also print it;
.IP "     \-"
increase or decrease the number of required copies;
.IP "     \-"
cancel and delete a no-longer\-required job.
.PP
Note, that some of these manipulations require job ownership or root access.
.SH OPTIONS
.SS Options:
.TP
.B  \-d  
<printer\-name>         The printer for which jobs are requested
.TP
.B  \-\-noshow  
Show job viewer at startup
.TP
.B  \-\-all  
Show jobs for all printers
.SS Generic options:
.TP
.B  \-\-help  
Show help about options
.TP
.B  \-\-help\-qt  
Show Qt specific options
.TP
.B  \-\-help\-kde  
Show KDE specific options
.TP
.B  \-\-help\-all  
Show all options
.TP
.B  \-\-author  
Show author information
.TP
.B \-v,  \-\-version  
Show version information
.TP
.B  \-\-license  
Show license information
.TP
.B  \-\-  
End of options
.SS 
.SS Qt options:
.TP
.B  \-\-display  <displayname>
Use the X-server display 'displayname'
.TP
.B  \-\-session  <sessionId>
Restore the application for the given 'sessionId'
.TP
.B  \-\-cmap  
Causes the application to install a private color
map on an 8\-bit display
.TP
.B  \-\-ncols  <count>
Limits the number of colors allocated in the color
cube on an 8\-bit display, if the application is
using the QApplication::ManyColor color
specification
.TP
.B  \-\-nograb  
tells Qt to never grab the mouse or the keyboard
.TP
.B  \-\-dograb  
running under a debugger can cause an implicit
\-nograb, use \-dograb to override
.TP
.B  \-\-sync  
switches to synchronous mode for debugging
.TP
.B \-\-fn,  \-\-font  <fontname>
defines the application font
.TP
.B \-\-bg,  \-\-background  <color>
sets the default background color and an
application palette (light and dark shades are
calculated)
.TP
.B \-\-fg,  \-\-foreground  <color>
sets the default foreground color
.TP
.B \-\-btn,  \-\-button  <color>
sets the default button color
.TP
.B  \-\-name  <name>
sets the application name
.TP
.B  \-\-title  <title>
sets the application title (caption)
.TP
.B  \-\-visual  TrueColor
forces the application to use a TrueColor visual on
an 8\-bit display
.TP
.B  \-\-inputstyle  <inputstyle>
sets XIM (X Input Method) input style. Possible
values are onthespot, overthespot, offthespot and
root
.TP
.B  \-\-im  <XIM server>
set XIM server
.TP
.B  \-\-noxim  
disable XIM
.TP
.B  \-\-reverse  
mirrors the whole layout of widgets
.SS 
.SS KDE options:
.TP
.B  \-\-caption  <caption>
Use 'caption' as name in the titlebar
.TP
.B  \-\-icon  <icon>
Use 'icon' as the application icon
.TP
.B  \-\-miniicon  <icon>
Use 'icon' as the icon in the titlebar
.TP
.B  \-\-config  <filename>
Use alternative configuration file
.TP
.B  \-\-dcopserver  <server>
Use the DCOP Server specified by 'server'
.TP
.B  \-\-nocrashhandler  
Disable crash handler, to get core dumps
.TP
.B  \-\-waitforwm  
Waits for a WM_NET compatible windowmanager
.TP
.B  \-\-style  <style>
sets the application GUI style
.TP
.B  \-\-geometry  <geometry>
sets the client geometry of the main widget - see man X for the argument format
.TP
.B  \-\-nofork  
Don't run in the background.
.SS 

.SH SEE ALSO
Full user documentation is available through the KDE Help Center.  You can also enter the URL
.BR help:/kjobviewer/
directly into konqueror or you can run 
.BR "khelpcenter help:/kjobviewer/"
from the command\-line.
.br
.SH AUTHORS
.nf
Michael Goffioul <tdeprint@swing.be>
.br

.br
.fi
Please use http://bugs.kde.org to report bugs; do not mail the author directly.
.PP
This manual page was written by Holger Hartmann <Holger_Hartmann@gmx.de> for the Debian Project, but may be used by others. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL.