# Das Handbuch zu &kdebugdialog;

## Was ist KDebugDialog?

Es ist ein Dialog, um Diagnosenachrichten zur Laufzeit einzustellen.

Wenn Sie einfach kdebugdialog starten, erscheint eine Liste von Bereichen, die entweder ein- oder ausgeschaltet werden können. Ein kdDebug(Bereich)-Aufruf in den Quellen zeigt etwas in der Debugausgabe des Programms an, wenn dieser Bereich eingeschaltet wurde.

Beachten Sie, dass kdWarning, kdError und kdFatal immer erscheinen, sie können NICHT von diesen Einstellungen kontrolliert werden.

Wenn Sie "kdebugdialog --fullmode" starten, können Sie für jede Wichtigkeitsstufe getrennt einstellen, was mit der Debugausgabe für diese Stufe passieren soll. Dies können Sie natürlich für jeden Bereich einstellen.

Im full-Modus gibt es folgende Einstellungsmöglichkeiten:

- Ausgabe nach: In diesem Kombinationsfeld können Sie auswählen, wohin die Meldungen geschrieben werden sollen. Die Möglichkeiten sind: "Datei", "Mitteilungsfenster", "Shell" (bedeutet hier StdErr) und "Systemlog". Bitte schreiben Sie keine Meldungen über fatale Fehler in ein Systemlog, solange Sie nicht der Systemadministrator sind. Die Voreinstellung ist "Mitteilungsfenster".

- Dateiname: Dieser ist nur von Bedeutung, wenn "Datei" als Ausgabe gewählt wurde und kann hier angegeben werden (er wird dabei relativ zum aktuellen Verzeichnis interpretiert). Die Vorgabe ist kdebug.dbg.

- Bereich für Fehlersuche: Die Bereiche, zu denen eine Ausgabe erfolgen soll. Jede Meldung, die nicht hier angegeben wurde, wird einfach nicht ausgegeben (es sei denn, dieses Feld bleibt leer, was bedeutet, dass alle Meldungen ausgegeben werden sollen - dies ist die Voreinstellung). Hier können verschiedene Bereiche durch Komma getrennt angegeben werde, ebenfalls möglich ist die auch die Angabe von zusammenhängenden Bereichen im Format Start-Ende. Somit sind gültige Angaben: 117,214-289,356-359,221. ANMERKUNG: Bitte verwenden Sie keine Trennzeichen wie Leerzeichen, Tabulatoren oder Zeilenumbruch.

Abgesehen davon können Sie auch das Feld "Bei fatalen Fehlern abbrechen" ankreuzen. In diesem Fall bricht die Anwendung mit dem Signal SIGABRT ab, nachdem eine Meldung mit Schweregrad "KDEBUG_FATAL" ausgegeben wurde.

Wenn Sie das Dialogfenster durch Anklicken von OK beenden, werden Ihre Änderungen sofort angewendet und in der Datei kdebugrc gespeichert. Falls Sie Abbrechen klicken, werden Ihre Änderungen vollständig verworfen und die ursprünglichen wiederhergestellt.

Dank geht an Kalle Dalheimer für die Orginalversion von kdebugdialog.

&documentation.index;