# Käskude seletused

## Addparam

Lisab libxslt parameetri; vaste käsureal --param <QNAME>:<XPATH>.

### Addparam kasutamine

addparam <QNAME> <XPATH> (<XPATH> ei tohi sisaldada tühikuid ega topeltjutumärke.)
addparam <QNAME> "<XPATH>" (<XPATH> ei tohi sisaldada topeltjutumärke)

## Addwatch

Lisab jöälgitava avaldise. Jälgimisväärtuste näitamise kohta vaata showwatch

Lühinimi: watch

### Addwatch kasutamine

addwatch <XPATH>

## Base

Näitab antud sõlme baasi

### Base kasutamine

base

## Break

Lisab katkestuse malli, laaditabeli asukohta või xsldbg laetud XML-faili või aktiivsesse sõlme. xsldbg 3.1.4 uus omadus: GDB ühilduvusrežiinmis saab määrata orvust katkestuspunktid konkreetsele failile ja reanumbrile ning lahendada hiljem.

Lühinimi: b

xsldbg üritab täieliku URL-i ära arvata järgmiste asjade põhjal:

failinimi ilma asukoha määranguta.
failinimi samas kataloogis, kus asub laetud "tipp-laaditabel".
failinimi xsldbg aktiivse töökataloogi suhtes.

S.t. kui oled laadinud laaditabelifaili ../en/xsldoc.xsl, saad seda teha

break -l xsldoc.xsl 26

See käsk sobib osalise või täieliku QNAME malliga ja/või antud režiimi nimega. Nt. "template" sobib iga QNAME-ga, mille kohalikus osas esineb "template"

Kõik nimeruumid antud QNAME nimes laiendatakse vastavalt nimeruumide definitsioonile XSL allikfailis, nt. "xsl:test1" laiendatakse "http://www.w3.org/199/XSL/Transform:test1"

Soovitud katkestuspunkt lahendatakse sellega seostatud URL-i ja reanumbri järgi. Seda tehakse automaatselt pärast seda, kui xsldbg on näinud esimest malli. Katkestuspunktid valideeritakse uuesti kohe pärast iga töötlemist.

Automaatselt valideeritakse katkestuspunkte GDB režiimi kasutamisel - mis on ka xsldbg vaikerežiim

### Break kasutamine

break -l <FAILINIMI> <REANR> (Katkestuspunkti määramiseks määratud failis, reanumbril)
break -l <URI> <REANR> (Katkestuspunkti määramiseks konkreetses URI-s, reanumbril)
break <MALLINIMI> (Nimetatud või sobiva malli katkestamiseks)
break <MALLINIMI> <REŽIIMINIMI> (Nimetatud malli katkestamiseks antud režiimis)
break "" <REŽIIMINIMI> (Suvalise antud režiiminimega malli katkestamiseks)
break * (Suvalise leitud malli katkestamiseks)
break \* (Malli "*" katkestamiseks. Muid nimesid, milles leidub '*', ei kohelda spetsiaalselt)
break (Aktiivse sõlme katkestamiseks. Jah, nende hulka kuuluvad XML-andmete sõlmed!)

## Bye

Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik.

### Bye kasutamine

bye

## Cat

Näitab XPath-avaldise tulemust aktiivse sõlme suhtes.

### Cat kasutamine

Kasutamine: cat <XPATH> (Muutuja või parameetri vaatamiseks)
Kasutamine: cat $<QNAME>

## Cd

Asukoha muutmine vastavalt XPath'i määratule.

### Cd kasutamine

<< = preceding-sibling::node()
>> = following-sibling::node()
<- = ancestor::node()
-> = decendant::node()

## Chdir

Töökataloogi muutmine

### Chdir kasutamine

chdir <ASUKOHT> (Suhteline või absoluutne asukoht operatsioonisüsteemis)

## Continue

Laaditabeli täitmise jätkamine, peatumine kõigis leitud katkestuspunktides.

Lühinimi: c

### Continue kasutamine

continue

## Data

Lülitumine XML-andmete aktiivsele sõlmele või kasutatavate XML-andmete muutmine

### Data kasutamine

data (Lülitumine dokumendi aktiivsele sõlmele)
data <ANDMED> (Lülitumiseks uuele XML-andmete failile. Alustav "~" asendatakse keskkonnamuutuja $HOME väärtusega. Vajab kasutamiseks käsku "run")

## Delete

Malli katkestuspunkti kustutamine

Lühinimi: d

### Delete kasutamine

delete (Katkestuspunkti kustutamiseks aktiivses sõlmes)
delete <KATKESTUSPUNKTI_ID> (Määratud numbriga katkestuspunkti kustutamiseks)
delete -l <FAILINIMI> <REANR> (Kustutamiseks määratud failis, reanumbril)
delete -l <URI> <REANR> (Kustutamiseks määratud URI-s, reanumbril)
delete <MALLINIMI> (Katkestuspunkti kustutamiseks nimetatud mallis)
delete * (Kõigi katkestuspunktide kustutamiseks)

## Delparam

libxslt parameetri kustutamine

### Delparam kasutamine

delparam (Kõigi olemasolevate parameetrite kustutamiseks)
delparam <PARAM_ID>

## Delwatch

Jälgimisavaldise kustutamine või kõigi jälgimisavaldiste eemaldamine, nagu näitab käsk "showwatch"

### Delwatch kasutamine

delwatch <JÄLGIJA_ID> (Antud ID-ga jälgimisavaldise kustutamiseks)
delwatch * (Kõigi jälgimisavaldiste kustutamiseks)

## Dir

Sõlmede nimekirja näitamine (sarnaneb shellikäsuga dir).

### Dir kasutamine

dir

## Disable

Katkestuspunkti keelamine

### Disable kasutamine

disable (Katkestuspunkti keelamiseks aktiivses sõlmes)
disable <KATKESTUSPUNKTI_ID> (Määratud numbriga katkestuspunkti keelamiseks)
disable -l <FAILINIMI> <REANR> (Katkestuspunkti keelamiseks määratud failis, reanumbril)
disable -l <URI> <REANR> (Katkestuspunkti keelamiseks määratud URI-s, reanumbril)

## Du

Alamsõlmede kokkuvõtte näitamine puukujuliselt.

### Du kasutamine

du

## Dump

Antud sõlme igavate üksikasjade salvestamine

### Dump kasutamine

dump

## Enable

Katkestuspunkti lubamine või keelamine (lülitamine)

Lühinimi: e

### Enable kasutamine

enable (Katkestuspunkti lubamiseks/keelamiseks aktiivses sõlmes)
akenable <KATKESTUSPUNKTI_ID> (Määratud numbriga katkestuspunkti lubamiseks/keelamiseks)
enable -l <FAILINIMI> <REANR> (Katkestuspunkti lubamiseks/keelamiseks määratud failis, reanumbril)
enable -l <URI> <REANR> (Katkestuspunkti lubamiseks/keelamiseks määratud URI-s, reanubmril)

## Entities

Andmefailis (dokumendis) kasutatud väliste üldiste olemite nimekirja näitamine

Lühinimi: ent

### Entities kasutamine

entities

## Exit

Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik.

### Exit kasutamine

exit

## Frame

Pinu raami näitamine määratud sügavusega

Lühinimi: f

### Frame kasutamine

frame <RAAMI_SÜGAVUS> (Sügavus on arv vahemikus 0 kuni väljakutsete pinu praegune sügavus)

## Free

Vaba laaditabel ja andmed (keelatud, vaata run)

### Free kasutamine

free

## Globals

Laaditabeli globaalsete muutujate või parameetrite nimekirja näitamine. Globaalse muutuja väärtuse näitamine

### Globals kasutamine

globals (Kõigi globaalsete muutujate nimekirja näitamine)
globals -f (Kõigi globaalsete muutujate ja nende väärtuste nimekirja näitamine)
globals <QNAME> (Määratud muutuja väärtuse näitamine)

## Help

Abi näitamine käsu kohta

Lühinimi: h

### Help kasutamine

help (Toote ülevaate näitamiseks)
help <KÄSK> (Abi näitamiseks käsu kohta)

## Load

xsldbg valikute ja kasutajaeelistuste laadimine kettalt

### Load kasutamine

load

## Locals

Laaditabeli kohalike muutujate või parameetrie nimekirja näitamine. Kohaliku muutuja väärtuse näitamine

### Locals kasutamine

locals (Kõigi saadaolevate kohalike muutujate nimekirja näitamine)
locals -f (Kõigi saadaolevate kohalike muutujate ja nende väärtuste nimekirja näitamine)
locals <QNAME> (Määratud muutuja väärtuse näitamine)

## Ls

Sõlmede nimekiri lühivormis

### Ls kasutamine

ls

## Next

xsl:call-template või xsl:apply-templates vahelejätmine. Sama toimega, mis käsk "step" ja seejärel "up"

Lühinimi; n

### Next kasutamine

next (Edasiliikumiseks järgmise alaminstruktsiooni juurde)

## Options

xsldbg võtme väärtuste näitamine

### Options kasutamine

options

## Output

Kohaliku kirjutamisõigusega faili määramine, mida kasutatakse tulemuste väljundina

Lühinimi: o

### Output kasutamine

output <FAILINIMI> (Kohaliku kirjutamisõigusega faili nimi. *NIX- ja CYGWIN-platvormil võib eelneda prefiks "~", RISC OS-i puhul keskkonnamuutujad)
output <URI> (<URI> saab kasutada ainult protokolli "file://" puhul. See teisendatakse siis operatsioonisüsteemile sobivale failinime kujule)
output - (Saatmine standardväljundisse. Kasutatav ainult xsldbg kasutamise korral käsurealt)

## Public

Väärtuse näitamine, mida avalik ID seostab aktiivse kataloogiga

Lühinimi: pub

### Public kasutamine

public "<PublicID>"

## Pwd

Aktiivse töökataloogi näitamine.

### Pwd kasutamine

pwd

## Quit

Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik.

Lühinimi: q

### Quit kasutamine

quit

## Run

Laaditabeli taaskäivitamine.

Lühinimi: r

### Run kasutamine

run

## Save

xsldbg valikute ja kasutajaeelistuste salvestamine kettale

### Save kasutamine

save

## Search

Andmebaasist kõigi laaditud laaditabelite kohta kogutud info otsimine

Kõik väljundfailid salvestatakse asukohta, mille väärtuse määrab võti "searchresultspath" või samassse kataloogi laaditabeliga. Faili searchresults.xml transformeerib tavaliselt search.xsl, kuid seda transformeeritakse searchhtml.xsl abil, kui kasutatakse võtit "prefrehtml".

Otsimiskäsu andmisel luuakse XML-fail searchresults.xml. Seejärel saab seda faili töödelda omaenda laaditabeliga andmete esitamiseks muul moel. Kui määratud on võti "preferhtml", näidatakse faili searchresult.txt.

Sõltuvalt kogutud andmete hulgast võib käsu töötlemine võtta päris tükk aega.

### Search kasutamine

search <XPATH> (Vaatamiseks, milline XPath on kasutusel search.dtd vaatamiseks. Vaikimisi <XPATH> on s'//search/*')
search -sort <XPATH> (Annab failile search.xsl korralduse tulemus enne esitamist sortida)

## Set

Muutuja väärtuse määramine

### Set kasutamine

set <MUUTUJA_NIMI> <XPATH>

## Setoption

Laaditabeli täitmise võtme määramine

Muudatuste aktiveerimiseks tuleb kasutada käsku run

### Setoption kasutamine

setoption <VÕTME_NIMI> <TÄISARV>
Kus <VÕTME_NIMI> võib olla

debug (Kui <TÄISARV> on tõene, salvestatakse tulemusepuu)
catalogs (Kui <TÄISARV> on tõene, kasutata katalooge asukohast õige $SGML_CATALOG_FILES või SGML $CatalogFiles RISC OS-i korral)
html (Kui <TÄISARV> on tõene, on väljunddokument HTML-fail)
docbook (Kui <TÄISARV> on tõene ja libxml toetab docbook'i, on sisenddokument SGML-docbook)
xinclude (Kui <TÄISARV> on tõene, sooritatakse sisenddokumendil XInclude töötlus)
preferhtml (Kui <TÄISARV> on tõene, eelistata otsingutulemuse korral HTML-väljundit. Vaata käsku search)
autoencode (Kui <TÄISARV> on tõene, üritatakse kasutada laaditabeli kodeeringut)
utf8input (Kui <TÄISARV> on tõene, on kogu kasutaja sisend UTF-8 kodeeringus. Seda kasutatakse tavaliselt siis, kui xsldbg käivitatakse lõimena)

gdb (Käivitatakse GDB ühilduvusrežiimis)

Väärtuse 1 korral tähendab see

Näidatakse palju rohkem teateid. Suurendab "Katkestuspunkt asukohas..." näitamise sagedust
Avaldiste hindamisel näidatakse kõige enam GDB_LINES_TO_PRINT rida, millele järgneb "..." Vaata options.h selle väärtuse muutmiseks, vaikeväärtus on kolm tekstirida
Näidatakse nii kohalikke kui globaalseid, kui antakse käsk "locals"
Avaldise näitamisel käsuga cat/print. Hinnatud väärtusele lisatakse prefiks "= " < EXPRESSION >

Väärtuse 2 korral tähendab see

Näidatakse teateid, mida vajab KDbg, samuti ülalmainitud väljundiolekut (kui väärtus on 1)

nonet (Kui <TÄISARV> on tõene, keeldutakse DTD-sid või olemeid tõmbamast võrgust)
novalid (Kui <TÄISARV> on tõene, jäetakse DTD laadimise faas vahele)
repeat (Kui <TÄISARV> on tõene, käivitatakse transformatsioon 20 korda)
profile (Kui <TÄISARV> on tõene, salvestatakse profileerimisinfo)
timing (Kui <TÄISARV> on tõene, näidatakse kulunud aega)
noout (Kui <TÄISARV> on tõene, tulemust ei salvestata)

Kus väärtus on tõene, kui see EI VÕRDU nulliga
Kus väärtus on väär, kui see VÕRDUB nulliga
stdout (Kõik veateated saadetakse standardväljundisse (stdout) tavapärase standardveaväljundi (stderr) asemel)
setoption <VÕTME_NIMI> "<STRINGI_VÄÄTUS>" (Ei tohi sisaldada topeltjutumärke <STRINGI_VÄÄRTUS> sees)
setoption <VÕTME_NIMI> <STRINGI_VÄÄTUS> (Ei tohi sisaldada tühikuid ega topeltjutumärke <STRINGI_VÄÄRTUS> sees)
Kus <VÕTME_NIMI> võib olla

data (Andmefaili URI)
source (Allikfaili URI)
output (Väljundfaili SystemID)
docspath (Dokumentatsiooni otsimisel kasutatav otsingutee)
catalognames (Kataloogide nimed, mida kasutatakse võtme catalogs määramise korral. Väärtus läheb kaotsi, kui see määratakse enne võtme catalogs määramist)
encoding (Standardväljundis kasutatav kodeering)
searchresultspath (Otsingu tulemuste salvestamisel kasutatav otsingutee. Kui on määramata, kasutab xsldbg laaditabeli otsinguteed)

## Shell

Shellikäsu käivitamine

### Shell kasutamine

shell <TEKST> (<TEKST> on operatsioonisüsteemile täitmiseks edastatav tekst)

## Showbreak

Malli katkestuspunktide näitamine.

Lühinimi: show

Kui malli katkestuspunktile on olemas režiim, siis lisatakse see mallinime järele tähistama katkestuspunkti. Väljundi näide on selline:

Katkestuspunkt 3 mallis lubatud: "*" failis test1.xsl : real 105
Katkestuspunkt 2 mallis lubatud: "* testMode" failis test1.xsl : real 109
Katkestuspunkt 1 mallis lubatud: "* http://www.w3.org/1999/XSL/Transform:testMode" failis test1.xsl : real 113
Kokku 3 katkestuspunkti

### Showbreak kasutamine

showbreak

## Showparam

Olemasolevate libxslt parameetrie näitamine

### Showparam kasutamine

showparam

## Showwatch

Jälgitava aktiivse avaldise näitamine

Lühinimi: watches

### Showwatch kasutamine

showwatch (Aktiivsete valitud jälgijate ja nende väärtuste näitamine)
showwatch 1 (Jälgimisavaldiste automaatse näitamise lubamine. See on vaikimisi sees)
showwatch 0 (Jälgimisavaldiste automaatse näitamise keelamine)

## Source

Laaditabeli aktiivse sõlme näitamise lülitamine või kasutatava laaditabeli muutmine

### Source kasutamine

source (Lülitumine laaditabeli aktiivsele sõlmele)
source <ALLIKAS> (Uuele allikfailile lülitumiseks. Alustav "~" asendatakse keskkonnamuutuja $HOME väärtusega. Vajab käivitamiseks käsku "run")

## Step

Täitmise järgmise laaditabeli instruktsioonini.

Lühinimi: s

### Step kasutamine

step

## Stepdown

Samma alla uuemasse "väljakutseraami".

Lühinimi: down

### Stepdown kasutamine

stepdown (samm üks raam allapoole)
stepdown <RAAMIDE_ARV> (samm allapoole määratud raamide arvu võrra)

## Stepup

Samm üles vanemasse "väljakutseraami".

Lühinimi: up

See ei ole täpne käsk, xsldbg peatub nii lähedal, kui võimalik.

### Stepup kasutamine

stepup (samm üks raam ülespoole)
stepup <RAAMIDE_ARV> (samm ülespoole määratud raamide arvu võrra)

## Stylesheets

Laetud laaditabelite nimekirja näitamine

Lühinimi: style

### Stylesheets kasutamine

stylesheets

## System

Väärtuse näitamine, mille süsteemne fail seostab aktiivse kataloogiga

Lühinimi: sys

### System kasutamine

system "<SystemID>"

## Templates

Saadaolevate mallide nimekirja näitamine. Malli otsimine

Lühinimi: t

### Templates kasutamine

templates
templates <MALL> (Malli nimega <MALL> üksikasjade näitamine, kui see leitakse)

## Trace

Laaditabeli täitmise jälgimine faili nime ja vahepealsete sammude ridu näidates

### Trace kasutamine

trace

## Tty

Terminali avamine. Tty ümbersuunamise taseme määramine.

### Tty kasutamine

tty <SEADME_ASUKOHT> (Kus <SEADME_ASUKOHT> on operatsioonisüsteemi kehtiv terminal. Lihtsalt püüab avada terminali)

tty <TTY_TASE> (Tty ümbersuunamise taseme määramine, kus <TTY_TASE> on kasutatava sisendi/väljundi kehtiv tase)

Kus tase on
0 = vaikimisi sisend/väljund
1 = transformeerimise, jälgimise ja läbimise tulemuste väljund terminali (Vaikeolek, kui tty-seade on avatud. Pole veel täielikult teostatud)
2 = täielik ümbersuunamine terminali (Pole veel teostatud)
Kõiki muid täisarve tõlgendatakse kui taset 0

## Validate

Laaditabeli tekitatud väljundfaili valideerimine (keelatud)

### Validate kasutamine

validate

## Walk

Koodi läbimine kiirustevahemikke kasutades

### Walk kasutamine

walk <KIIRUS> (Ctrl+C peatab täitmise, <KIIRUS> on väärtus vahemikus 0 kuni 9, kus 0 tähendab peatamist, 1 väga kiiret ja 9 väga aeglast)

## Where

Malli väljakutsete (raami pinu) jälituse ja töökataloogi näitamine.

Lühinimi: w

### Where kasutamine

where

## Write

Veel lõpetamata

### Write kasutamine

write