<?xml version="1.0" encoding="UTF-8" ?>
<chapter id="using-xsldbg">
<title
>Использование &xsldbg;</title>
<para
></para>
<sect1
><title
>аргументы команды xsldbg</title>
<para
>Системы, в которых установлена библиотека readline, позволяют пользователю передвигаться по списку ранее введённых команд с помощью клавиш "вправо"/"влево". В любых системах последняя введённая команда может быть повторена простым нажатием клавиши <ENTER>. </para>
<para
>Частичные имена файлов будут автоматически заменены на полные, если операционная система это поддерживает.</para>
<para
>Некоторым командам можно передать несколько аргументов. Чтобы сложные выражения воспринимались как один аргумент, их заключают в кавычки, например: break "* | @" позволит пользователю увидеть точку останова в шаблоне с именем "* | @" </para>
</sect1>
<sect1 id="legend"
><title
>Используемые обозначения</title>
<para
>В данной таблице приводится описание условных обозначений, используемых в настоящем справочном руководстве</para>
<informaltable>
<tgroup cols="1"
><tbody>
<row
><entry
>TEMPLATE_NAME: Допустимое имя шаблона, может содержать только ASCI-символы с кодами от 0x00 до to 0x7F. Может быть полностью определённым именем, например "xsl:templateName". </entry
></row>
<row
><entry
>FILENAME: Допустимое имя файла из локальной файловой системы пользователя. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения. </entry
></row>
<row
><entry
>URI: Универсальный Идентификатор Ресурса (Uniform Resource Identifiers) в соответствии с определением в RFC 2396</entry
></row>
<row
><entry
>MODE_NAME: Режим шаблона, может быть полностью определённым именем, например "xsl:modeName".</entry
></row>
<row
><entry
>QNAME : Полностью определённое имя, например "xsl:localPart"</entry
></row>
<row
><entry
>LINENO : Допустимый номер строки в заданном <FILENAME></entry
></row>
<row
><entry
>NUMBER_OF_FRAMES : допустимое число кадров для перехода</entry
></row>
<row
><entry
>BREAKPOINT_ID : Допустимый номер точки останова</entry
></row>
<row
><entry
>WATCH_ID: Допустимый номер наблюдаемого выражения (watch expression), берётся из вывода команды showwatch</entry
></row>
<row
><entry
>SPEED: скорость исполнения кода, принимает значения от 0 до 9</entry
></row>
<row
><entry
> <emphasis
>(Комментарий)</emphasis
>: комментарий, поясняющий значение команды или определяющий её использование </entry
></row>
<row
><entry
>{ opt1 | opt2 | opt2 .. etc} : Выбор одного из opt-ов</entry
></row>
<row
><entry
>XPATH: xpath-выборка узлов</entry
></row>
<row
><entry
>PARAM_ID: допустимый номер параметра, берётся из вывода команды showparam</entry
></row>
<row
><entry
>PATH: путь к новому рабочему каталогу. В некоторых системах префикс "~" будет заменён путём к вашему домашнему каталогу </entry
></row>
<row
><entry
>TEXT: Текст в свободной форме <emphasis
>(без ограничений)</emphasis
> </entry
></row>
<row
><entry
>COMMAND: Допустимая команда для xsdbg</entry
></row>
<row
><entry
>QNAME: Допустимое имя переменной/параметра</entry
></row>
<row
><entry
>SOURCE: Исполняемая/подлежащая исполнению таблица стилей. Также см. <FILENAME> и <URI></entry
></row>
<row
><entry
>DATA: Xml-данные (документ), которые будут обрабатываться таблицей стилей. Также см. <FILENAME> и <URI> </entry
></row>
<row
><entry
>DEVICE_PATH: Допустимый терминал в операционной системе</entry
></row>
<row
><entry
>TTY_LEVEL: допустимый уровень ввода/вывода</entry
></row>
</tbody
></tgroup
></informaltable>
<para
></para>
</sect1>
<sect1 id="command_summary"
><title
>Обзор доступных команд</title>
<informaltable>
<tgroup cols="1"
><tbody>
<row
><entry
>Получение справки :<link linkend="help_cmd" endterm="help_cmd.title"
>help</link
></entry
></row>
<row
><entry
>Управление исполнением: {<link linkend="bye_cmd" endterm="bye_cmd.title"
>bye</link
>|<link linkend="exit_cmd" endterm="exit_cmd.title"
>exit</link
>| <link linkend="quit_cmd" endterm="quit_cmd.title"
>quit</link
>}, <link linkend="step_cmd" endterm="step_cmd.title"
>step</link
>, <link linkend="stepup_cmd" endterm="stepup_cmd.title"
>stepup</link
>, <link linkend="stepdown_cmd" endterm="stepdown_cmd.title"
>stepdown</link
>, <link linkend="next_cmd" endterm="next_cmd.title"
>next</link
>, <link linkend="continue_cmd" endterm="continue_cmd.title"
>continue</link
>, <link linkend="run_cmd" endterm="run_cmd.title"
>run</link
>, <link linkend="trace_cmd" endterm="trace_cmd.title"
>trace</link
>, <link linkend="setoption_cmd" endterm="setoption_cmd.title"
>setoption</link
>, <link linkend="options_cmd" endterm="options_cmd.title"
>options</link
> </entry
></row>
<row
><entry
>Управление параметрами libxslt : <link linkend="addparam_cmd" endterm="addparam_cmd.title"
>addparam</link
>, <link linkend="delparam_cmd" endterm="delparam_cmd.title"
>delparam</link
>, <link linkend="showparam_cmd" endterm="showparam_cmd.title"
>showparam</link
>, <link linkend="output_cmd" endterm="output_cmd.title"
>output</link
>, <link linkend="setoption_cmd" endterm="setoption_cmd.title"
>setoption</link
>, <link linkend="options_cmd" endterm="options_cmd.title"
>options</link
> </entry
></row>
<row
><entry
>Управление шаблонами: <link linkend="templates_cmd" endterm="templates_cmd.title"
>templates</link
>, <link linkend="where_cmd" endterm="where_cmd.title"
>where</link
>, <link linkend="frame_cmd" endterm="frame_cmd.title"
>frame</link
> </entry
></row>
<row
><entry
>Управление точками останова : <link linkend="break_cmd" endterm="break_cmd.title"
>break</link
>, <link linkend="showbreak_cmd" endterm="showbreak_cmd.title"
>showbreak</link
>, <link linkend="delete_cmd" endterm="delete_cmd.title"
>delete</link
>, <link linkend="enable_cmd" endterm="enable_cmd.title"
>enable</link
> </entry
></row>
<row
><entry
>Отображение выражений(xpath): <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
> </entry
></row>
<row
><entry
>Отображение узлов: <link linkend="ls_cmd" endterm="ls_cmd.title"
>ls</link
>, <link linkend="dir_cmd" endterm="dir_cmd.title"
>dir</link
>, <link linkend="du_cmd" endterm="du_cmd.title"
>du</link
>, <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
>, <link linkend="pwd_cmd" endterm="pwd_cmd.title"
>pwd</link
> </entry
></row>
<row
><entry
>Отображение переменных: <link linkend="globals_cmd" endterm="globals_cmd.title"
>globals</link
>, <link linkend="locals_cmd" endterm="locals_cmd.title"
>locals</link
>, <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
>, <link linkend="addwatch_cmd" endterm="addwatch_cmd.title"
>addwatch</link
> </entry
></row>
<row
><entry
>Задание переменных: <link linkend="set_cmd" endterm="set_cmd.title"
>set</link
> </entry
></row>
<row
><entry
>Выбор узла: <link linkend="source_cmd" endterm="source_cmd.title"
>source</link
>, <link linkend="data_cmd" endterm="data_cmd.title"
>data</link
>, <link linkend="cd_cmd" endterm="cd_cmd.title"
>cd</link
> </entry
></row>
<row
><entry
>Поиск: <link linkend="search_cmd" endterm="search_cmd.title"
>search</link
> </entry
></row>
<row
><entry
>Команды операционной системе: <link linkend="chdir_cmd" endterm="chdir_cmd.title"
>chdir</link
>, <link linkend="shell_cmd" endterm="shell_cmd.title"
>shell</link
>, <link linkend="tty_cmd" endterm="tty_cmd.title"
>tty</link
></entry
></row>
<row
><entry
>Управление файлами: <link linkend="output_cmd" endterm="output_cmd.title"
>output</link
>, <link linkend="entities_cmd" endterm="entities_cmd.title"
>entities</link
>, <link linkend="system_cmd" endterm="system_cmd.title"
>system</link
>, <link linkend="public_cmd" endterm="public_cmd.title"
>public</link
> </entry
></row>
<row
><entry
>Отключённые команды управления файлами: <link linkend="validate_cmd" endterm="validate_cmd.title"
>validate</link
>, <link linkend="load_cmd" endterm="load_cmd.title"
>load</link
>, <link linkend="save_cmd" endterm="save_cmd.title"
>save</link
>, <link linkend="write_cmd" endterm="write_cmd.title"
>write</link
>, <link linkend="free_cmd" endterm="free_cmd.title"
>free</link
> </entry
></row>
</tbody
></tgroup
></informaltable>
</sect1>
</chapter>
