<?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
>Juan Manuel</firstname
><surname
>García Molina</surname
><affiliation
><address
><email
>juanma@superiodico.net</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 
</authorgroup>
</sect1info>
<title
>Usar la ventana principal</title>

<screenshot>
<screeninfo
>La ventana principal</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="main_window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Una vista de texto del archivo que se está depurando actualmente</phrase
></textobject>
<caption
><para
>Una vista de texto del archivo que se está depurando actualmente.</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Trabajar con la ventana principal</title>

<para
>El estado de un punto de interrupción dado se indica por medio del texto relevante con un color de fondo diferente. Puede elegir el color que desee: puede ver el cuadro de diálogo <menuchoice
><guimenu
>Preferencias</guimenu
><guimenuitem
>Configurar editor</guimenuitem
></menuchoice
> <guilabel
>Colores</guilabel
>, en la página <guilabel
>Colores</guilabel
>.</para>


<para
>Puede definir, desactivar o eliminar un punto de interrupción usando las teclas, el menú <guimenu
>Depurar</guimenu
> o los botones de la barra de herramientas.</para>

<para
>Puede mover el cursor a través del texto usando las siguientes teclas:</para>

<simplelist>
<member
>Flechas de dirección: <keysym
>flecha arriba</keysym
>, <keysym
>flecha derecha</keysym
>, <keysym
>flecha arriba</keysym
> or <keysym
>flecha abajo</keysym
>.</member>
<member
>Teclas de página: <keycap
>Av Pág</keycap
> or <keycap
>Re Pág</keycap
></member>

</simplelist>

</sect2>

<sect2>
<title
>Trabajar con la salida de &kxsldbg;</title>

<para
>La mayoría de la salida de &kxsldbg; se captura y se presenta o bien en los cuadros de diálogo de los inspectores o bien en la ventana de salida de &kxsldbg;. Las excepciones a esta regla son:</para>
<itemizedlist>
<listitem>
<para
>Se muestra un mensaje que viene de &kxsldbg; dentro de un cuadro de diálogo de mensaje.</para>
</listitem>
<listitem>
<para
>El resultado de evaluar una expresión se muestra en un cuadro de diálogo de mensaje.</para>
</listitem>
<listitem>
<para
>La salida de la búsqueda se envía al campo que se indica en la ventana de salida de &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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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="xsldbg_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>