<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kdebugdialog "<application
>KDebugDialog</application
>">
  <!ENTITY kappname "&kdebugdialog;">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE" 
> <!-- change language only here -->
  
  
]>

<book lang="&language;">
<bookinfo>
<title
>O Manual do kdebugdialog;</title>

<authorgroup>
<author
> <firstname
>David</firstname
> <surname
>Faure</surname
> <affiliation
> <address
><email
>faure@kde.org</email
></address
> </affiliation
> </author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit>
</authorgroup>

<date
>2001-02-13</date>
<releaseinfo
>0.03.00</releaseinfo>

<abstract>
<para
>Este documento descreve o &kdebugdialog;.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KDebugdialog</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title
>O que é o KDebugDialog?</title>

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

<para
>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. </para>

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

<para
>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. </para>

<para
> No modo completo, as seguintes opções estão disponíveis: <itemizedlist
> <listitem
> <para
>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".</para
> </listitem
> <listitem
> <para
>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.</para
> </listitem
> <listitem
> <para
>Á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.</para
> </listitem
> </itemizedlist
> </para>

<para
>À 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. </para>

<para
>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. </para>

<para
>Créditos de Kalle Dalheimer pela versão original do kdebugdialog </para>

</chapter>

&documentation.index; 
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-general-insert-case: lower
sgml-shorttag: t
End:
-->


