.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH KPRINTER 1 "June 2006" "K Desktop Environment" "A printer tool for KDE"
.SH NAME
kprinter
\- a printer tool for KDE
.SH SYNOPSIS
\fBkprinter\fP [Qt\-options] [KDE\-options] [options] file(s) 
.SH DESCRIPTION
\fBKPrinter\fP opens automatically when you click on the "Print" icon of any KDE application. Choose your print job settings by going through the dialog and then click on the "Print" button.
.sp 1
\fBkprinter\fP is a very versatile tool. Depending on the actual features and power of the print subsystem of your computer, \fBkprinter\fP translates the former's abilities into a nice and easy\-to\-understand GUI. If your print subsystem does not support duplexing, \fBkprinter\fP will not show the option. If your print subsystem is CUPS, kprinter is at its peak shape.
.sp 1
With \fBKPrinter\fP you can...
.IP "     \-"
switch "on the fly" the print subsystem\-to\-use,
.IP "     \-"
start the Add Printer Wizard,
.IP "     \-"
choose the target printer,
.IP "     \-"
possibly select one or more files to print,
.IP "     \-"
drag'n'drop files for print,
.IP "     \-"
check for or set the print options,
.IP "     \-"
schedule the job for later printing,
.IP "     \-"
tag the print job with accounting information for billing purposes,
.IP "     \-"
set the job priority for a higher or lower level to influence the order of the job queue,
.IP "     \-"
access the KDEPrint configurator,
.IP "     \-"
and activate (or disable) a viewing filter that shows all or just the selected few printers relevant to the user.
.SP
.SH OPTIONS
.SS
.SS Arguments:
file(s)                   Files to load
.SS Options:
.TP
.B  \-c  
Make an internal copy of the files to print
.TP
.B \-P,  \-d  <printer>
Printer/destination to print on
.TP
.B \-J,  \-t  <title>
Title/Name for the print job
.TP
.B \-#, \-n <number>
Number of copies
.TP
.B  \-o  
<option=value>         Printer option
.TP
.B  \-j  <mode>
Job output mode (gui, console, none) [gui]
.TP
.B  \-\-system  <printsys>
Print system to use (lpd, cups)
.TP
.B  \-\-stdin  
Allow printing from STDIN
.TP
.B  \-\-nodialog  
Do not show the print dialog (print directly)
.SS 
.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
\fB\-\-nograb\fP, use \fB\-\-dograb\fP 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
.SS 

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

.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.