Translation by Artem Sereda with my minor changes

[kde-ru.git] / docs / kdewebdev / 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
>Add a libxslt parameter; equivalent to providing --param &lt;QNAME&gt;:&lt;XPATH&gt; via command line. </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 will try to guess the complete URL given a <informaltable
> <tgroup cols="1"
><tbody
> <row
><entry
>file name without a path specified.</entry
></row
> <row
><entry
>a file name in the same directory as the <quote
>top</quote
> stylesheet loaded</entry
></row
> <row
><entry
>a file name relative to the current working directory of xsldbg</entry
></row
> </tbody
></tgroup
> </informaltable
> Ie if you have loaded a stylesheet file of <filename
>../en/xsldoc.xsl</filename
> you can do this </para
><para
><userinput
>break -l xsldoc.xsl 26</userinput>
</para
><para
>This command will match a partial or complete QNAME template and or mode name provided. &eg; <quote
>template</quote
> will match any QNAME with a local part of <quote
>template</quote
> </para
><para
>Any name spaces in the provided QNAME will be expanded as specified by the names spaces defined in the XSL SOURCE file. &eg; <quote
>xsl:test1</quote
> will be expanded to <quote
>http://www.w3.org/199/XSL/Transform:test1</quote
> </para
><para
>A requested breakpoint may need to be resolved to its associated URL and line number. This is done automatically after the first template has been seen by xsldbg. Breakpoints are re-validated shortly after the start of each run. </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
>(To break at the <literal
>*</literal
> template. Other name that include <quote
>*</quote
> will not be treated specialy.)</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
>Usage: cat &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(To view a variable or parameter)</emphasis
></entry
></row>
<row
><entry
>Usage: 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
>(To change to a new xml data file. A leading <literal
>~</literal
> is replaced by the $HOME environment variable value. You will need to use the <quote
>run</quote
> command to process it)</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
>Shortcut name: 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
>Shortcut name: 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
>Shortcut name: 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
>(If &lt;INTEGER_VALUE&gt; is true the prefer html output for search results. See search command)</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
>If a mode exists on a template breakpoint then it will be appended to the end of template name for breakpoint. An example of the output is: <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
>(To change to a new source file. A leading <literal
>~</literal
> is replaced by the $HOME environment variable value. You will need to use the <command
>run</command
> command to execute it)</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
>Step down to a newer <quote
>call frame</quote
>.</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
>Step up to a older <quote
>call frame</quote
>.</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
>Shortcut name: 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>