# O Manual do tdedebugdialog;

## O que é o TDEDebugDialog?

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

Se você escrever simplesmente `tdedebugdialog`, verá 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.

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

Á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). Você poderá indicar várias áreas separadas por vírgulas, e poderá também definir intervalos de áreas com a sintaxe início-fim. Por isso uma possibilidade seria: 117,214-289,356-359,221. Não utilize espaços.

Se você correr o `tdedebugdialog` `--fullmode`, poderá 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, deverá seleccionar em primeiro lugar a área de depuração na qual está interessado na lista que se encontra no topo.

O utilizador poderá alterar independentemente o resultado para os vários tipos de mensagens:

- Informações

- Aviso

- Erro

- Erro Fatal

Para cada um destes tipos, poderá definir o seguinte:

Resultado para:

- Nesta lista poderá 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 envie mensagens para o 'syslog', a não ser que seja o próprio administrador do sistema. O valor por omissão é Mensagem.

Nome do ficheiro:

- Isto só faz sentido quando você seleccionar um Ficheiro como destino; nele, deverá indicar o nome desse ficheiro (este é interpretado relativamente à pasta actual). Por omissão, é o `kdebug.dbg`.

À parte disto, poderá 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 fechar a janela com o OK, as suas opções são aplicadas e gravadas no `kdebugrc`. Quando o utilizador carregar em Cancelar, estas serão ignoradas e as antigas serão repostas.

Créditos de Kalle Dalheimer pela versão original do &tdedebugdialog;

&documentation.index;