tde-i18n/tde-i18n-ru/docs/tdewebdev/xsldbg/commands.docbook

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