<?xml version="1.0" ?>
<!DOCTYPE article 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 % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
  
  
]>

<article lang="&language;">
<title
>KDebugDialog</title>
<articleinfo>
<authorgroup>
<author
>&David.Faure; &David.Faure.mail;</author>
<othercredit role="translator"
><firstname
>Lisiane</firstname
><surname
>Sztoltz</surname
><affiliation
><address
><email
>lisiane@conectiva.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução atual</contrib
></othercredit
> 
</authorgroup>

<date
>2010-02-11</date>
<releaseinfo
>1.0 &kde; 4.4</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Diálogo de depuração do KDE</keyword>
<keyword
>Depurar</keyword>
</keywordset>
</articleinfo>


<para
>O &kdebugdialog; é uma caixa de diálogo para o gerenciamento de mensagens de diagnóstico na hora da execução. Ele fornece um modo simples e um completo.</para>
<para
>Para poder fazer as alterações, a opção <guilabel
>Desativar todo o resultado de depuração</guilabel
> terá que ser desmarcada.</para>

<variablelist>
<varlistentry>
<term
>Modo simples</term>
<listitem>
<para
>Se você simplesmente digitar <command
>kdebugdialog</command
>, você verá uma lista de <quote
>áreas</quote
> que podem estar ativas ou inativas. Uma chamada <function
>kDebug(área)</function
> no código irá mostrar algo na janela de depuração somente se a área estiver ativa.</para>

<note
><para
>Note que o kWarning, o kError e o kFatal aparecem sempre, uma vez que <emphasis
>NÃO</emphasis
> são controlados por esta configuração. </para
></note>

<para
>Insira um texto correspondente no campo <guilabel
>Procurar</guilabel
> do topo da lista, o que lhe permite filtrar as áreas que aparecem na área da lista. Use os botões abaixo da lista para selecionar ou desmarcar todos os itens na área (as outras áreas não são afetadas) ou mudar o resultado da depuração para um único item, usando a opção de marcação à frente do mesmo. </para>

</listitem>
</varlistentry>

<varlistentry>
<term
>Modo completo</term>
<listitem>
<para
>Se você iniciar com o comando <command
>kdebugdialog</command
> <option
>--fullmode</option
>, para cada nível de severidade você pode definir separadamente o que deve ser feito com as mensagens de diagnóstico daquele nível, e o mesmo acontece para cada área de depuração.</para>

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

<para
>Você pode ajustar independentemente a saída para vários tipos de mensagens:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Informação</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 configurar o seguinte:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Saída em:</guilabel
></term>
<listitem>
<para
>Neta caixa de verificação, você pode escolher para que saída as  mensagens devem ser enviadas. As opções são: <quote
>Arquivo </quote
>, <quote
>Caixa de Mensagem</quote
>, <quote
>Shell</quote
> (significa a saída padrão) e <quote
>Syslog</quote
> (log do sistema). Por  favor, não direcione mensagens fatais diretamente para o syslog, a não ser que você seja o administrador do sistema. O padrão é <quote
>Terminal</quote
></para
> 
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nome do arquivo:</guilabel
></term>
<listitem
><para
>Isto só estará habilitado quando você escolher o  <quote
>Arquivo</quote
> como a saída, e fornecer o nome daquele arquivo (que é interpretado como relativo para a pasta atual). O padrão é <filename
>kdebug.dbg</filename
>.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Além disto, você 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
>, o aplicativo termina com um SIGABRT depois de mostrar a mensagem.</para>

</listitem>
</varlistentry>
</variablelist>

<para
>Quando você fechar o diálogo, pressionando <guibutton
>OK</guibutton
>, suas entradas se aplicarão imediatamente, e serão salvas em <filename
>$<envar
>KDEHOME</envar
>/share/config/kdebugrc</filename
>. Quando você pressionar <guibutton
>Cancelar</guibutton
>, suas entradas serão descartadas e as antigas serão restauradas.</para>

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

<para
>Tradução de Lisiane Sztoltz <email
>lisiane@conectiva.com.br</email
></para
> <para
>Tradução atual de Marcus Gama <email
>marcus.gama@gmail.com</email
></para
> 

&underFDL;

</article>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-general-insert-case: lower
sgml-shorttag: t
End:
-->