.TH KDIALOG "1" "December 2002" "TDE" "KDE Application"
.SH NAME
kdialog \- Show KDE dialog boxes from shell scripts
.SH SYNOPSIS
.B kdialog
[\fIQt-options\fR] [\fIKDE-options\fR] [\fIoptions\fR] [\fIarg\fR]
.SH DESCRIPTION
This manual page documents briefly the
.B kdialog
KDE Application.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.
.PP
.B kdialog
allows to display dialog boxes from shell scripts.
The syntax is very much inspired from the 
.B dialog
command
(which shows text mode dialogs).
.SH OPTIONS
.TP
.BI \-\-yesno " text"
Question message box with yes/no buttons
.TP
.BI \-\-yesnocancel " text"
Question message box with yes/no/cancel buttons
.TP
.BI \-\-warningyesno " text"
Warning message box with yes/no buttons
.TP
.BI \-\-warningcontinuecancel " text"
Warning message box with continue/cancel buttons
.TP
.BI \-\-warningyesnocancel " text"
Warning message box with yes/no/cancel buttons
.TP
.BI \-\-sorry " text"
\&'Sorry' message box
.TP
.BI \-\-error " text"
\&'Error' message box
.TP
.BI \-\-msgbox " text"
Message Box dialog
.TP
.BI \-\-inputbox " text init"
Input Box dialog
.TP
.BI \-\-password " text"
Password dialog
.TP
.RI \fB\-\-textbox\fP \ file " [" width "] [" height ]
Text Box dialog
.TP
.RI \fB\-\-menu\fP \ text " [" "tag item" "] [" "tag item" "] ..."
Menu dialog
.TP
.RI \fB\-\-checklist\fP \ text " [" "tag item status" "] ..."
Check List dialog
.TP
.RI \fB\-\-radiolist\fP " text" " [" "tag item status" "] ..."
Radio List dialog
.TP
.BI \-\-title " text"
Dialog title
.TP
.B \-\-separate\-output
Return list items on separate lines (for checklist option)
.SS "Arguments:"
.TP
arg
Arguments - depending on main option
.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
\fB\-v\fR, \fB\-\-version\fR
Show version information
.TP
.B \-\-license
Show license information
.TP
.B \-\-
End of options
.SS "Qt options:"
.TP
.BI \-\-display \ displayname
Use the X-server display \fIdisplayname\fP.
.TP
.BI \-\-session \ sessionId
Restore the application for the given \fIsessionId\fP.
.TP
.B \-\-cmap
Causes the application to install a private color
map on an 8-bit display.
.TP
.BI \-\-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
.B \-nograb, use \fB\-dograb\fR to override.
.TP
.B \-\-sync
switches to synchronous mode for debugging.
.TP
.BI "\-\-fn\fR, \fP\-\-font" \ fontname
defines the application font.
.TP
.BI "-\-bg\fR, \fB\-\-background"  \ color
sets the default background color and an
application palette (light and dark shades are
calculated).
.TP
.BI "\-\-fg\fR, \fB\-\-foreground"  \ color
sets the default foreground color.
.TP
.BI \-\-btn\fR, \fB\-\-button \ color
sets the default button color.
.TP
.BI \-\-name \ name
sets the application name.
.TP
.BI \-\-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
.BI \-\-inputstyle \ inputstyle
sets XIM (X Input Method) input style. Possible
values are 
.BR onthespot ", " overthespot ", " offthespot and root .
.TP
.BI \-\-im " XIM-server"
set XIM server.
.TP
.B \-\-noxim
disable XIM.
.TP
.B \-\-reverse
mirrors the whole layout of widgets.
.SS "KDE options:"
.TP
.BI \-\-caption \ caption
Use \fIcaption\fP as name in the titlebar.
.TP
.BI \-\-icon \ icon
Use \fIicon\fP as the application icon.
.TP
.BI \-\-miniicon \ icon
Use \fIicon\fP as the icon in the titlebar.
.TP
.BI \-\-config \ filename
Use alternative configuration file.
.TP
.BI \-\-dcopserver \ server
Use the DCOP Server specified by \fIserver\fP.
.TP
.B \-\-nocrashhandler
Disable crash handler, to get core dumps.
.TP
.B \-\-waitforwm
Waits for a WM_NET compatible windowmanager.
.TP
.BI \-\-style \ style
sets the application GUI style.
.TP
.BI \-\-geometry \ geometry
sets the client geometry of the main widget.
.SH AUTHOR
KDialog was written by
.nh
.ad l
David Faure <faure@kde.org>,
Nick Thompson,
Nick Thompson,
Matthias Hoelzer <hoelzer@kde.org> and
David Gumbel <david.guembel@gmx.net>.
.br
.hy
Please use http://bugs.kde.org to report bugs, do not mail the authors directly.
.br
This manual page was prepared by
.nh
.ad l
Karolina Lindqvist <pgd\-karolinali@algonet.se>
.hy
for the Debian GNU/Linux system (but may be used by others).