# Manuale di &kdebugdialog;

## Cos'è KDebugDialog?

È una finestra di dialogo per gestire i messaggi di diagnostica nel runtime.

Se lanci semplicemente `kdebugdialog`, vedrai una lista di aree, che possono essere abilitate o disabilitate. Una chiamata a `kdDebug(area)` nel codice visualizzerà qualcosa nell'output di debug solo se l'area indicata è abilitata.

Nota che kdWarning, kdError e kdFatal appaiono sempre, NON sono controllate da questa impostazione.

Area

- Queste sono le aree che devono produrre un output. Ogni messaggio che non è menzionato qui semplicemente non sarà prodotto (a meno che questo campo non rimanga vuoto, che è l'impostazione predefinita, e ciò significa che tutti i messaggi dovrebbero essere prodotti in output). Puoi inserire qui diverse aree separate da virgola e puoi usare anche intervalli di area con la sintassi inizio-fine. Perciò un valido inserimento potrebbe essere: 117,214-289,356-359,221. Non usare spazi bianchi.

Se lanci `kdebugdialog` `--fulmode`, per ogni livello di severità puoi definire separatamente che cosa debba essere fatto con i messaggi di diagnostica di quel livello, questo per ogni area di debug.

In modalità completa, puoi per prima cosa selezionare le aree di debug che ti interessano dal menu a discesa in alto.

Puoi impostare indipendentemente l'output per i diversi tipi di messaggi:

- Informazioni

- Avvertimento

- Errore

- Errore fatale

Per ognuno di questi tipi, puoi impostare le seguenti opzioni:

Output su:

- In questa casella combinata puoi scegliere dove devono essere prodotti i messaggi. Le scelte sono :File, Riquadro Informativo, Shell (intendendo stderr) e Syslog. Per favore, non dirigere i messaggi fatali al syslog a meno che tu non sia l'amministratore di sistema stesso. L'impostazione predefinita è Riquadro Informativo.

Nome file:

- Questa è abilitata solamente quando scegli File come output e fornisce il nome di quel file (che viene interpretato relativamente alla cartella corrente). L'impostazione predefinita è kdebug.dbg.

Inoltre, puoi spuntare la casella Termina in caso di errori fatali. In questo caso, se viene prodotto un messaggio di diagnostica con livello di severità impostato a `KDEBUG_FATAL`, l'applicazione viene abortita con un segnale SIGABRT dopo l'output del messaggio.

Quando chiudi la finestra di dialogo premendo OK, le tue scelte verranno applicate immediatamente e salvate nel file `kdebugrc`. Quando premi Annulla, le tue scelte vengono scartate e vengono ripristinate quelle vecchie.

Riconoscimenti a Kalle Dalheimer per la versione originale di &kdebugdialog;

&documentation.index;