# Kommandoreference

## Tilføjparam

Tilføj en libxslt-parameter. Svarer til at bruge --param <QNAME>:<XPATH> på kommandolinjen.

At bruge Tilføjparam

tilføjparam <QNAME> <XPATH> (<XPATH> må ikke indeholde mellemrum eller dobbelte anførselstegn.)
tilføjparam<QNAME> "<XPATH>" (Må ikke indeholde dobbelte anførselstegn i <XPATH>)

## Tilføjovervågning

Tilføj et udtryk der skal overvåges. Se på visovervågning virker for at vise overvågningsværdier.

Genvejsnavn: overvåg

At bruge tilføjovervågning

tilføjovervågning <XPATH>

## Basis

Udskriv denne knudes base

Brug af base

base

## Afbryd

Afbryd ved en skabelon, på et sted i et stilark eller en xml-fil indlæst af xsldbg eller i den aktuelle knude. Nyt i xsldbg 3.1.4: Når du er i gdb-kompatibilitetstilstand kan forældreløse stoppunkter sættes i en bestemt fil og linjenummer og ændre til en aktiv senere.

Genvejsnavn: b

Xsldbg forsøger at gætte at gætte den fuldstændiga URL givet et

filnavn uden angiven søgesti
et filnavn i samme mappe som "øverste" skabelon som blev indlæst
et filnavn relativt til xsldbgs nuværende arbejdsmappe

Hvis du altså har indlæst en stilskabelonfil fra ../en/xsldoc.xsl kan du gøre dette.

break -l xsldoc.xsl 26

Denne kommando matcher en partiel eller fuldstændig QNAME-skabelon og/eller tilstandsnavn som angives. For eksempel matcher "skabelon" et hvilket som helst QNAME med en lokal del af "skabelon".

Alle navnerum i angivet QNAME expanderes som angives af navnerumerna definerede i XSL-kildekodsfilen, t.ex. expanderes "xsl:test1" til "http://www.w3.org/199/XSL/Transform:test1"

En ønsket stoppunkt skal først løses op i dens tilhørende URL og linjenummer- Dette gøres automatisk efter den første skabelon er set af xsldbg. Stoppunkter valideres igen, et kort stykke tid efter hvert kørselsstart.

Automatisk stoppunktsvalidering bruges når gdb-tilstand er aktiveret, standardopførselen i xsldbg.

Anvendelse af break

break -l <FILENAME> <LINENO> (For at sætte et stoppunkt i en angivet fil, på et givet linjenummer)
break -l <URL> <LINENO> (For at sætte et stoppunkt i en angivet URL, på et angivet linjenummer)
break <TEMPLATE_NAME> (For at afbryde i en navngiven eller matchende skabelon.)
break <TEMPLATE_NAME> <MODE_NAME> (For at afbryde i en navngiven skabelon med givet tilstand.) >
break "" <MODE_NAME> (For at afbryde i alle skabeloner som har et givet tilstandsnavn)
break * (For at afbryde i alle fundne skabeloner.)
break \* (For at afbryde i skabelon "*". Andre navn som indeholder '*' behandles ikke specielt.)
break (For at sætte et stoppunkt i nuværende knudepunkt. Ja, det omfatter XML-dataknudepunkter.)

## Bye

Afslut behandling af stilark så snart som muligt.

Brug af Bye

farvel

## cat

Udskriv resultatet af et Xpath-udtryk relativt til nuværende knudepunkt.

Brug af cat

Anvendelse: cat <XPATH> (For at vise en variabel eller parameter)
Anvendelse : cat $<QNAME>

## cd

Skift til søgestien som angives af en Xpath.

Brug af cd

<< = forudgående-søsken::knude()
>> = efterfølgende-søsken::knude()
<- = forfader::knude()
-> = efterkommer::knude()

## chdir

Ændr arbejdsmappen

Brug af chdir

chdir <STI> (En relativ eller absolut søgesti i operativsystemet)

## Fortsæt

Fortsæt med at køre stilarket og stop ved eventuelle stoppunkter.

Genvejsnavn: c

Bruge af continue

fortsætte

## Data

Skift til visning af det nuværende knudepunkt i XML-data, eller ændr de anvendte XML-data.

Dataanvendelse

data (Skift til nuværende dokumentknudepunkt.)
data <DATA> (For at skifte til en ny XML-datafil. Et indledende "~" erstattes af værdien i miljøvariablen $HOME. Kommandoen "run" behøves for at kunne behandle det)

## Slet

Slet et skabelon-stoppunkt.

Genvejsnavn: d

Anvendelse af Delete

delete (For at fjerne stoppunktet i det nuværende knudepunkt)
delete <STOPPUNKT_ID> (For at fjerne stoppunktet med angivet stoppunktsnummer)
delete -l <FILENAME> <LINENO> (Fjern i angivet fil, på linjenummer)
delete -l <URL> <LINENO> (Fjern i angiven URL, på linjenummer)
delete <SKABELONNAVN> (For at fjerne stoppunktet i navngiven skabelon.)
delete * (For at fjerne alle stoppunkter.)

## Sletparam

Slet en libxslt-parameter

Brug af sletparam

delparam (Slet alle eksisterendeparametre)
delparam <PARAM_ID>

## Sletovervåg

Slet et overvågningsudtryk, eller fjern alle overvågningsudtryk som vises af kommandoen "showwatch".

Brug af sletovervåg

delwatch <OVERVÅGNINGS_ID> (Slet et overvågningsudtryk med given identifikation)
delwatch * (Slet alle overvågningsudtryk)

## Dir

Udskriv en liste af knudepunkter på samme måde som en dir skalkommando.

Anvendelse af Dir

dir

## Deaktivér

Deaktivér et stoppunkt

Anvendelse af Disable

disable (For at deaktivere stoppunktet i det aktuelle knudepunkt)
disable <STOPPUNKT_ID> (For at deaktivere stoppunktet med angivet stoppunktsnummer)
disable -l <FILENAME> <LINENO> (Deaktivér stoppunkt i angivet fil, på angivet linjenummer)
disable -l <URI> <LINENO> (Deaktivér stoppunkt i angivet URI, på angivet linjenummernummer)

## du

Udskriv en oversigt af underliggende knudepunkter i træformat.

Brug af du

du

## Dump

Dump detaljeret information om dette knudepunkt

Anvendelse af Dump

dump

## Aktivér

Aktivér eller deaktivér et stoppunkt (skifter mellem aktiv/inaktiv)

Genvejsnavn: e

Anvendelse af Enable

enable (For at aktivere eller deaktivere stoppunktet i det aktuelle knudepunkt)
enable <STOPPUNKT_ID> (For at aktivere eller deaktivere stoppunktet med angivet stoppunktsnummer)
enable -l <FILENAME> <LINENO> (Aktivér eller deaktivér stoppunkt i angiven fil, på angivet linjenummer)
enable -l <URI> <LINENO> (Aktivér eller deaktivér stoppunkt i angiven URI, på angivet linjenummer)

## Entiteter

Udskriv liste med eksterne Generelle fortolkede entiteter der bruges i datafilen (dokument).

Genvejsnavn: ent

Anvendelse af Entities

entiteter

## Afslut

Afslut behandling af stilark så snart som muligt.

Anvendelse af Exit

afslutte

## Ramme

Udskriv stakrammen ved en given dybde

Genvejsnavn: f

Anvendelse af Frame

frame <RAMME_DYBDE> (Dybde er et tal fra 0 til kaldstakkens aktuelle dybde)

## Ledig

Frigør stilark og data (deaktiveret, se run).

Anvendelse af Free

fri

## Globale

Udskriv en liste af globale stilarkvariable eller parametre. Udskriv værdien på en global variabel.

Anvendnelse af Globals

globals (Udskriv liste med alle globalt tilgængelige variabler)
globals -f (Udskriv liste med alle globalt tilgængelige variabler og deres værdier)
globals <QNAME> (Udskriv værdien på variablen som angives)

## Hjælp

Vis hjælp om kommando eller oversigt

Genvejsnavn: h

Brug af hjælp

help (Vis oversigt over produktet)
help <KOMMANDO> (Vis hjælp om en kommando)

## Indlæs

Indlæs xsldbgs indstillinger og brugerens tilvalg, fra disk.

Brug af indlæs

indlæs

## Lokale

Udskriv en en liste med lokale stilarks-variable eller parametre. Udskriv værdien på en lokal variabel.

Anvendelse af Locals

locals (Udskriv en liste med alle lokalt tilgængelige variabler)
locals -f (Udskriv en liste med alle globalt tilgængelige variabler og deres værdier)
locals <QNAME> (Udskriv værdien på variablen som angives)

## Ls

List knudepunkter i kompakt format

Anvendelse af Ls

ls

## Næste

Spring over en xsl:kald-skabelon eller xsl:anvendelses-skabeloner. Kommandoen har samme effekt som at indtaste kommandoerne "step" og derefter "up".

Genvejsnavn: n

Anvendelse af Next

next (fortsæt til næste instruktion på samme niveau)

## Tilvalg

Udskriv værdier for xsldbgs indstillinger

Anvendelse af Options

indstillinger

## Uddata

Angiv en lokal, skrivbar fil som skal bruges til udskrivning af resultater.

Genvejsnavn: o

Anvendelse af Output

output <FILENAME> (Filnavnet på en lokal skrivbar fil, som kan have præfikset "~" på Unix-lignende og CYGWIN platforme, eller miljøvariabler på RISC OS.)
output <WEBBADRESS> (<URI> må kun benytte protokollen "file://". Den konverteres sidenhen til et filnavn som passer til operativsystemet)
output - (Send til stdout. Skal kun bruges når xsldbgs kommandoprompt benyttes)

## Public

Udskriv værdien som et offentligt ID afbilder via den aktuelle mappe

Genvejsnavn: pub

Anvendelse af Public

public "<PublikID>"

## pwd

Udskriv den aktuelle arbejdsmappe.

Brug af pwd

pwd

## Afslut

Afslut behandling af stilark så snart som muligt.

Genvejsnavn: q

Brug af afslut

afslut

## Run

Genstart stilarket.

Genvejsnavn: r

Anvendelse af Run

kør

## Gem

Gem xsldbgs tilvalg og brugerindstillinger til disken

Brug af gem

gem

## Søg

Søg i en database med al information samlet ind fra de indlæste stilark

Alle udskriftsfiler opbevares i værdien på alternativet "searchresultspath" hvis den er angivet, eller samme mappe som det tilhørende stilark. Filen searchresults.xml omdannes normalt af search.xsl, men omdannes ved hjælp af searchhtml. XSL hvis indstillingen "preferhtml" er aktiveret.

Når søgkommandoen udføres, oprettes en XML-fil (searchresults.xml). Derefter kan du behandle filen med dit eget stilark for at præsentere data på andre måder. Hvis indstillingen "preferhtml" ikke er aktiveret, udskrives searchresult.txt på skærmen.

Afhængigt af om mængden af data som indsamles, kan det tage et stykke tid udføre denne kommando.

Anvendelse af Search

search <XPATH> (Se hvilken Xpath der kan bruges. Se search.dtd. Standard er <XPATH> er '//search/*')
search -sort <XPATH> (Fortæller search.xsl at resultatet skal sorteres inden det udskrives)

## Sæt

Sæt værdien af en variabel

Sæt brug

set <VARIABEL_NAVN> <XPATH>

## indstil

Sæt en indstilling til udførsel af stilark

Du skal bruge kommandoen run for at aktivere ændringer.

Brug af indstil

indstil <OPTION_NAME> <HELTALS_VÆRDI>
Hvor <OPTION_NAME> kan være en den ene eller den anden
debug (Hvis <HELTALSVÆRDI> er sand, dumpes resultattræet i stedet)
catalogs (Hvis <HELTALSVÆRDI> er sand, benyt da mapperne fra $SGML_CATALOG_FILES eller SGML $CatalogFiles for RISC OS)
html (Hvis <HELTALSVÆRDI> er sand er inddatadokumentet en HTML-fil)
docbook (Hvis <HELTALSVÆRDI> er sand og docbook stadigvæk understøttes af libxml, er inddatadokumentet SGML-docbook)
xinclude (Hvis <HELTALSVÆRDI> er sand, udfør da Xinclude-behandling af dokumentinddata)
preferhtml (Hvis <HELTALSVÆRDI> er sand, er det foretrukne uddataformat til søgeresultaterne, HTML-udskrift)
autoencode (Hvis <HELTALSVÆRDI> er sand, forsøg da at bruge tegnsættet fra stilarket)
utf8input (Hvis <HELTALSVÆRDI> er sand, gøres al inddata fra brugeren til UTF-8. Dette bruges normalt når xsldbg kører som en tråd)
gdb (Kør i gdb-tilstand)
For værdien 1 betyder dette
Udskriv masser af beskeder. Forøg udskrivningsfrekvensen med "Breapoint at ...".
For det meste skrives GDB_LINES_TO_PRINT ud når udtryk evalueres, efterfulgt af en "...". Se options.h for at ændre værdien. Standard er tre linjer med tekst.
Både lokale og globale variabler udskrives når kommandoen "locals" udføres
Når udtryk udskrives med cat eller print, indledes den evaluerede værdi med "= " <UDTRYK>.
For værdien 2 betyder dette
Udskriv meddelelser som behøves af Kdbg samt udskriften angivet ovenover (når værdien er 1).
nonet (Hvis <HELTALSVÆRDI> er sand, nægtes hentning af DTD'er eller entiteter via netværk)
novalid (Hvis <HELTALSVÆRDI> er sand, spring over indlæsningsfasen for DTD'er)
repeat (Hvis <HELTALSVÆRDI> er sand, kør da omdannelsen 20 gange)
profile (Hvis <HELTALSVÆRDI> er sand, dump profileringsinformation)
timing (Hvis <HELTALSVÆRDI> er sand, vis anvendt tid)
noout (Hvis <HELTALSVÆRDI> er sand, dump ikke resultatet)
Når værdien er sand hvis den ikke er lig med nul
Når værdien er falsk hvis den ikke er lig med nul.
stdout Udskriv alle fejlmeddelelser til stdout. Normalt havner alle fejlmeddelelser på stdout.
setoption <OPTION_NAME> "<STRING_VALUE>" (Må ikke indeholde dobbelte citationstegn i <STRING_VALUE>)
setoption <OPTION_NAME> <STRING_VALUE> (Må hverken indeholde mellemrum eller dobbelte citationstegn i <STRING_VALUE>)
Hvor <OPTION_NAME> kan være en den ene eller den anden
data (Datafilens URI)
source (Kildekodefilens URI)
output (Udskriftsfilens SystemID)
docspath (Søgesti der skal bruges når der søges efter dokumentation)
catalognames (Navnene på mapperne der skal bruges når indstillingen catalogs er aktiveret. Værdien går tabt hvis den angives inden indstillingen catalogs)
encoding (Hvilken tegnsæt der skal bruges til standardudskriften)
searchresultspath Hvilken søgesti der skal bruges når søgeresultat gemmes. Hvis den ikke er angivet, anvender xsldbg stilarkets søgesti.

## Skal

Kør skal-kommando

Brug af skal

shell <TEXT> (<TEXT> er teksten der skal sendes til operativsystemet til udførelse)

## Showbreak

Til at vise en liste over skabelon-stoppunkter.

Genvejsnavn: vis

Hvis en tilstand findes i et skabelonstoppunkt vil den blive tilføjet i stoppunktets navns slutning. Et eksempel på udskriften er:

Stoppunkt 3 aktiveret i skabelonen :"*" i filen test1.xsl : linje 105
Stoppunkt 2 aktiveret i skabelon :"* testMode" i filen test1.xsl : linje 109
Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113
Total of 3 breakpoints present

Brug af showbreak

showbreak

## visparam

Udskriv de eksisterende libxslt-parametre

Brug af visparam

visparam

## visovervåg

Vis det aktuelle overvågede udtryk

Genvejsnavn: overvågninger

Brug af visovervåg

showwatch (Vis overvågningspunkter som er valgt og deres værdier)
showwatch 1 (Aktivér automatisk udskrivning af overvågede udtryk. Dette er standard.)
showwatch 0 (Deaktivér automatisk udskrivning af overvågede udtryk.)

## Kilde

Skift til visning af aktuel knudepunkt i stilarket, eller udskift stilarket

Brug af kilde

source (Skift til nuværende knudepunkt i stilarket.)
source <SOURCE> (For at skifte til en ny kildekodefil. Et indledende "~" erstattes af værdien på miljøvariablen $HOME. Kommandoen "run" er nødvendig for at udføre den)

## Trin

Gå til næste instruktion i stilarket.

Genvejsnavn: s

Brug af trin

trin

## Stepdown

Træd ned i en nyere "kalderamme".

Genvejsnavn: ned

Anvendelse af stepdown

stepdown (gå ind i, en stega ned en post)
stepdown <NUMBER_OF_FRAMESSTER> (gå ned et givet antal rammer)

## Træd op

Gå et trin op til en ældre "kalderamme".

Genvejsnavn: op

Dette er ikke nogen præcis kommando, xsldbg stopper så tæt på som muligt.

Brug af træd op

stepup (Gå et trin op)
stepup <NUMBER_OF_FRAMES> (gå et givet antal trin op)

## Stilark

Udskriv en liste med indlæste stilark

Genvejsnavn: stil

Brug af stilark

stilark

## System

Udskriv værdien som en systemfil afbilder via den nuværende mappe.

Genvejsnavn: sys

Brug af system

system "<SystemID>"

## Skabeloner

Udskriv en liste med tilgængelige skabeloner. Søg efter en skabelon

Genvejsnavn: t

Brug af skabeloner

skabeloner
templates <TEMPLATE> (Udskriv detaljeret information om skabelonen som hedder <TEMPLATE> hvis den kan findes)

## Spor

Spor en kørsel af stilarket, udskriv filen og linjerne af mellemliggende trin.

Brug af spor

spore

## tty

Åbn en terminalemulering. Sæt tty-omdirigeringsniveuaet.

Brug af tty

tty <DEVICE_PATH> (<DEVICE_PATH> er en gyldig terminal i operativsystemet. Forsøger kun åbne terminalen.
tty <TTY-LEVEL> (Sæt tty-omdirigeringsniveauet, hvor <TTY_LEVEL> er et gyldigt inddata/uddata-niveau at bruge.)
Hvor niveau er
0 = Standard-inddata/uddata
1 = Terminaludskrift af resultat fra transformationer, sporing og trinvis kørsel (Normaltilstand når TTY-enheden er blevet åbnet. Endnu ikke fuldstændig implementeret.)
2 = Fuldstændig omdirigering til terminalen (Endnu ikke implementeret.)
Alle andre heltalsværdier antages at betyde niveau 0

## Validér

Validerer udskriftfilen som oprettes af stilarket (deaktiveret)

Brug af validér

validér

## Gå

Gå gennem koden i forskellige hastighedsintervaller.

Brug af gå

walk <SPEED> (Brug Ctrl+C for at stoppe kørslen. <SPEED> er en værdi mellem 0 og 9, hvor 0 betyder stop, 1 er meget hurtigt og 9 er meget langsomt)

## Hvor

Udskriv en sporing af skabeloner (rammestak) og udskriv arbejdsmappen.

Genvejsnavn: w

Brug af hvor

hvor

## Skriv

Skal afsluttes

Brug af skriv

skriv