# O Manual do kdebugdialog;

## O que é o KDebugDialog?

É uma janela para gerir as mensagens de diagnóstico em pleno funcionamento.

Se escreveres simplesmente "kdebugdialog", verás uma lista de "áreas" que podem estar activas ou inactivas. Uma chamada kdDebug(área) no código irá mostrar algo na janela de depuração só se a área estiver activa.

Repara que o kdWarning, o kdError e o kdFatal aparecem sempre, dado que NÃO são controlados por esta configuração.

Se correres o "kdebugdialog --fullmode", podes definir separadamente em cada nível de segurança o que deve ser feito com as mensagens de diagnóstico desse nível, e isto para cada área de depuração.

No modo completo, as seguintes opções estão disponíveis:

- Informação: nesta lista podes escolher onde as mensagens devem ser mostradas. As opções são: "Ficheiro", "Mensagem", "Terminal" (neste caso o stderr) e "Syslog". Se possível não envies mensagens para o syslog a não ser que sejas o próprio administrador do sistema. O valor por omissão é "Mensagem".

- Ficheiro: só faz sentido quando seleccionares "Ficheiro" como o destino e nele deves indicar o nome desse ficheiro (este é interpretado relativamente à directoria actual). Por omissão é kdebug.dbg.

- Área: As áreas que podem ser mostradas. Cada mensagem que não é mencionada aqui não será apresentada (a menos que este campo se mantenha em branco, o que é o valor por omissão e que significa que tudo deve ser mostrado). Podes indicar várias áreas separadas por vírgulas, e podes definir intervalos de áreas com a sintaxe início-fim. Por isso uma possibilidade seria: 117,214-289,356-359,221. NOTA: Não utilizes espaços.

À parte disto, podes também assinalar a opção "Abortar nos erros fatais". Neste caso, se for mostrada uma mensagem com o nível de severidade "KDEBUG_FATAL", a aplicação termina com um SIGABRT depois de mostrar a mensagem.

Quando fechares a janela com o OK, as tuas opções são aplicadas e gravadas no kdebugrc. Quando carregares em Cancelar, estas serão ignoradas e as antigas serão repostas.

Créditos de Kalle Dalheimer pela versão original do kdebugdialog

&documentation.index;