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