<?xml version="1.0" encoding="UTF-8" ?>
<sect1 id="breakpoint-section-3-2">
<title
>Установка и изменение точек останова</title>

<para
>С точками останова можно работать через главное окно. <xref linkend="mainwindow-section"/> </para>

<para
>После создания таблицы стилей выберите <menuchoice
> <guimenu
>Сервис</guimenu
> <guimenuitem
>Отобразить мониторы</guimenuitem
> </menuchoice
> и перейдите на вкладку точек останова. </para>

<mediaobject>
<imageobject>
<imagedata fileref="breakpoints_window.png"/>
</imageobject>
</mediaobject>

<sect2>
<title
>Добавление точки останова</title>

<para
>Вы можете установить точку останова указанием одного из следующих: <orderedlist>
<listitem
><para
>имени файла и номера строки</para>
</listitem>
<listitem
><para
>имени шаблона</para>
</listitem>
<listitem
><para
>имени шаблона и режима</para>
</listitem>
<listitem
><para
>имени режима</para>
</listitem>
</orderedlist>
</para>

<para
>Затем нажмите кнопку &quot;Добавить&quot;. </para>

<para
>Аргументы</para>

<para
>Именем файла может быть абсолютный путь к нему или просто его краткое имя (например xsldoc.xsl). </para>

<para
>В имени шаблона или режима может быть нелокальная часть. Например <emphasis
>xsl:mytemplate</emphasis
> соответствует <emphasis
>mytemplate</emphasis
> </para>
</sect2>

<sect2>
<title
>Удаление точки останова</title>

<para
>Щёлкните левой кнопкой мыши на точке останова, затем нажмите кнопку &quot;Удалить&quot;. </para>
</sect2>

<sect2>
<title
>Удаление всех точек останова</title>

<para
>Нажмите кнопку &quot;Удалить всё&quot;. </para>
</sect2>

<sect2>
<title
>Включение/выключение точки останова</title>

<para
>Щёлкните левой кнопкой мыши на точке останова, затем нажмите кнопку &quot;Включить&quot;. </para>
</sect2>
</sect1>

<sect1 id="variables-section">
<title
>Working With Variables</title>

<para>
If the inspector dialog is not showing use the
<menuchoice>
<guimenu
>Tools</guimenu>
<guimenuitem
>Show inspectors</guimenuitem>
</menuchoice>
menu item.
</para>

<para>
Local and global variables are show in separate tabs on the inspector
dialog. A local variable is variable declared within a template using
<emphasis
>xsl:param</emphasis
>.
<mediaobject>
<imageobject>
<imagedata fileref="globals_window.png"/>
</imageobject>
<caption
><para
>Global variable tab.</para
></caption>
</mediaobject>
</para>

<para>
Clicking on a variable entry in the list shown will cause the cursor in
the main window to move to the file and line number indicated.
</para>
</sect1>

<sect1 id="callstack-chapter">
<title
>Working With the Callstack</title>

<para>
All call stack items found are listed here. The older the callstack entry
the lower the frame number it will have <emphasis
>xsl:param</emphasis
>.
See below for an example.
<mediaobject>
<imageobject>
<imagedata fileref="callstack_window.png"/>
</imageobject>
</mediaobject>
</para>

<para>
Clicking on a callstack entry in the list shown will cause the cursor in
the main window to move to the file and line number indicated.
</para>
</sect1>

<sect1 id="templates-section">
<title
>Working With Templates</title>

<para>
If the inspector dialog is not showing use the
<menuchoice>
<guimenu
>Tools</guimenu>
<guimenuitem
>Show inspectors</guimenuitem>
</menuchoice>
menu item. To work with templates click on the templates tab of dialog
shown.
</para>

<para>
All templates found are listed here. Please note that the export rules of
XSLT apply. So only there may be more than one template with the same
match and mode details. <emphasis
>xsl:param</emphasis
>.
<mediaobject>
<imageobject>
<imagedata fileref="templates_window.png"/>
</imageobject>
</mediaobject>
</para>

<para>
Clicking on a template entry in the list shown will cause the cursor in
the main window to move to the file and line number indicated.
</para>
</sect1>

<sect1 id="sources-section">
<title
>Working With XSLT Source Files (Sources)</title>

<para>
If the inspector dialog is not showing use the
<menuchoice>
<guimenu
>Tools</guimenu>
<guimenuitem
>Show inspectors</guimenuitem>
</menuchoice>
menu item. To work with sources click on the sources tab of dialog shown.
</para>

<para>
All XSLT source files that are included by the XSLT file or one of its
simblings are listed here.
<mediaobject>
<imageobject>
<imagedata fileref="sources_window.png"/>
</imageobject>
</mediaobject>
</para>

<para>
Clicking on a source entry in the list shown will cause the cursor in the
main window  to move to the start of file indicated.
</para>
</sect1>

<sect1 id="entities-section">
<title
>Working With XML Data Files (Entities)</title>

<para>
If the inspector dialog is not showing use the
<menuchoice>
<guimenu
>Tools</guimenu>
<guimenuitem
>Show inspectors</guimenuitem>
</menuchoice>
menu item. To work with entities click on the Entities tab of dialog
shown.
</para>

<para>
All external &XML; entities included via the DATA file or one of its siblings
are listed here. For this example I have run &kxsl; on test13.xsl with
test13.xml (found in the tests directory of xsldbg source distribution) so
that you can see some entities.
<mediaobject>
<imageobject>
<imagedata fileref="entities_window.png"/>
</imageobject>
</mediaobject>
</para>

<para>
Clicking on a entity entry in the list shown will cause the cursor in the
main window to move to the start of the file indicated.
</para>
</sect1>
