# Довідка щодо команд

## Addparam

Додати параметр libxslt; рівнозначне зазначенню --param <QNAME>:<XPATH> у командному рядку.

### Використання Addparam

addparam <QNAME> <XPATH> (У <XPATH> не повинно міститися пробілів і подвійних лапок.)
addparam <QNAME> "<XPATH>" (У <XPATH> не повинно міститися подвійних лапок)

## Addwatch

Додати вираз, за яким вестиметься спостереження. Вивід значень спостереження можна здійснити за допомогою showwatch

Скорочення: watch

### Використання Addwatch

addwatch <XPATH>

## Base

Виводи основу заданого вузла

### Використання Base

base

## Break

Перервати виконання на шаблоні, позиції у таблиці стилів або файлі xml, завантаженому xsldbg, або на поточному вузлі. Нове у xsldbg 3.1.4: у режимі сумісності з gdb можна встановлюватися окремі точки зупину на окремому файлі і номері рядку, а потім вмикатися програмою під час активування файла.

Скорочення: b

xsldbg може визначати URL повністю за

назвою файла без вказаного шляху до нього.
назвою файла, який знаходиться у тому ж каталозі, що і завантажена таблиця стилів вищого рівня
назвою файла відносно поточного робочого каталогу xsldbg

Таку дію може бути виконано, якщо ви завантажили файл таблиці стилів `../en/xsldoc.xsl`

`break -l xsldoc.xsl 26`

Цю команду буде виконано на шаблоні з частковою або повною назвою QNAME і/або назві режиму. Наприклад, за назвою template буде виконано дії з усіма файлами, чия назва QNAME містить частину template.

Всі простори назв у вказаному файлі QNAME буде розгорнуто згідно до просторів імен, визначених у файлі XSL SOURCE. Наприклад, xsl:test1 буде розгорнуто до http://www.w3.org/199/XSL/Transform:test1

Запит на точку зупину може потребувати визначення відповідного URL і номера рядка. Таке визначення буде автоматично виконано після виявлення xsldbg першого шаблону. Точки зупину буде повторно визначено невдовзі після запуску кожного з сеансів виконання.

Якщо буде увімкнено режим сумісності з gdb, програма виконає автоматичну перевірку точок зупину, — це типова поведінка для xsldbg

### Використання break

break -l <FILENAME> <LINENO> (Встановлює точку зупину у вказаному рядку файла)
break -l <URI> <LINENO> (Встановлює точку зупину у вказаному рядку за адресою URI)
break <НАЗВА_ШАБЛОНУ> (Встановлює точку зупину у названому або відповідному шаблоні.)
break <НАЗВА_ШАБЛОНУ> <НАЗВА_РЕЖИМУ> (Встановлює точку зупину у вказаному шаблоні з заданим режимом.) >
break "" <НАЗВА_РЕЖИМУ> (зупинка у всіх шаблонах, у яких міститься режим з вказаною назвою)
break * (зупинка у всіх знайдених шаблонах.)
break \* (зупинка у шаблоні `*`. Інші назви, що містять *, буде оброблено окремо.)
break (встановити точку зупину на поточному вузлі. Так, можна використовувати вузли даних xml!)

## Bye

Якомога швидше перервати обробку поточної таблиці стилів.

### Використання bye

bye

## Cat

Вивести результат виразу xpath відносно поточного вузла.

### Використання Cat

Використання: cat <XPATH> (для перегляду змінної або параметра)
Використання: cat $<QNAME>

## Cd

Змінює шлях, вказаний xpath.

### Використання cd

<< = попередній-елемент::node()
>> = наступний-елемент::node()
<- = предок::взузол()
-> = наступник::вузол()

## Chdir

Змінити робочий каталог

### Використання chdir

chdir <ШЛЯХ> (відносний або абсолютний шлях у операційній системі)

## Continue

Продовжити виконання таблиці стилів з зупинками на всіх точках зупину.

Скорочення: c

### Використання Continue

continue

## Data

Перемкнутися на показ поточного вузла у даних xml або зміна використаних даних xml

### Використання Data

data (перемкнутися на поточний вузол документа.)
data <ДАНІ> (Змінити поточний файл даних xml на новий. Префікс `~` буде замінено на значення змінної середовища $HOME. Для обробки файла вам слід скористатися командою run)

## Delete

Вилучити точку зупину шаблону

Скорочення: d

### Використання Delete

delete (Вилучити точку зупину на поточному вузлі)
delete <ІДЕНТИФІКАТОР_ТОЧКИ_ЗУПИНУ> (Вилучити точку зупину з вказаним номером)
delete -l <НАЗВА_ФАЙЛА> <НОМЕР_РЯДКА> (Вилучити точку зупину у вказаному рядку вказаного файла)
delete -l <URI> <НОМЕР_РЯДКА> (Вилучити точку зупину у вказаному рядку вказаної адреси URI)
delete <НАЗВА_ШАБЛОНУ> (Вилучити точку зупину у вказаному шаблоні.)
delete * (Вилучити всі точки зупину.)

## Delparam

Вилучити параметр libxslt

### Використання Delparam

delparam (вилучити всі наявні параметри)
delparam <ІДЕНТИФІКАТОР_ПАРАМЕТРА>
delparam <НАЗВА_ПАРАМЕТРА>

## Delwatch

Вилучити вираз, за яким ведеться спостереження, або вилучити всі вирази, за якими ведеться спостереження, і які можна преглянути за допомогою команди "showwatch".

### Використання delwatch

delwatch <ІДЕНТИФІКАТОР_ВИРАЗУ> (Вилучити вираз, за яким ведеться спостереження, з вказаним ідентифікатором)
delwatch * (вилучити всі вирази для перегляду)

## Dir

Вивести список вузлів у спосіб, подібних до команди оболонки dir.

### Використання Dir

dir

## Disable

Вимкнути точку зупину

### Використання Disable

disable (для вимикання точки зупину на поточному вузлі)
disable <ІДЕНТИФІКАТОР_ТОЧКИ_ЗУПИНУ> (Вимкнути точку зупину з вказаним номером)
disable -l <НАЗВА_ФАЙЛА> <НОМЕР_РЯДКА> (Вимкнути точку зупину у вказаному рядку вказаного файла)
disable -l <URI> <НОМЕР_РЯДКА> (Вимкнути точку зупину у вказаному рядку вказаної адреси URI)

## Du

Вивести перелік дочірніх вузлів у ієрархічному (деревоподібному) форматі.

### Використання Du

du

## Dump

Створити дамп з подробицяи щодо цього вузла

### Використання Dump

dump

## Enable

Вмикає або вимикає точку зупину (Перемикає значення увімкнути/вимкнути)

Скорочення: e

### Використання enable

enable (Увімкнути/Вимкнути точку зупину на поточному вузлі)
enable <ІДЕНТИФІКАТОР_ТОЧКИ_ЗУПИНУ> (Увімнути/Вимкнути точку зупину з вказаним номером
enable -l <НАЗВА_ФАЙЛА> <НОМЕР_РЯДКА> (Увімкнути/Вимкнути точку зупину у вказаному рядку вказаного файла)
enable -l <URI> <НОМЕР_РЯДКА> (Увімкнути/Вимкнути точку зупину у вказаному рядку вказаної адреси URI)

## Entities

Вивести список зовнішніх елементів обробки, які використовують файл даних (документ)

Скорочення: ent

### Використання Entities

entities

## Exit

Якомога швидше перервати обробку поточної таблиці стилів.

### Використання Exit

exit

## Frame

Вивести стек блоків на вказану глибину

Скорочення: f

### Використання Frame

frame <ГЛИБИНА> (Глибиною є число у межах від 0 до поточної глибини стеку викликів)

## Free

Спорожнити таблицю стилів і дані (вимкнено, див. run)

### Використання Free

free

## Globals

Вивести список загальних змінних або параметрів таблиці стилів. Вивести значення загальної змінної.

### Використання Globals

globals (Вивести список всіх доступних глобально змінних)
globals -f (Вивести список всіх доступних глобально змінних та їх значення)
globals <QNAME> (Вивести значення вказаної змінної)

## Help

Виводить довідку щодо команди або загальний опис

Скорочення: h

### Використання help

help (Показати короткий огляд продукту)
help <КОМАНДА> (Показати довідку щодо команди)

## Load

Завантажити параметри і налаштування користувача xsldbg з диску

### Використання load

load

## Locals

Вивести список локальних змінних або параметрів таблиці стилів. Вивести значення локальної змінної.

### Використання Locals

locals (Вивести список всіх доступних локально змінних)
locals -f (Вивести список всіх локальних змінних з їх значеннями)
locals <QNAME> (Вивести значення вказаної змінної)

## Ls

Виводить список вузлів у скороченому форматі

### Використання ls

ls

## Next

Пропустити xsl:call-template або xsl:apply-templates. Ця команда виконує ті самі дії, що і послідовне виконання команд "step" і "up"

Скорочення: n

### Використання next

next (перейти до наступної інструкції того ж рівня)

## Options

Вивести значення параметрів xsldbg

### Використання Options

options

## Output

Визначити локальний, придатний для запису файл для виведення результатів.

Скорочення: o

### Використання Output

output <НАЗВА_ФАЙЛА> (Назва локального придатного для запису файла. На платформах *nix і CYGWIN можна скористатися префіксом "~". У RISC OS можна використовувати змінні середовища)
output <URI> (Адресу <URI> можна вказувати лише у відповідності до протоколу "file://". Цю адресу буде перетворено на назву файла, яка відповідає параметрам операційної системи)
output - (Надіслати вивід у стандартний вивід системи. Слід використовувати лише, якщо ви використовуєте командний рядок xsldbg)

## Public

Вивести значення, яке публічний ідентифікатор відображає через поточний каталог.

Скорочення: pub

### Використання public

public "<Публічний_ідентифікатор>"

## Pwd

Виводить назву поточного робочого каталогу.

### Використання pwd

pwd

## Quit

Якомога швидше перервати обробку поточної таблиці стилів.

Скорочення: q

### Використання Quit

quit

## Readconfig

Прочитати налаштування xsldbg з файла параметрів, збереженого на диску.

### Використання readconfig

readconfig

## Run

Перезапустити таблицю стилів.

Скорочення: r

### Використання run

run

## Save

Зберегти параметри і налаштування користувача xsldbg на диск.

### Використання Save

save

## Search

Виконати пошук у базі даних, зібраній на основі завантажених таблиць стилів.

Всі файли виводу даних зберігатимуться у каталозі, на який вказує параметр "searchresultspath", якщо його встановлено. searchresults.xml, зазвичай, буде перетворено за допомогою search.xsl, але перетворення відбуватиметься за допомогою searchhtml.xsl, якщо встановлено параметр "prefrehtml".

У разі виконання команди пошуку буде створено файл xml (searchresults.xml). Після створення цього файла ви зможете обробити його за допомогою власної таблиці стилів для представлення даних у потрібний спосіб. Якщо не буде вказано параметр "preferhtml", буде виведено для перегляду файл searchresult.txt.

Залежно від обсягу зібраних даних, виконання цієї команди може тривати досить довго.

### Використання search

search <XPATH> (Для того, щоб дізнатися про можливі варіанти xpath, перегляньте search.dtd. Типовим значенням <XPATH> є '//search/*' )
search -sort <XPATH> (Наказати search.xsl впорядкувати отримані дані перед їх виводом)

## Set

Встановити значення змінної

### Використання set

set <НАЗВА_ЗМІННОЇ> <XPATH>

## Setoption

Вказати параметр виконання таблиці стилів.

Вам слід скористатися командою run, щоб задіяти зміни.

### Використання setoption

Приклад використання: setoption net 1
Приклад використання: setoption encoding "Якесь значення кодування"
setoption <НАЗВА_ПАРАМЕТРА> (<ЧИСЛОВЕ_ЗНАЧЕННЯ> | <ЗНАЧЕННЯ_РЯДОК>)
Де <ЧИСЛОВЕ_ЗНАЧЕННЯ> є необов’язковим, його використовують для параметрів, які слід обробляти як цілі числа
Параметр <НАЗВА_ПАРАМЕТРА> може приймати значення:

debug (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> має значення true, створити дамп дерева результату)
catalogs (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, використовувати каталоги з $SGML_CATALOG_FILES або SGML$CatalogFiles для операційних систем risc)
html (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, вхідний документ є файлом HTML)
docbook (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true і docbook підтримується libxml, вхідним документом є файл docbook SGML)
xinclude (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, виконати обробку XInclude вхідного документа)
preferhtml (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, віддати перевагу виводу результатів пошуку у html. Див. команду search)
autoencode (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, спробувати використовувати кодування символів таблиці стилів)
utf8input (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, всі введені користувачем дані закодовано у UTF-8. Цим параметром, зазвичай, користуються, якщо xsldbg запущено у нитковому процесі)

gdb (Запустити у режимі сумісності з gdb)

Для значення 1 це означає

вивід набагато більшої кількості повідомлень. Збільшує частоту виводу повідомлень «Точка зупину у ...»
буде виведено не більше за GDB_LINES_TO_PRINT рядків під час обчислення виразів, які завершуються на "...". Щоб змінити це значення, змініть коду у options.h, типовим є значення у три рядки тексту.
за використання команди "locals" буде виведено локальні і загальні змінні
під час виводу виразів за допомогою cat/print обчислене значення виглядатиме як "= " < ВИРАЗ >

Для значення 2 це означає

вивід повідомлень потрібних KDbg, а також стану виводу, описаного вище (за значення 1)

net (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, отримати файли DTD або елементи мережею)
valid (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, виконати фазу завантаження DTD)
repeat (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> більший за нуль (0), виконати перетворення <ЧИСЛОВЕ_ЗНАЧЕННЯ> разів)
profile (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, створити дамп відомостей для профілювання)
timing (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, показати використаний на обробку час)
out (Якщо параметр <ЧИСЛОВЕ_ЗНАЧЕННЯ> рівний true, створити дамп результатів)

Значення рівне true, якщо вказано слово "true" або значення НЕ рівне нулеві
Значення рівне false, якщо вказано слово "false" або значення РІВНЕ нулеві
Типово, значення рівне true, якщо не вказано його точного значення, наприклад, setoption net
Типово, значення рівне false, якщо назва параметра починається з "no", наприклад, setoption nonet
stdout Вивести всі повідомлення про помилки до stdout. Зазвичай, повідомлення про помилки надходять до stderr.
setoption <НАЗВА_ПАРАМЕТРА> "<РЯДОК_ЗНАЧЕННЯ>" (У параметрі <РЯДОК_ЗНАЧЕННЯ> не повинно бути подвійних лапок)
setoption <НАЗВА_ПАРАМЕТРА> <РЯДОК_ЗНАЧЕННЯ> (У параметрі <РЯДОК_ЗНАЧЕННЯ> не повинно бути пробілів і подвійних лапок)
Параметр <НАЗВА_ПАРАМЕТРА> може приймати значення:

data (адреса URI файла даних)
source (Адреса URI файла джерела)
output (SystemID файла виводу даних)
docspath (Шлях, за яким слід шукати документацію)
catalognames (Назви каталогів, які слід використовувати, якщо встановлено параметр catalogs. Значення буде втрачено, якщо його було встановлено до встановлення параметра catalogs)
encoding (Визначити кодування символів, яке слід використати для стандартного виводу)
searchresultspath Визначити шлях, який буде використано для зберігання результатів пошуку. Якщо такий шлях не буде встановлено, xsldbg використовуватиме шлях до таблиці стилів
cwd (Каталог, який стане поточним після виконання команди chdir)
comment (Довільний коментар щодо інструменту усування вад поточного сеансу)

## Shell

Виконати команду оболонки

### Використання shell

shell <ТЕКСТ> (<ТЕКСТ> — це текст, який буде передано операційній системі як команду для виконання)

## Showbreak

Для показу списку точок зупину шаблону.

Скорочення: show

Якщо існує режим точки зупину у шаблоні, його назву буде додано за назвою шаблона точки зупину. Приклад виводу даних:

Breakpoint 3 enabled for template :"*" in file test1.xsl : line 105
Breakpoint 2 enabled for template :"* testMode" in file test1.xsl : line 109
Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113
Загалом існує 3 точки зупину

### Використання showbreak

showbreak

## Showparam

Вивести поточні параметри libxslt

### Використання showparam

showparam

## Showwatch

Показати поточний вираз, який переглядається

Скорочення: watches

### Використання showwatch

showwatch (Показати поточні виділені вирази для перегляду та їх значення)
showwatch 1 (Увімкнути автоматичне виведення виразів для перегляду. Це значення використовується типово.)
showwatch 0 (Вимкнути автоматичне виведення значень виразів для перегляду.)

## Source

Перемкнутися на показ поточного вузла таблиці стилів або змінити таблицю стилів, що використовується

### Використання source

source (Перемкнути на поточний вузол у таблиці стилів.)
source <ДЖЕРЕЛО> (Перемкнутися на новий файл джерела. Префікс `~` буде замінено на значення змінної середовища $HOME. Вам слід скористатися командою `run`, щоб виконати цей файл)

## Step

Виконати крок до наступної команди таблиці стилів.

Скорочення: s

### Використання step

step

## Stepdown

Перейти у новіший блок даних виклику.

Скорочення: down

### Використання stepdown

stepdown (перейти на рівень нижче блоками викликів)
stepdown <КІЛЬКІСТЬ_БЛОКІВ> (перейти на вказану кількість рівнів нижче блоками викликів)

## Stepup

Повернутися до старішого блоку викликів.

Скорочення: up

Результат виконання цієї команди не є дуже точним, xsldbg намагатиметься зупинитися якнайближче до відповідного місця.

### Використання stepup

stepup (перейти вгору на один блок викликів)
stepup <КІЛЬКІСТЬ_БЛОКІВ> (перейти вгору на вказану кількість блоків)

## Stylesheets

Виводить список завантажених таблиць стилів

Скорочення: style

### Використання stylesheets

stylesheets

## System

Вивести значення, яке відповідає файлу системи у поточному каталозі

Скорочення: sys

### Використання system

system "<Ідентифікатор_системи>"

## Templates

Виводить список можливих шаблонів. Виконує пошук шаблону

Скорочення: t

### Використання templates

templates
templates <ШАБЛОН> (Вивести подробиці щодо шаблону з назвою <ШАБЛОН>, якщо такий буде знайдено)

## Trace

Відслідкувати один сеанс виконання таблиці стилів з виводом файлів і рядків проміжних кроків.

### Використання trace

trace

## Tty

Відкрити термінал. Встановити рівень переспрямування tty.

### Використання tty

tty <ШЛЯХ_ПРИСТРОЮ> (Де <ШЛЯХ_ПРИСТРОЮ> є коректною назвою термінала у операційній системі. Просто намагається відкрити термінал

tty <РІВЕНЬ_TTY> (Встановити рівень переспрямування tty, де <РІВЕНЬ_TTY> має бути коректним рівнем вводу/виводу, який і слід використовувати)

Можливими значеннями рівня є
0 = Типове джерело вводу/виводу
1 = Виведення до термінала результатів перетворення, з покроковим виконанням і переходом (Типовий стан, коли пристрій tty було відкрито. Ще не повністю реалізовано.)
2 = Повне переспрямування у термінал (Ще не реалізовано.)
Всі інші цілочисельні значення типово мають середнє значення 0

## Validate

Перевірити виведений файл, створений таблицею стилів (вимкнено)

### Використання validate

validate

## Walk

Перехід кодом з різними швидкостями

### Використання walk

walk <ШВИДКІСТЬ> (Скористайтеся комбінацією клавіш Ctrl-C для зупинки виконання, <ШВИДКІСТЬ> є значенням між 0 і 9. Значення 0 означає повну зупинку, 1 — дуже швидке виконання, 9 — дуже повільне)

## Where

Вивести послідовність виклику шаблонів (стек блоків) і робочий каталог.

Скорочення: w

### Використання where

where

## Write

Буде завершено

### Використання write

write

## Writeconfig

Записати налаштування xsldbg з параметрів, збережених на диску.

### Використання writeconfig

writeconfig