.\" This file was generated by (a slightly modified) kdemangen.pl and edited by hand
.TH TDEDEBUGDIALOG 1 "June 2006" "Trinity Desktop Environment" "control debug output"
.SH NAME
tdedebugdialog
\- A dialog box for setting preferences for debug output
.SH SYNOPSIS
\fBtdedebugdialog\fP [Qt\-options] [TDE\-options] [options]
.SH DESCRIPTION
\fBTDEDebugDialog\fP shows a dialog box for managing diagnostic messages at runtime.
.sp 1
If you simply start \fBtdedebugdialog\fP, you will see a list of \fBareas\fP, that can be disabled or enabled.
.sp 1
If you start \fBtdedebugdialog \-\-fullmode\fP, then for every severity level you can define separately what should be done with the diagnostic messages of that level, and the same for each debug area.
.sp 1
In full mode, first you should select the debug area you are interested in from the drop down list at the top.
.sp 1
You may independently set the output for various types of messages:
.sp 1
.RS 3
\- Information
.br
\- Warning
.br
\- Error
.br
\- Fatal Error
.RE
.PP
For each of these types, you can set the following:
.sp 1
\fBOutput to\fP:
.br
In this Combobox, you can choose where the messages should be output. The choices are: \fBFile\fP?, \fBMessage Box\fP, \fBShell\fP (meaning stderr), \fBSyslog\fP an \fBNone\fP. Please do not direct fatal messages to syslog unless you are the system administrator yourself. The default is ?Message Box?.
.sp 1
\fBFilename:\fP
.br
This is only enabled when you have chosen \fBFile\fP as the output and provides the name of that file (which is interpreted as relative to the current folder). The default is \fIkdebug.dbg\fP.
Apart from this, you can also tick the checkbox Abort on fatal errors. In this case, if a diagnostic message with the severity level TDEBUG_FATAL is output, the application aborts with a SIGABRT after outputting the message.
.sp 1
When you close the dialog by pressing OK, your entries apply immediately and are saved in \fIkdebugrc\fP. When you press Cancel, your entries are discarded and the old ones are restored.
.SH OPTIONS
.SS Options:
.TP
.B \-\-fullmode
Show the fully\-fledged dialog instead of the default list dialog
.TP
.B \-\-on
Turn area on
.TP
.B \-\-off
Turn area off
.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
Use the X-server display 'displayname'
.TP
.B \-\-session
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
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
defines the application font
.TP
.B \-\-bg, \-\-background
sets the default background color and an
application palette (light and dark shades are
calculated)
.TP
.B \-\-fg, \-\-foreground
sets the default foreground color
.TP
.B \-\-btn, \-\-button
sets the default button color
.TP
.B \-\-name
sets the application name
.TP
.B \-\-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
sets XIM (X Input Method) input style. Possible
values are onthespot, overthespot, offthespot and
root
.TP
.B \-\-im
set XIM server
.TP
.B \-\-noxim
disable XIM
.TP
.B \-\-reverse
mirrors the whole layout of widgets
.SS
.SS TDE options:
.TP
.B \-\-caption
Use 'caption' as name in the titlebar
.TP
.B \-\-icon
Use 'icon' as the application icon
.TP
.B \-\-miniicon
Use 'icon' as the icon in the titlebar
.TP
.B \-\-config
Use alternative configuration file
.TP
.B \-\-dcopserver
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