|
|
<?xml version="1.0" encoding="UTF-8" ?>
|
|
|
<chapter id="commands">
|
|
|
<title>Описание команд</title>
|
|
|
|
|
|
<sect1 id="addparam_cmd"><title id="addparam_cmd.title">Addparam</title>
|
|
|
<para>Добавить параметр для libxslt; эквивалентно параметру --param <QNAME>:<XPATH> в командной строке. </para>
|
|
|
<para></para>
|
|
|
<table><title>Синтаксис команды addparam</title>
|
|
|
<tgroup cols="1"><tbody>
|
|
|
<row><entry>addparam <QNAME> <XPATH> <emphasis>(В строке <XPATH> не должно быть пробелов или двойных кавычек.) </emphasis></entry></row>
|
|
|
<row><entry>addparam <QNAME> "<XPATH>" <emphasis>(В строке <XPATH> не должно быть двойных кавычек)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="addwatch_cmd"><title id="addwatch_cmd.title">Addwatch</title>
|
|
|
<para>Добавить выражение для наблюдения. Для просмотра значений наблюдаемых выражений см. showwatch</para>
|
|
|
<para>Краткая форма: watch</para>
|
|
|
<table><title>Синтаксис команды addwatch</title>
|
|
|
<tgroup cols="1"><tbody>
|
|
|
<row><entry>addwatch <XPATH></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="base_cmd"><title id="base_cmd.title">Base</title>
|
|
|
<para>Вывести XML-базу заданного узла</para>
|
|
|
<table><title>Синтаксис команды base</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>base</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="break_cmd"><title id="break_cmd.title">Break</title>
|
|
|
<para>Установить точку останова в заданном шаблоне, в текущем узле, в заданном месте таблицы стилей или загруженного в xsldbg xml-файла. Новое поведение для xsldbg версии 3.1.4: в режиме совместимости с gdb Для заданной строки заданного файла могут быть установлены недействующие точки останова, которыевпоследствии будут переведены в активное состояние </para>
|
|
|
<para>Краткая форма: b</para><para>xsldbg попытается самостоятельно определить полный URL для <informaltable> <tgroup cols="1"><tbody> <row><entry>имени файла без заданного пути.</entry></row> <row><entry>имени файла, расположенного в одном каталоге с загруженной в данный момент таблицей стилей_"top"_</entry></row> <row><entry>имени файла, относительно текущего рабочего каталога xsldbg</entry></row> </tbody></tgroup> </informaltable> Другими словами, если вы загрузили файл с таблицами стилей из ../en/xsldoc.xsl , вы можете сделать следующее: </para><para>break -l xsldoc.xsl 26 </para><para>Эта команда сработает для шаблона и/или режима с полным или частичным QNAME.Например, "template" сработает для любого QNAME, содержащегося в локальной части "template" </para><para>Все пространства имён в заданном QNAME будут определены в соответствии с пространствами имён, указанными в файле XSL SOURCE. Например, "xsl:test1" будет определён как "http://www.w3.org/199/XSL/Transform:test1" </para><para>Возможно, что заданная точка останова должна быть связана с соответствующим URL и номером строки. Это делается автоматически сразу после того, как xsldbg просмотрел первый шаблон Повторное связывание точек останова со своими URL происходит в начале каждого запуска исполнения. </para><para>При включённом режиме gdb используется автоматическая валидация точек останова, такое поведение установлено вxsldbg по умолчанию</para>
|
|
|
<table><title>Синтаксис команды break</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>break -l <FILENAME> <LINENO> <emphasis>(Установить точку останова в заданной строке заданного файла)</emphasis></entry></row>
|
|
|
<row><entry>break -l <URI> <LINENO> <emphasis>(Установить точку останова в заданной строке заданного URI)</emphasis></entry></row>
|
|
|
<row><entry>break <TEMPLATE_NAME> <emphasis>(Точка останова в шаблоне, имя которого задаётся полностью или регулярным выражением.)</emphasis></entry></row>
|
|
|
<row><entry>break <TEMPLATE_NAME> <MODE_NAME> <emphasis>(Установить точку останова в шаблоне с заданными именем и режимом.)></emphasis></entry></row>
|
|
|
<row><entry>break "" <MODE_NAME> <emphasis>(Установить точку останова в любом шаблоне с заданным режимом)</emphasis></entry></row>
|
|
|
<row><entry>break * <emphasis>(Установить точку останова в любом найденном шаблоне.)</emphasis></entry></row>
|
|
|
<row><entry>break \* <emphasis>(Установить точку останова в шаблоне "*". Прочие имена, включающие символ '*', отдельно обрабатываться не будут.)</emphasis></entry></row>
|
|
|
<row><entry>break <emphasis>(Точка останова в текущем узле. Да, это распространяется и на узлы с xml-данными!)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="bye_cmd"><title id="bye_cmd.title">Bye</title>
|
|
|
<para>Завершить исполнение таблицы стилей при ближайшей возможности.</para>
|
|
|
<table><title>Синтаксис команды bye</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>bye</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="cat_cmd"><title id="cat_cmd.title">Cat</title>
|
|
|
<para>Вывести результат выражения xPath, относящегося к текущему узлу</para>
|
|
|
<table><title>Синтаксис команды cat</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>Синтаксис: cat <XPATH> <emphasis>(Вывести переменную или параметр)</emphasis></entry></row>
|
|
|
<row><entry>Синтаксис: cat $<QNAME></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="cd_cmd"><title id="cd_cmd.title">Cd</title>
|
|
|
<para>Изменить путь, указанный в xpath.</para>
|
|
|
<table><title>Синтаксис команды cd</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry><< = preceding-sibling::node()</entry></row>
|
|
|
<row><entry>>> = following-sibling::node()</entry></row>
|
|
|
<row><entry><- = ancestor::node()</entry></row>
|
|
|
<row><entry>-> = decendant::node()</entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="chdir_cmd"><title id="chdir_cmd.title">Chdir</title>
|
|
|
<para>Сменить рабочий каталог</para>
|
|
|
<table><title>Синтаксис команды chdir</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>chdir <PATH> <emphasis>(Относительный или абсолютный путь в операционной системе)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="continue_cmd"><title id="continue_cmd.title">Continue</title>
|
|
|
<para>Продолжить исполнение таблицы стилей с остановками на всех обнаруженных точках останова</para>
|
|
|
<para>Краткая форма: c</para>
|
|
|
<table><title>Синтаксис команды continue</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>continue</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="data_cmd"><title id="data_cmd.title">Data</title>
|
|
|
<para>Переключиться в режим отображения текущего узла xml-данных. Или переключиться от одного xml-файла к другому.</para>
|
|
|
<table><title>Синтаксис команды data</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>data <emphasis>(Показать текущий узел в документе.)</emphasis></entry></row>
|
|
|
<row><entry>data <DATA> <emphasis>(Использовать новый файл с xml-данными. Символ "~" в начале имени файла будет замещён значением переменной окружения $HOME. Для его обработки потребуется команда "run")</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="delete_cmd"><title id="delete_cmd.title">Delete</title>
|
|
|
<para>Удалить точку останова в шаблоне</para>
|
|
|
<para>Краткая форма: d</para>
|
|
|
<table><title>Синтаксис команды delete</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>delete <emphasis>(Удалить точку останова в текущем узле)</emphasis></entry></row>
|
|
|
<row><entry>delete <BREAKPOINT_ID> <emphasis>(Удалить точку останова с заданным номером)</emphasis></entry></row>
|
|
|
<row><entry>delete -l <FILENAME> <LINENO> <emphasis>(Удалить точку останова в заданной строке заданного файла)</emphasis></entry></row>
|
|
|
<row><entry>delete -l <URI> <LINENO> <emphasis>(Удалить точку останова в заданной строке заданного URI)</emphasis></entry></row>
|
|
|
<row><entry>delete <TEMMPLATENAME> <emphasis>(Удалить точку останова в шаблоне с заданным именем.)</emphasis></entry></row>
|
|
|
<row><entry>delete * <emphasis>(Удалить все точки останова.)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="delparam_cmd"><title id="delparam_cmd.title">Delparam</title>
|
|
|
<para>Удалить libxslt-параметр</para>
|
|
|
<table><title>Синтаксис команды delparam</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>delparam <emphasis>(Удалить все заданные параметры)</emphasis></entry></row>
|
|
|
<row><entry>delparam <PARAM_ID></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="delwatch_cmd"><title id="delwatch_cmd.title">Delwatch</title>
|
|
|
<para>Удалить наблюдаемое выражение или удалить все наблюдаемые выражения, присутствующие в выводе команды "showwatch."</para>
|
|
|
<table><title>Синтаксис команды delwatch</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>delwatch <WATCHID> <emphasis>(Удалить наблюдаемое выражение с заданным ID)</emphasis></entry></row>
|
|
|
<row><entry>delwatch * <emphasis>(Удалить все наблюдаемые выражения)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="dir_cmd"><title id="dir_cmd.title">Dir</title>
|
|
|
<para>Вывести список узлов в формате, схожем с выводом shell-команды dir.</para>
|
|
|
<para/>
|
|
|
<table><title>Синтаксис команды dir</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>dir</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="disable_cmd"><title id="disable_cmd.title">Disable</title>
|
|
|
<para>Отключить точку останова</para>
|
|
|
<table><title>Синтаксис команды disable</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>disable <emphasis>(Отключить точку останова в текущем узле)</emphasis></entry></row>
|
|
|
<row><entry>disable <BREAKPOINT_ID> <emphasis>(Отключить точку останова с заданным номером</emphasis></entry></row>
|
|
|
<row><entry>disable -l <FILENAME> <LINENO> <emphasis>(Отключить точку останова в заданной строке заданного файла)</emphasis></entry></row>
|
|
|
<row><entry>disable -l <URI> <LINENO> <emphasis>(Отключить точку останова в заданной строке заданного URI)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="du_cmd"><title id="du_cmd.title">Du</title>
|
|
|
<para>Вывести список дочерних узлов в древовидной форме</para>
|
|
|
<table><title>Синтаксис команды du</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>du</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="dump_cmd"><title id="dump_cmd.title">Dump</title>
|
|
|
<para>Вывести самую подробную информацию о заданном узле</para>
|
|
|
<table><title>Синтаксис команды dump</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>dump</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="enable_cmd"><title id="enable_cmd.title">Enable</title>
|
|
|
<para>Включить или отключить точку останова (Переключение статуса активно/неактивно/)</para>
|
|
|
<para>Краткая форма: e</para>
|
|
|
<table><title>Синтаксис команды enable</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>enable <emphasis>(Включить/отключить точку останова в текущем узле)</emphasis></entry></row>
|
|
|
<row><entry>enable <BREAKPOINT_ID> <emphasis>(Включить/отключить точку останова с заданным номером)</emphasis></entry></row>
|
|
|
<row><entry>enable -l <FILENAME> <LINENO> <emphasis>(Включить/отключить точку останова в заданной строке заданного файла)</emphasis></entry></row>
|
|
|
<row><entry>enable -l <URI> <LINENO> <emphasis>(Включить/отключить точку останова в заданной строке заданного URI)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="entities_cmd"><title id="entities_cmd.title">Entities</title>
|
|
|
<para>Вывести список внешних Общих Разобранных Сущностей (General Parsed entities), используемых в файле с данными (документ)</para>
|
|
|
<para>Краткая форма: ent</para>
|
|
|
<table><title>Синтаксис команды entities</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>entities</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="exit_cmd"><title id="exit_cmd.title">Exit</title>
|
|
|
<para>Завершить исполнение таблицы стилей при ближайшей возможности.</para>
|
|
|
<table><title>Синтаксис команды exit</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>exit</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="frame_cmd"><title id="frame_cmd.title">Frame</title>
|
|
|
<para>Вывести кадр стека с заданной глубиной</para>
|
|
|
<para>Краткая форма: f</para>
|
|
|
<table><title>Синтаксис команды frame</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>frame <FRAME_DEPTH> <emphasis>(Здесь Глубина (Depth) - число от 0 до текущей глубины стека вызовов)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="free_cmd"><title id="free_cmd.title">Free</title>
|
|
|
<para>Освободить ресурсы: таблицу стилей и данные (Команда отключена, см. run)</para>
|
|
|
<table><title>Синтаксис команды free</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>free</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="globals_cmd"><title id="globals_cmd.title">Globals</title>
|
|
|
<para>Вывести список глобальных переменных или параметров для таблицы стилей. Вывести значение глобальной переменной</para>
|
|
|
<table><title>Синтаксис команды globals</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>globals <emphasis>(Вывести список всех глобально доступных переменных)</emphasis></entry></row>
|
|
|
<row><entry>globals -f <emphasis>(Вывести список всех глобально доступных переменных и их значений)</emphasis></entry></row>
|
|
|
<row><entry>globals <QNAME> <emphasis>(Вывести значение указанной переменной)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="help_cmd"><title id="help_cmd.title">Help</title>
|
|
|
<para>Вывести справку о команде или общую справку о продукте</para>
|
|
|
<para>Краткая форма: h</para>
|
|
|
<table><title>Синтаксис команды help</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>help <emphasis>(Вывести общую справку о продукте)</emphasis></entry></row>
|
|
|
<row><entry>help <COMMAND> <emphasis>(Вывести справку о команде)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="load_cmd"><title id="load_cmd.title">Load</title>
|
|
|
<para>Загрузить ключи xsldbg и пользовательские настройки с диска</para>
|
|
|
<table><title>Синтаксис команды load</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>load</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="locals_cmd"><title id="locals_cmd.title">Locals</title>
|
|
|
<para>Вывести список локальных переменных или параметров для таблицы стилей. Вывести значение локальной переменной</para>
|
|
|
<table><title>Синтаксис команды locals</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>locals <emphasis>(Вывести список всех локально доступных переменных)</emphasis></entry></row>
|
|
|
<row><entry>locals -f <emphasis>(Вывести список всех локально доступных переменных и их значения)</emphasis></entry></row>
|
|
|
<row><entry>locals <QNAME> <emphasis>(Вывести значение указанной переменной)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="ls_cmd"><title id="ls_cmd.title">Ls</title>
|
|
|
<para>Вывести список узлов в кратком формате</para>
|
|
|
<table><title>Синтаксис команды ls</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>ls</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="next_cmd"><title id="next_cmd.title">Next</title>
|
|
|
<para>Перейти к следующей инструкции без "захода" в xsl:call-template или xsl:apply-templates. Действие данной команды эквивалентно действию комбинации команд "step" и "up"</para>
|
|
|
<para>Краткая форма: n</para>
|
|
|
<table><title>Синтаксис команды next</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>next <emphasis>(перейти к следующей инструкции того же уровня)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="options_cmd"><title id="options_cmd.title">Options</title>
|
|
|
<para>Вывести значения ключей xsldbg</para>
|
|
|
<table><title>Синтаксис команды options</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>options</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="output_cmd"><title id="output_cmd.title">Output</title>
|
|
|
<para>Указать доступный для записи файл в локальной файловой системе, в него будут сохранены результаты</para>
|
|
|
<para>Краткая форма: o</para>
|
|
|
<table><title>Синтаксис команды output</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>output <FILENAME> <emphasis>(Имя доступного для записи файла из локальной файловой системы. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения)</emphasis></entry></row>
|
|
|
<row><entry>output <URI> <emphasis>(В <URI> может быть использован только протокол "file://". Впоследствии URI будет приведён к имени файла, допустимому для операционной системы)</emphasis></entry></row>
|
|
|
<row><entry>output - <emphasis>( Отправить на стандартный вывод. Может использоваться только когда xsldbg запущен в режиме командной строки)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="public_cmd"><title id="public_cmd.title">Public</title>
|
|
|
<para>Вывести значение, на которое Public ID отображается через текущий каталог</para>
|
|
|
<para>Краткая форма: pub</para>
|
|
|
<table><title>Синтаксис команды public</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>public "<PublicID>"</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="pwd_cmd"><title id="pwd_cmd.title">Pwd</title>
|
|
|
<para>Вывести путь текущего рабочего каталога</para>
|
|
|
<table><title>Синтаксис команды pwd</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>pwd</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="quit_cmd"><title id="quit_cmd.title">Quit</title>
|
|
|
<para>Завершить исполнение таблицы стилей при ближайшей возможности.</para>
|
|
|
<para>Краткая форма: q</para>
|
|
|
<table><title>Синтаксис команды quit</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>quit</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="run_cmd"><title id="run_cmd.title">Run</title>
|
|
|
<para>Перезапустить исполнение таблицы стилей.</para>
|
|
|
<para>Краткая форма: r</para>
|
|
|
<table><title>Синтаксис команды run</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>run</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="save_cmd"><title id="save_cmd.title">Save</title>
|
|
|
<para>Сохранить ключи xsldbg и пользовательские настройки на диск</para>
|
|
|
<table><title>Синтаксис команды save</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>save</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="search_cmd"><title id="search_cmd.title">Search</title>
|
|
|
<para>Поиск в базе данных, собранных во всех загруженных таблицах стилей</para>
|
|
|
<para>Все результаты поиска сохраняются в каталоге, указанном ключом"searchresultspath", или в том же каталоге, что и исходная таблица стилей, если данный ключ не был выставлен.Как правило, для трансформаций в файле searchresults.xml используется search.xsl, но если выставлен ключ "prefrehtml", то будет использоваться searchhtml.xsl </para><para>При исполнении команды search создаётся xml-файл (searchresults.xml). Впоследствии вы можете обработать этот файл вашей собственной таблицей стилей, и получить вывод в нужном вам формате. Если ключ"preferhtml" не выставлен, то результаты поиска будут выведены в searchresult.txt </para><para>При большом объёме обрабатываемых данных, выполнение этой команды может занять некоторое время. </para>
|
|
|
<table><title>Синтаксис команды search</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>search <XPATH> <emphasis>(Посмотреть, какие xpath могут быть использованы в search.dtd. Значение <XPATH> по умолчанию равно '//search/*' )</emphasis></entry></row>
|
|
|
<row><entry>search -sort <XPATH> <emphasis>(С этим ключом search.xsl будет сортировать результаты перед их выводом)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="set_cmd"><title id="set_cmd.title">Set</title>
|
|
|
<para>Установить значение переменной</para>
|
|
|
<table><title>Синтаксис команды set</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>set <VARIABLE_NAME> <XPATH></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="setoption_cmd"><title id="setoption_cmd.title">Setoption</title>
|
|
|
<para>Установить ключ исполнения таблицы стилей</para>
|
|
|
<para>Для того, чтобы изменения вступили в силу, нужно воспользоваться командой run</para>
|
|
|
<table><title>Синтаксис команды setoption</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>setoption <OPTION_NAME> <INTEGER_VALUE></entry></row>
|
|
|
<row><entry>где <OPTION_NAME> может быть одним из следующих:</entry></row>
|
|
|
<row><entry>
|
|
|
<para>
|
|
|
<informaltable>
|
|
|
<tgroup cols="1"><tbody>
|
|
|
<row><entry>debug <emphasis>(Если значение <INTEGER_VALUE> истинно, вместо обычного выводавыводится дерева результатов)</emphasis></entry></row>
|
|
|
<row><entry>catalogs <emphasis>(Если значение <INTEGER_VALUE> истинно, используются каталоги из $SGML_CATALOG_FILES или SGML$CatalogFiles для risc-операционных систем)</emphasis></entry></row>
|
|
|
<row><entry>html <emphasis>(Если значение <INTEGER_VALUE> истинно, документ на входе будет HTML-файлом)</emphasis></entry></row>
|
|
|
<row><entry>docbook <emphasis>(Если значение <INTEGER_VALUE> истинно и в libxml всё ещё есть поддержка docbook, документ на входе будет иметь формат SGML docbook)</emphasis></entry></row>
|
|
|
<row><entry>xinclude <emphasis>(Если значение <INTEGER_VALUE> истинно, документ на входе будет обработан средствами XInclude)</emphasis></entry></row>
|
|
|
<row><entry>preferhtml <emphasis>(Если значение <INTEGER_VALUE> истинно, результаты поиска будут по умолчанию выводиться в html-файл.: См. справку к команде search)</emphasis></entry></row>
|
|
|
<row><entry>autoencode <emphasis>(Если значение <INTEGER_VALUE> истинно, будет предпринята попытка использовать кодировку из таблицы стилей)</emphasis></entry></row>
|
|
|
<row><entry>utf8input <emphasis>(Если значение <INTEGER_VALUE> истинно, весь ввод от пользователя идёт в кодировке UTF-8. Используется, как правило, когда xsldbg запущен как нить [thread] какого-либо процесса))</emphasis></entry></row>
|
|
|
<row><entry> <emphasis></emphasis></entry></row>
|
|
|
<row><entry>gdb <emphasis>(Запуск в режиме совместимости с gdb)</emphasis> <para> <informaltable> <tgroup cols="1"><tbody>
|
|
|
<row><entry>Для значения 1 это: <para> <informaltable> <tgroup cols="1"><tbody>
|
|
|
<row><entry>Вывод много большего количества сообщений. Частота появления сообщения "Breapoint at ..." ("Точка останова в...") возрастает</entry></row>
|
|
|
<row><entry>Не больше GDB_LINES_TO_PRINT строк будет выведено при разборе выражений, после этого будет выведены символы "...". Это значение можно изменить в options.h, по умолчанию оно равно трём строкам текста</entry></row>
|
|
|
<row><entry>Командой "locals" выводятся список как локальных, так и глобальных переменных </entry></row>
|
|
|
<row><entry>При выводе выражений командами cat/print, разбираемое значение будет снабжаться префиксом "= " < EXPRESSION ></entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row>
|
|
|
<row><entry/></row>
|
|
|
<row><entry>Для значения 2 это: <para> <informaltable> <tgroup cols="1"><tbody> <row><entry>Вывод сообщений, затребованных KDbg, вместе с сообщениями, описанными выше (когда значение равно 1) </entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row>
|
|
|
<row><entry>nonet <emphasis>(Если значение <INTEGER_VALUE> истинно, DTD-данные или сущности не будут доставляться из сети)</emphasis></entry></row>
|
|
|
<row><entry>novalid <emphasis>(Если значение <INTEGER_VALUE> истинно, пропустить фазу загрузки DTD)</emphasis></entry></row>
|
|
|
<row><entry>repeat <emphasis>(Если значение <INTEGER_VALUE> истинно, выполнить трансформацию 20 раз)</emphasis></entry></row>
|
|
|
<row><entry>profile <emphasis>(Если значение <INTEGER_VALUE> истинно, вывести информацию о профиле)</emphasis></entry></row>
|
|
|
<row><entry>timing <emphasis>(Если значение <INTEGER_VALUE> истинно, отобразить используемое время)</emphasis></entry></row>
|
|
|
<row><entry>noout <emphasis>(Если значение <INTEGER_VALUE> истинно, не выводить результат)</emphasis></entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row>
|
|
|
<row><entry>Где значение истинно, если НЕ РАВНО нулю</entry></row>
|
|
|
<row><entry>Где значение ложно, если РАВНО нулю</entry></row>
|
|
|
<row><entry>stdout <emphasis>Выводить все сообщения об ошибках на стандартный вывод. Обычно все сообщения об ошибках выводятся на stderr.</emphasis></entry></row>
|
|
|
<row><entry>setoption <OPTION_NAME> "<STRING_VALUE>" <emphasis>(В строке <STRING_VALUE> не должно быть двойных кавычек)</emphasis></entry></row>
|
|
|
<row><entry>setoption <OPTION_NAME> <STRING_VALUE> <emphasis>(В строке <STRING_VALUE> не должно быть пробелов или двойных кавычек)</emphasis></entry></row>
|
|
|
<row><entry>где <OPTION_NAME> может быть одним из следующих:</entry></row>
|
|
|
<row><entry>
|
|
|
<para>
|
|
|
<informaltable>
|
|
|
<tgroup cols="1"><tbody>
|
|
|
<row><entry>data <emphasis>(URI файла с данными)</emphasis></entry></row>
|
|
|
<row><entry>source <emphasis>(URI исходного файла)</emphasis></entry></row>
|
|
|
<row><entry>output <emphasis>(Вывести SystemID файла)</emphasis></entry></row>
|
|
|
<row><entry>docspath <emphasis>(Путь к каталогу, в котором производится поиск документации)</emphasis></entry></row>
|
|
|
<row><entry>catalognames <emphasis>(Имена каталогов, которые будут использоваться при выставленном ключе catalogs. Данное значение будет утеряно, если будет задано до установки ключа catalogs)</emphasis></entry></row>
|
|
|
<row><entry>encoding <emphasis>(Какую кодировку использовать для стандартного вывода)</emphasis></entry></row>
|
|
|
<row><entry>searchresultspath <emphasis>Путь к каталогу, который будет использоваться для сохранения результатов поиска. Если такой путь не задан, то xsldbg будет использовать путь к каталогу с таблицами стилей</emphasis></entry></row>
|
|
|
</tbody></tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row></tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="shell_cmd"><title id="shell_cmd.title">Shell</title>
|
|
|
<para>Выполнить shell-команду </para>
|
|
|
<table><title>Синтаксис команды shell</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>shell <TEXT> <emphasis>(<TEXT> будет передан операционной системе для исполнения)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="showbreak_cmd"><title id="showbreak_cmd.title">Showbreak</title>
|
|
|
<para>Вывести список точек останова в шаблоне</para>
|
|
|
<para>Краткая форма: show</para><para>Если для шаблона задан режим, то имя режима будет добавлено в конец имени шаблона при установке точки останова. Вывод команды может быть, например, таким: <informaltable> <tgroup cols="1"><tbody>
|
|
|
<row><entry>Точка останова 3 включена для шаблона :"*" в файле test1.xsl : строка 105</entry></row>
|
|
|
<row><entry>Точка останова 2 включена для шаблона :"* testMode" в файле test1.xsl : строка 109</entry></row>
|
|
|
<row><entry>Точка останова 1 включена для шаблона:"* http://www.w3.org/1999/XSL/Transform:testMode" в файле test1.xsl : строка 113</entry></row>
|
|
|
<row><entry/></row>
|
|
|
<row><entry>Всего 3 точки останова</entry></row>
|
|
|
</tbody></tgroup></informaltable></para>
|
|
|
<table><title>Синтаксис команды showbreak</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>showbreak</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="showparam_cmd"><title id="showparam_cmd.title">Showparam</title>
|
|
|
<para>Вывести список существующих параметров libxslt</para>
|
|
|
<table><title>Синтаксис команды showparam</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>showparam</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="showwatch_cmd"><title id="showwatch_cmd.title">Showwatch</title>
|
|
|
<para>Показать текущее наблюдаемое выражение</para>
|
|
|
<para>Краткая форма: watches</para>
|
|
|
<table><title>Синтаксис команды showwatch</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>showwatch <emphasis>(Показать выбранные в данный момент наблюдаемые выражения и их значения)</emphasis></entry></row>
|
|
|
<row><entry>showwatch 1 <emphasis>(Включить режим автоматического вывода наблюдаемых выражений. Режим включён по умолчанию.)</emphasis></entry></row>
|
|
|
<row><entry>showwatch 0 <emphasis>(Выключить режим автоматического вывода наблюдаемых выражений.)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="source_cmd"><title id="source_cmd.title">Source</title>
|
|
|
<para>Переключиться в режим отображения текущего узла в таблице стилей. Или использовать другую таблицу стилей.</para>
|
|
|
<table><title>Синтаксис команды source</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>source <emphasis>(Перейти к текущему узлу в таблице стилей.)</emphasis></entry></row>
|
|
|
<row><entry>source <SOURCE> <emphasis>(Использовать новый файл с таблицей стилей. Символ "~" в начале имени файла будет замещён значением переменной окружения $HOME. Для его обработки потребуется команда "run")</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="step_cmd"><title id="step_cmd.title">Step</title>
|
|
|
<para>Перейти к следующей инструкции таблицы стилей.</para>
|
|
|
<para>Краткая форма: s</para>
|
|
|
<table><title>Синтаксис команды step</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>step</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="stepdown_cmd"><title id="stepdown_cmd.title">Stepdown</title>
|
|
|
<para>Передвинуться вниз по стеку к кадрам, которые были созданы позже. </para>
|
|
|
<para>Краткая форма: down</para>
|
|
|
<table><title>Синтаксис команды stepdown</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>stepdown <emphasis>(передвинуться вниз по стеку на один кадр)</emphasis></entry></row>
|
|
|
<row><entry>stepdown <NUMBER_OF_FRAMES> <emphasis>(передвинуться вниз по стеку на заданное количество кадров.)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="stepup_cmd"><title id="stepup_cmd.title">Stepup</title>
|
|
|
<para>Передвинуться вверх по стеку к кадрам, которые существуют дольше. </para>
|
|
|
<para>Краткая форма: up</para><para>Эта команда выполняется не очень точно, xsldbg произведёт остановку при ближайшей возможности. </para>
|
|
|
<table><title>Синтаксис команды stepup</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>stepup <emphasis>(передвинуться вверх по стеку на один кадр)</emphasis></entry></row>
|
|
|
<row><entry>stepup <NUMBER_OF_FRAMES> <emphasis>(передвинуться вверх по стеку на заданное количество кадров.)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="stylesheets_cmd"><title id="stylesheets_cmd.title">Stylesheets</title>
|
|
|
<para>Вывести список всех загруженных таблиц стилей</para>
|
|
|
<para>Краткая форма: style</para>
|
|
|
<table><title>Синтаксис команды stylesheets</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>stylesheets</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
<sect1 id="system_cmd"><title id="system_cmd.title">System</title>
|
|
|
<para>Вывести значение, на которое System ID отображается через текущий каталог</para>
|
|
|
<para>Краткая форма: sys</para>
|
|
|
<table><title>Синтаксис команды system</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>system "<SystemID>"</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="templates_cmd"><title id="templates_cmd.title">Templates</title>
|
|
|
<para>Вывести список всех доступных шаблонов. Произвести поиск шаблона</para>
|
|
|
<para>Краткая форма: t</para>
|
|
|
<table><title>Синтаксис команды templates</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>templates</entry></row>
|
|
|
<row><entry>templates <TEMPLATE> <emphasis>(Вывести детальную информацию о шаблоне с именем <TEMPLATE>, если такой существует)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="trace_cmd"><title id="trace_cmd.title">Trace</title>
|
|
|
<para>Трассировка исполнения таблицы стилей с указанием файла и строк промежуточных шагов.</para>
|
|
|
<table><title>Синтаксис команды trace</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>trace</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="tty_cmd"><title id="tty_cmd.title">Tty</title>
|
|
|
<para>Открыть терминал. Установить уровень перенаправления ввода/вывода.</para>
|
|
|
<table><title>Синтаксис команды tty</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>tty <DEVICE_PATH> <emphasis>(Где <DEVICE_PATH> - существующий терминал операционной системы. Простая попытка открыть терминал</emphasis></entry></row>
|
|
|
<row><entry>tty <TTY_LEVEL> <emphasis>(Установить уровень перенаправления ввода/вывода, где <TTY_LEVEL> - допустимый уровень ввода/вывода)</emphasis> <para> <informaltable> <tgroup cols="1"><tbody>
|
|
|
<row><entry>Где уровень может быть равен </entry></row>
|
|
|
<row><entry>0 = ввод/вывод, установленный по умолчанию </entry></row>
|
|
|
<row><entry>1 = Терминал используется для вывода результатов трансформаций, трассировок и исполнения кода <emphasis>(В случае, когда был открыт терминал, это значение используется по умолчанию. В данной версии реализовано не полностью.)</emphasis></entry></row>
|
|
|
<row><entry>2 = Полное перенаправление на терминал <emphasis>(В данной версии не реализовано.)</emphasis></entry></row>
|
|
|
<row><entry>Все прочие целочисленные значения трактуются как задание уровня 0 </entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</informaltable>
|
|
|
</para>
|
|
|
</entry></row></tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="validate_cmd"><title id="validate_cmd.title">Validate</title>
|
|
|
<para>Проверить на правильность файл, полученный после обработки таблицы стилей (Команда отключена)</para>
|
|
|
<table><title>Синтаксис команды validate</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>validate</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="walk_cmd"><title id="walk_cmd.title">Walk</title>
|
|
|
<para>Запустить исполнение кода с заданной скоростью</para>
|
|
|
<table><title>Синтаксис команды walk</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>walk <SPEED> <emphasis>(Чтобы остановить исполнение, используйте Ctrl-c, <SPEED> - число от 0 до 9, где 0 - остановка, 1 - самая высокая скорость, 9 - самая низкая скорость)</emphasis></entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="where_cmd"><title id="where_cmd.title">Where</title>
|
|
|
<para>Показать цепочку вызовов шаблонов (стек кадров) и рабочий каталог.</para>
|
|
|
<para>Краткая форма: w</para>
|
|
|
<table><title>Синтаксис команды where</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>where</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="write_cmd"><title id="write_cmd.title">Write</title>
|
|
|
<para>Описание команды появится в следующих версиях</para>
|
|
|
<table><title>Синтаксис команды write</title>
|
|
|
<tgroup cols="1">
|
|
|
<tbody>
|
|
|
<row><entry>write</entry></row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</chapter>
|
