summaryrefslogtreecommitdiffstats
path: root/doc/man/kjobviewer.1
blob: 6dae2692e8682c6c0f933e80191fbf174456426f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KJOBVIEWER 1 "June 2006" "Trinity Desktop Environment" "A print job viewer"
.SH NAME
kjobviewer
\- a print job viewer
.SH SYNOPSIS
\fBkjobviewer\fP [Qt\-options] [TDE\-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 \fBTDEPrint\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\-tde  
Show TDE 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 TDE 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 TDE 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.trinitydesktop.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.