]>

# The &kdebugdialog; Handbook

David
Faure

    faure@kde.org

21/12/1999
0.02.00

This document describes &kdebugdialog;.

## What is KDebugDialog

It is a dialog box for managing diagnostic messages at runtime

Here you can define separately for every severity level what should be done with the diagnostic messages of that level, and this for each debug area.

The following settings are available:

- Output: In this Combobox, you can choose where the messages should be output. The choices are: "File", "Message Box", "Shell" (meaning stderr) and "syslog". Please do not direct fatal messages to syslog unless you are the system administrator yourself. The default is "Message Box".

- File: This is only meaningful when you have chosen "File" as the output and provides the name of that file (which is interpreted relatively to the current directory). The default is kdebug.dbg.

- Area: The areas which should only be output. Every message that is not mentioned here will simply not be output (unless this field remains empty which is the default and means that all messages should be output). Your can enter several areas separated by commas here, and you can also use area ranges with the syntax start-end. Thus a valid entry could be: 117,214-289,356-359,221. Please do not use whitespace.

Apart from this, you can also tick the checkbox "Abort on fatal errors". In this case, if a diagnostic message with the severity level "KDEBUG_FATAL" is output, the application aborts with a SIGABRT after outputting the message.

When you close the dialog with OK, your entries apply immediately and saved in kdebugrc. When you press cancel, your entries are discarded and the old ones are restored.

Credits to Kalle Dalheimer for the original version of kdebugdialog