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