# Использование &xsldbg;

## аргументы команды xsldbg

Системы, в которых установлена библиотека readline, позволяют пользователю передвигаться по списку ранее введённых команд с помощью клавиш "вправо"/"влево". В любых системах последняя введённая команда может быть повторена простым нажатием клавиши <ENTER>.

Частичные имена файлов будут автоматически заменены на полные, если операционная система это поддерживает.

Некоторым командам можно передать несколько аргументов. Чтобы сложные выражения воспринимались как один аргумент, их заключают в кавычки, например: break "* | @" позволит пользователю увидеть точку останова в шаблоне с именем "* | @"

## Используемые обозначения

В данной таблице приводится описание условных обозначений, используемых в настоящем справочном руководстве

TEMPLATE_NAME: Допустимое имя шаблона, может содержать только ASCI-символы с кодами от 0x00 до to 0x7F. Может быть полностью определённым именем, например "xsl:templateName".
FILENAME: Допустимое имя файла из локальной файловой системы пользователя. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения.
URI: Универсальный Идентификатор Ресурса (Uniform Resource Identifiers) в соответствии с определением в RFC 2396
MODE_NAME: Режим шаблона, может быть полностью определённым именем, например "xsl:modeName".
QNAME : Полностью определённое имя, например "xsl:localPart"
LINENO : Допустимый номер строки в заданном <FILENAME>
NUMBER_OF_FRAMES : допустимое число кадров для перехода
BREAKPOINT_ID : Допустимый номер точки останова
WATCH_ID: Допустимый номер наблюдаемого выражения (watch expression), берётся из вывода команды showwatch
SPEED: скорость исполнения кода, принимает значения от 0 до 9
(Комментарий): комментарий, поясняющий значение команды или определяющий её использование
{ opt1 | opt2 | opt2 .. etc} : Выбор одного из opt-ов
XPATH: xpath-выборка узлов
PARAM_ID: допустимый номер параметра, берётся из вывода команды showparam
PATH: путь к новому рабочему каталогу. В некоторых системах префикс "~" будет заменён путём к вашему домашнему каталогу
TEXT: Текст в свободной форме (без ограничений)
COMMAND: Допустимая команда для xsdbg
QNAME: Допустимое имя переменной/параметра
SOURCE: Исполняемая/подлежащая исполнению таблица стилей. Также см. <FILENAME> и <URI>
DATA: Xml-данные (документ), которые будут обрабатываться таблицей стилей. Также см. <FILENAME> и <URI>
DEVICE_PATH: Допустимый терминал в операционной системе
TTY_LEVEL: допустимый уровень ввода/вывода

## Обзор доступных команд

Получение справки :help
Управление исполнением: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options
Управление параметрами libxslt : addparam, delparam, showparam, output, setoption, options
Управление шаблонами: templates, where, frame
Управление точками останова : break, showbreak, delete, enable
Отображение выражений(xpath): cat
Отображение узлов: ls, dir, du, cat, pwd
Отображение переменных: globals, locals, cat, addwatch
Задание переменных: set
Выбор узла: source, data, cd
Поиск: search
Команды операционной системе: chdir, shell, tty
Управление файлами: output, entities, system, public
Отключённые команды управления файлами: validate, load, save, write, free