<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//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
>&David.Faure; &David.Faure.mail;</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 você escrever simplesmente <command
>kdebugdialog</command
>, verá uma lista de <quote
>áreas</quote
> que podem estar activas ou inactivas. Uma chamada <function
>kdDebug(área)</function
> 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>

<variablelist>
<varlistentry>
<term
><guilabel
>Área</guilabel
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Se você correr o <command
>kdebugdialog</command
> <option
>--fullmode</option
>, 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.</para>

<para
>No modo completo, você deverá seleccionar em primeiro lugar a área de depuração na qual está interessado na lista que se encontra no topo.</para>

<para
>Você poderá alterar independentemente o resultado para os vários tipos de mensagens:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Informações</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Aviso</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Erro</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Erro Fatal</guilabel
></para
></listitem>
</itemizedlist>

<para
>Para cada um destes tipos, você pode definir o seguinte:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Resultado para:</guilabel
></term>
<listitem>
<para
>Nesta lista poderá escolher onde as mensagens devem ser mostradas. As opções são: <quote
>Ficheiro</quote
>, <quote
>Mensagem</quote
>, <quote
>Terminal</quote
> (neste caso o stderr) e <quote
>Syslog</quote
>. 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 é <quote
>Mensagem</quote
>.</para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nome do ficheiro:</guilabel
></term>
<listitem
><para
>Isto só faz sentido quando seleccionares <quote
>Ficheiro</quote
> como o destino e nele deves indicar o nome desse ficheiro (este é interpretado relativamente à directoria actual). Por omissão é <filename
>kdebug.dbg</filename
>.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>À parte disto, poderá também assinalar a opção <guilabel
>Abortar nos erros fatais</guilabel
>. Neste caso, se for mostrada uma mensagem com o nível de severidade <computeroutput
>KDEBUG_FATAL</computeroutput
>, a aplicação termina com um SIGABRT depois de mostrar a mensagem.</para>

<para
>Quando fechar a janela com o <guibutton
>OK</guibutton
>, as tuas opções são aplicadas e gravadas no <filename
>kdebugrc</filename
>. Quando carregares em <guibutton
>Cancelar</guibutton
>, 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:
-->


