You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tde-i18n/tde-i18n-ru/docs/tdewebdev/xsldbg/commands.docbook

1739 lines
48 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<?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 &lt;QNAME&gt;:&lt;XPATH&gt; в командной строке. </para>
<para
></para>
<table
><title
>Синтаксис команды addparam</title>
<tgroup cols="1"
><tbody>
<row
><entry
>addparam &lt;QNAME&gt; &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В строке &lt;XPATH&gt; не должно быть пробелов или двойных кавычек.) </emphasis
></entry
></row>
<row
><entry
>addparam &lt;QNAME&gt; "&lt;XPATH&gt;"&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В строке &lt;XPATH&gt; не должно быть двойных кавычек)</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 &lt;XPATH&gt;</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 &lt;FILENAME&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в заданной строке заданного файла)</emphasis
></entry
></row>
<row
><entry
>break -l &lt;URI&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в заданной строке заданного URI)</emphasis
></entry
></row>
<row
><entry
>break &lt;TEMPLATE_NAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Точка останова в шаблоне, имя которого задаётся полностью или регулярным выражением.)</emphasis
></entry
></row>
<row
><entry
>break &lt;TEMPLATE_NAME&gt; &lt;MODE_NAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в шаблоне с заданными именем и режимом.)
></emphasis
></entry
></row>
<row
><entry
>break "" &lt;MODE_NAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в любом шаблоне с заданным режимом)</emphasis
></entry
></row>
<row
><entry
>break *&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в любом найденном шаблоне.)</emphasis
></entry
></row>
<row
><entry
>break \*&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить точку останова в шаблоне "*". Прочие имена, включающие символ '*', отдельно обрабатываться не будут.)</emphasis
></entry
></row>
<row
><entry
>break &nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести переменную или параметр)</emphasis
></entry
></row>
<row
><entry
>Синтаксис: cat $&lt;QNAME&gt;</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
>&lt;&lt; = preceding-sibling::node()</entry
></row>
<row
><entry
>&gt;&gt; = following-sibling::node()</entry
></row>
<row
><entry
>&lt;- = ancestor::node()</entry
></row>
<row
><entry
>-&gt; = 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 &lt;PATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Показать текущий узел в документе.)</emphasis
></entry
></row>
<row
><entry
>data &lt;DATA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить точку останова в текущем узле)</emphasis
></entry
></row>
<row
><entry
>delete &lt;BREAKPOINT_ID&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить точку останова с заданным номером)</emphasis
></entry
></row>
<row
><entry
>delete -l &lt;FILENAME&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить точку останова в заданной строке заданного файла)</emphasis
></entry
></row>
<row
><entry
>delete -l &lt;URI&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить точку останова в заданной строке заданного URI)</emphasis
></entry
></row>
<row
><entry
>delete &lt;TEMMPLATENAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить точку останова в шаблоне с заданным именем.)</emphasis
></entry
></row>
<row
><entry
>delete *&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить все заданные параметры)</emphasis
></entry
></row>
<row
><entry
>delparam &lt;PARAM_ID&gt;</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 &lt;WATCHID&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Удалить наблюдаемое выражение с заданным ID)</emphasis
></entry
></row>
<row
><entry
>delwatch *&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Отключить точку останова в текущем узле)</emphasis
></entry
></row>
<row
><entry
>disable &lt;BREAKPOINT_ID&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Отключить точку останова с заданным номером</emphasis
></entry
></row>
<row
><entry
>disable -l &lt;FILENAME&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Отключить точку останова в заданной строке заданного файла)</emphasis
></entry
></row>
<row
><entry
>disable -l &lt;URI&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Включить/отключить точку останова в текущем узле)</emphasis
></entry
></row>
<row
><entry
>enable &lt;BREAKPOINT_ID&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Включить/отключить точку останова с заданным номером)</emphasis
></entry
></row>
<row
><entry
>enable -l &lt;FILENAME&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Включить/отключить точку останова в заданной строке заданного файла)</emphasis
></entry
></row>
<row
><entry
>enable -l &lt;URI&gt; &lt;LINENO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;FRAME_DEPTH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести список всех глобально доступных переменных)</emphasis
></entry
></row>
<row
><entry
>globals -f&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести список всех глобально доступных переменных и их значений)</emphasis
></entry
></row>
<row
><entry
>globals &lt;QNAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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 &nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести общую справку о продукте)</emphasis
></entry
></row>
<row
><entry
>help &lt;COMMAND&gt; &nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести список всех локально доступных переменных)</emphasis
></entry
></row>
<row
><entry
>locals -f&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести список всех локально доступных переменных и их значения)</emphasis
></entry
></row>
<row
><entry
>locals &lt;QNAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;FILENAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Имя доступного для записи файла из локальной файловой системы. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения)</emphasis
></entry
></row>
<row
><entry
>output &lt;URI&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В &lt;URI&gt; может быть использован только протокол "file://". Впоследствии URI будет приведён к имени файла, допустимому для операционной системы)</emphasis
></entry
></row>
<row
><entry
>output -&nbsp;&nbsp;&nbsp;&nbsp;<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 "&lt;PublicID&gt;"</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 &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Посмотреть, какие xpath могут быть использованы в search.dtd. Значение &lt;XPATH&gt; по умолчанию равно '//search/*' )</emphasis
></entry
></row>
<row
><entry
>search -sort &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;VARIABLE_NAME&gt; &lt;XPATH&gt;</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 &lt;OPTION_NAME&gt; &lt;INTEGER_VALUE&gt;</entry
></row>
<row
><entry
>где &lt;OPTION_NAME&gt; может быть одним из следующих:</entry
></row>
<row
><entry>
<para>
<informaltable>
<tgroup cols="1"
><tbody>
<row
><entry
>debug&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, вместо обычного выводавыводится дерева результатов)</emphasis
></entry
></row>
<row
><entry
>catalogs&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, используются каталоги из $SGML_CATALOG_FILES или SGML$CatalogFiles для risc-операционных систем)</emphasis
></entry
></row>
<row
><entry
>html&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, документ на входе будет HTML-файлом)</emphasis
></entry
></row>
<row
><entry
>docbook&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно и в libxml всё ещё есть поддержка docbook, документ на входе будет иметь формат SGML docbook)</emphasis
></entry
></row>
<row
><entry
>xinclude&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, документ на входе будет обработан средствами XInclude)</emphasis
></entry
></row>
<row
><entry
>preferhtml&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, результаты поиска будут по умолчанию выводиться в html-файл.: См. справку к команде search)</emphasis
></entry
></row>
<row
><entry
>autoencode&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, будет предпринята попытка использовать кодировку из таблицы стилей)</emphasis
></entry
></row>
<row
><entry
>utf8input&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, весь ввод от пользователя идёт в кодировке UTF-8. Используется, как правило, когда xsldbg запущен как нить [thread] какого-либо процесса))</emphasis
></entry
></row>
<row
><entry
>&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
></emphasis
></entry
></row>
<row
><entry
>gdb&nbsp;&nbsp;&nbsp;&nbsp;<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, разбираемое значение будет снабжаться префиксом "= " &lt; EXPRESSION &gt;</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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, DTD-данные или сущности не будут доставляться из сети)</emphasis
></entry
></row>
<row
><entry
>novalid&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, пропустить фазу загрузки DTD)</emphasis
></entry
></row>
<row
><entry
>repeat&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, выполнить трансформацию 20 раз)</emphasis
></entry
></row>
<row
><entry
>profile&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, вывести информацию о профиле)</emphasis
></entry
></row>
<row
><entry
>timing&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, отобразить используемое время)</emphasis
></entry
></row>
<row
><entry
>noout&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Если значение &lt;INTEGER_VALUE&gt; истинно, не выводить результат)</emphasis
></entry
></row>
</tbody
></tgroup>
</informaltable>
</para>
</entry
></row>
<row
><entry
>Где значение истинно, если НЕ РАВНО нулю</entry
></row>
<row
><entry
>Где значение ложно, если РАВНО нулю</entry
></row>
<row
><entry
>stdout&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>Выводить все сообщения об ошибках на стандартный вывод. Обычно все сообщения об ошибках выводятся на stderr.</emphasis
></entry
></row>
<row
><entry
>setoption &lt;OPTION_NAME&gt; "&lt;STRING_VALUE&gt;"&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В строке &lt;STRING_VALUE&gt; не должно быть двойных кавычек)</emphasis
></entry
></row>
<row
><entry
>setoption &lt;OPTION_NAME&gt; &lt;STRING_VALUE&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В строке &lt;STRING_VALUE&gt; не должно быть пробелов или двойных кавычек)</emphasis
></entry
></row>
<row
><entry
>где &lt;OPTION_NAME&gt; может быть одним из следующих:</entry
></row>
<row
><entry>
<para>
<informaltable>
<tgroup cols="1"
><tbody>
<row
><entry
>data&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(URI файла с данными)</emphasis
></entry
></row>
<row
><entry
>source&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(URI исходного файла)</emphasis
></entry
></row>
<row
><entry
>output&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести SystemID файла)</emphasis
></entry
></row>
<row
><entry
>docspath&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Путь к каталогу, в котором производится поиск документации)</emphasis
></entry
></row>
<row
><entry
>catalognames&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Имена каталогов, которые будут использоваться при выставленном ключе catalogs. Данное значение будет утеряно, если будет задано до установки ключа catalogs)</emphasis
></entry
></row>
<row
><entry
>encoding&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Какую кодировку использовать для стандартного вывода)</emphasis
></entry
></row>
<row
><entry
>searchresultspath&nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;TEXT&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(&lt;TEXT&gt; будет передан операционной системе для исполнения)</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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Показать выбранные в данный момент наблюдаемые выражения и их значения)</emphasis
></entry
></row>
<row
><entry
>showwatch 1&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Включить режим автоматического вывода наблюдаемых выражений. Режим включён по умолчанию.)</emphasis
></entry
></row>
<row
><entry
>showwatch 0&nbsp;&nbsp;&nbsp;&nbsp;<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&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Перейти к текущему узлу в таблице стилей.)</emphasis
></entry
></row>
<row
><entry
>source &lt;SOURCE&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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 &nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(передвинуться вниз по стеку на один кадр)</emphasis
></entry
></row>
<row
><entry
>stepdown &lt;NUMBER_OF_FRAMES&gt;&nbsp;&nbsp;&nbsp;&nbsp;<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 &nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(передвинуться вверх по стеку на один кадр)</emphasis
></entry
></row>
<row
><entry
>stepup &lt;NUMBER_OF_FRAMES&gt; &nbsp;&nbsp;&nbsp;&nbsp;<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 "&lt;SystemID&gt;"</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 &lt;TEMPLATE&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Вывести детальную информацию о шаблоне с именем &lt;TEMPLATE&gt;, если такой существует)</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 &lt;DEVICE_PATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Где &lt;DEVICE_PATH&gt; - существующий терминал операционной системы. Простая попытка открыть терминал</emphasis
></entry
></row>
<row
><entry
>tty &lt;TTY_LEVEL&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Установить уровень перенаправления ввода/вывода, где &lt;TTY_LEVEL&gt; - допустимый уровень ввода/вывода)</emphasis
> <para
> <informaltable
> <tgroup cols="1"
><tbody>
<row
><entry
>Где уровень может быть равен </entry
></row>
<row
><entry
>0 = ввод/вывод, установленный по умолчанию </entry
></row>
<row
><entry
>1 = Терминал используется для вывода результатов трансформаций, трассировок и исполнения кода &nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(В случае, когда был открыт терминал, это значение используется по умолчанию. В данной версии реализовано не полностью.)</emphasis
></entry
></row>
<row
><entry
>2 = Полное перенаправление на терминал&nbsp;&nbsp;&nbsp;&nbsp;<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 &lt;SPEED&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Чтобы остановить исполнение, используйте Ctrl-c, &lt;SPEED&gt; - число от 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>