diff options
Diffstat (limited to 'doc/man/tdedebugdialog.1')
| -rw-r--r-- | doc/man/tdedebugdialog.1 | 200 |
1 files changed, 200 insertions, 0 deletions
diff --git a/doc/man/tdedebugdialog.1 b/doc/man/tdedebugdialog.1 new file mode 100644 index 000000000..af48f59e6 --- /dev/null +++ b/doc/man/tdedebugdialog.1 @@ -0,0 +1,200 @@ +.\" 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 <area> +Turn area on +.TP +.B \-\-off <area> +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 <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 FILES +.I ~/.trinity/share/config/kdebugrc +\fBtdedebugdialog\fP configuration file + +.SH SEE ALSO +Full user documentation is available through the TDE Help Center. You can also enter the URL +.BR help:/tdedebugdialog/ +directly into konqueror or you can run +.BR "khelpcenter help:/tdedebugdialog/" +from the command\-line. +.br +.SH AUTHORS +.nf +David Faure <faure@kde.org> +.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. |