<?xml version="1.0" encoding="UTF-8" ?>
<sect1 id="mainwindow-section">
<sect1info>
<authorgroup>
<author><firstname>Keith</firstname> <surname>Isdale</surname> <affiliation> <address><email>k_isdale@tpg.com.au</email></address>
</affiliation>
</author>
<othercredit role="translator"><firstname>Marcus</firstname><surname>Gama</surname><affiliation><address><email>marcus_gama@uol.com.br</email></address></affiliation><contrib>Tradução</contrib></othercredit> 
</authorgroup>
</sect1info>
<title>Usando a Janela Principal</title>

<screenshot>
<screeninfo>A Janela Principal</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="main_window.png" format="PNG"/>
</imageobject>
<textobject><phrase>Uma janela de texto com o arquivo atual sendo depurado</phrase></textobject>
<caption><para>Uma janela de texto com o arquivo atual sendo depurado.</para></caption>
</mediaobject>
</screenshot>

<sect2>
<title>Trabalhando na Janela Principal</title>

<para>O estado de um determinado ponto de parada é indicado através do texto relevante com uma cor de fundo diferente. Você poderá escolher a cor desejada: veja no diálogo em <menuchoice><guimenu>Configurações</guimenu><guimenuitem>Configurar o Editor</guimenuitem></menuchoice>, na página de <guilabel>Cores</guilabel>.</para>


<para>Você poderá definir, desativar ou remover um ponto de parada, usando as teclas, o menu <guimenu>Depurar</guimenu> ou os botões da barra de ferramentas.</para>

<para>Você poderá mover o cursor pelo texto, usando as seguintes teclas:</para>

<simplelist>
<member>Teclas de cursores: <keysym>Esquerda</keysym>, <keysym>Direita</keysym>, <keysym>Cima</keysym> ou <keysym>Baixo</keysym>.</member>
<member>Teclas de página: <keycap>Page Up</keycap> ou <keycap>Page Down</keycap></member>

</simplelist>

</sect2>

<sect2>
<title>Trabalhando com o Resultado do &kxsldbg;</title>

<para>Grande parte do resultado do &kxsldbg; é capturado e apresentado tanto na janela dos inspetores como no resultado do &kxsldbg;. As exceções a esta regra são:</para>
<itemizedlist>
<listitem>
<para>Uma mensagem de erro que vem do &kxsldbg; e que é mostrada dentro de uma janela de mensagens.</para>
</listitem>
<listitem>
<para>O resultado da avaliação de uma expressão que é também mostrado numa janela de mensagens.</para>
</listitem>
<listitem>
<para>O resultado da procura é enviado para o arquivo indicado na janela de resultado do &kxsldbg;.</para>
</listitem>
</itemizedlist>

</sect2>

<!-- FIXME: There's way too many things wrong with this, for people to
bother translating it just yet.  We can fix post 3.2

Specifically: Wrong icon images, all keybindings are incorrect, all
keybindings in the app are unmodified and therefore will probably be
changed, and this isn't the ideal place to put a toolbar ref anyway.

Plan: Add a menu ref chapter, include an updated toolbar ref in it

<sect2>
<title>&kxsldbg; Toolbar</title>

<variablelist>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="configure.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Configure</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Configuration for a session, <xref linkend="configure"/>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="configure.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Inspect</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
To be written.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="run.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Run</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Restart execution applying current configuration.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="1downarrow.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Continue</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Continue execution stoping at next breakpoint. This will cause the
debugger to stop at the start of the stylesheet if no further breakpoints
are found.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="step.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Step</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Step to the next XSLT instruction found.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="next.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Next</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Proceed to the next instruction at the same call stack depth. This is
useful for stepping over a <emphasis>xsl:apply-templates</emphasis> or
<emphasis>xsl:call-template</emphasis>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="stepup.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>StepUp</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Proceed to the next instruction in a cooler stack frame. This is best
used within a template at a greater depth than the root match template.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="stepdown.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>StepDown</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Proceed to the next instruction in a warmer stack frame.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="break.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Break</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Add a breakpoint at the current cursor location
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="delete.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Delete</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Delete a breakpoint at the current cursor location
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="enable.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Enable/Disable</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Enable or disable a breakpoint at the current cursor location
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="source.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Source</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Cause the current XSLT source file to be shown
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="data.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Data</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Cause the current &XML; data file to be shown
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="output.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Output</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Cause the current Output file to be shown
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
<guiicon>
<inlinemediaobject>
<imageobject>
<imagedata fileref="refresh.png"/>
</imageobject>
</inlinemediaobject>
</guiicon>
<guimenu>Debug</guimenu>
<guimenuitem>Reload</guimenuitem>
</menuchoice>
</term>
<listitem>
<para>
Cause the displayed file to be reloaded from disk
</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
-->

</sect1>