<?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>