Guida ai comandi
Addparam
Aggiunge un parametro libxslt ; equivalente a fornire --param <QNAME>:<XPATH> attraverso la riga di comando.
Uso di addparam
addparam <QNAME> <XPATH> (Lo <XPATH> non deve contenere alcuno spazio né virgolette doppie.)
addparam <QNAME> "<XPATH>" (Non deve contenere virgolette doppie in <XPATH>)
Addwatch
Aggiunge un'espressione da osservare. Vedi showwatch per i valori di osservazione
Nome scorciatoia: watch
Uso di addwatch
addwatch <XPATH>
Base
Stampa l'indirizzo base per questo nodo
Break
Interrompe su un template, alla posizione di un foglio di stile o ad un file xml caricato da xsldbg, o al nodo corrente. È un comando introdotto in xsldbg 3.1.4: Quando si è in modalità compatibile con gdb i punti di interruzione rimasti orfani possono essere impostati per un file ed un numero di riga specificati ed essere risolti ad un punto effettivo più tardi.
Nome scorciatoia: bxsldbg cercherà di indovinare l'URL completo a partire dal nome del file senza il percorso specificato
nome del file nella stessa directory del foglio di stile principale caricato
nome del file relativo alla directory di lavoro corrente di xsldbg
Cioè se hai caricato il foglio stile ../en/xsldoc.xsl, puoi fare questo: break -l xsldoc.xsl 26 Questo comando troverà corrispondenze con template di QNAME parziali completi e/o nomi di modi forniti. Ad esempio template
corrisponderà con successo ad ogni QNAME che ha come parte locale template
Uno spazio dei nomi fornito in QNAME sarà espanso come specificato dagli spazi dei nomi definiti nel file sorgente XSL. Ad es. xsl:test1 sarà espanso come http://www.w3.org/199/XSL/Transform:test1 Un punto di interruzione richiesto può essere risolto come l'URL associato e il numero di riga. Ciò è fatto automaticamente dopo che il primo template è stato visto da xsldbg. I punti di interruzione sono ri-convalidati poco dopo l'avvio di ogni esecuzione. La convalida automatica dei punti di interruzione è usata quando è in uso la modalità gdb – il comportamento predefinito di xsldbg
Uso di break
break -l <NOMEFILE> <NUMRIGA> (Per impostare un breakpoint sul file e numero di riga specificati)
break -l <URI> <NUMRIGA> (Per impostare un breakpoint sull'URI e numero di riga specificati)
break <NOME_TEMPLATE> (Per interrompere sul template indicato o corrispondente.)
break <NOME_TEMPLATE> <NOME_MODO> (Per interrompere sul template indicato con la modalità data.)>
break "" <NOME_MODO> (Per arrestarsi su un template qualsiasi che ha un dato nome)
break * (Per arrestarsi quando si incontra un template qualsiasi.)
break \* (Per arrestarsi al template "*". Altri nomi che includono '*' non verranno trattati in modo speciale.)
break (Per inserire un punto di arresto sul nodo corrente. Include nodi dati xml!)
Bye
Esce dal processamento del foglio di stile il più presto possibile.
Cat
Stampa il risultato di un'espressione xpath nella modalità relativa corrente.
Uso di cat
Uso : cat <XPATH> (Per vedere una variabile o un parametro)
Uso : cat $<QNAME>
Cd
Cambia il percorso a quello specificato da un xpath.
Uso di cd
<< = preceding-sibling::node()
>> = following-sibling::node()
<- = ancestor::node()
-> = decendant::node()
Chdir
Cambia la cartella di lavoro
Uso di chdir
chdir <PATH> (Un percorso relativo o assoluto del sistema operativo)
Continue
Continua ad eseguire un foglio di stile, fermandosi su ogni breakpoint trovato.
Nome scorciatoia: c
Data
Commuta sulla visualizzazione del nodo corrente dei dati xml. Oppure cambia i dati xml da usare
Uso di data
data (Va al nodo corrente del documento.)
data <DATA> (Per usare un nuovo file di dati xml. Un ~ iniziale è sostituito dal valore della variabile di ambiente $HOME. Sarà necessario usare il comando run
per processarlo)
Delete
Elimina il punto di interruzione di un modello
Nome scorciatoia: d
Uso di delete
delete (Per eliminare un punto di interruzione al nodo corrente)
delete <ID_BREAKPOINT> (Per eliminare il punto di interruzione al numero di interruzione specificato)
delete -l <NOMEFILE> <NUMRIGA> (Per eliminare nel file specificato, alla riga indicata)
delete -l <URI> <NUMRIGA> (Per eliminare nell'URI specificato, alla riga indicata)
delete <NOMETEMMPLATE> (Per eliminare un punto di interruzione nel template indicato)
delete * (Per eliminare tutti i punti di interruzione)
Delparam
Elimina un parametro libxslt
Uso di delparam
delparam (Elimina tutti i parametri presenti)
delparam <ID_PARAM>
Delwatch
Elimina un'espressione di osservazione o elimina tutte le espressioni di osservazione mostrate dal comando showwatch
Uso di delwatch
delwatch <WATCHID> (Elimina un'espressione di osservazione con l'ID dato)
delwatch * (Elimina tutte le espressioni di osservazione)
Dir
Stampa una lista di nodi in modo simile al comando della shell dir.
Disable
Disabilita un breakpoint
Uso di disable
disable (Per disabilitare un punto di interruzione nel nodo corrente)
disable <ID_BREAKPOINT> (Per disabilitare un punto di interruzione col numero specificato
disable -l <FILENAME> <LINENO> (Disabilita un punto di interruzione alla riga e al file specificati)
disable -l <URI> <LINENO> (Disabilita un punto di interruzione alla riga e all'URI specificati)
Du
Stampa un riassunto dei nodi figli in un formato al albero.
Dump
Mostra tutti i dettagli del nodo
Enable
Abilita o disabilita un breakpoint (Commuta abilita/disabilita/)
Nome scorciatoia: e
Uso di enable
enable (Per abilitare/disabilitare un punto di interruzione al nodo corrente)
enable <ID_BREAKPOINT> (Per abilitare/disabilitare il punto di interruzione col numero specificato
enable -l <NOMEFILE> <NRIGA> (Abilita/disabilita un punto di interruzione per file e riga specificati)
enable -l <URI> <NRIGA> (Abilita/disabilita un punto di interruzione per URI e riga specificati)
Entities
Stampa l'elenco delle entità General Parsed usate dal file di dati (documento)
Nome scorciatoia: ent
Exit
Esce dal processamento del foglio di stile il più presto possibile.
Frame
Stampa il frame dello stack alla profondità indicata
Nome scorciatoia: f
Uso di frame
frame <PROFONDITÀ_FRAME> (La profondità è un numero da 0 alla profondità attuale dello stack delle chiamate)
Free
Libera il foglio di stile ed i dati (Disabilitato, vedi run)
Globals
Stampa un elenco delle variabili o dei parametri globali del foglio di stile. Stampa il valore di una variabile globale
Uso di globals
globals (Stampa un elenco di tutte le variabili globali disponibili)
globals -f (Stampa un elenco di tutte le variabili globali disponibili ed i loro valori)
globals <NOMEQ> (Stampa il valore della variabile specificata)
Help
Mostra l'aiuto su un comando o una breve introduzione
Nome scorciatoia: h
Uso di help
help (Mostra l'introduzione del prodotto)
help <COMMAND> (Mostra l'aiuto del comando)
Load
Carica le opzioni di xsldbg e le preferenze utente dal disco
Locals
Stampa una lista di variabili o parametri di un foglio di stile locale. Stampa il valore di una variabile locale
Uso di locals
locals (Stampa l'elenco di tutte le variabili locali disponibili)
locals -f (Stampa l'elenco di tutte le variabili locali disponibili ed i loro valori)
locals <NOMEQ> (Stampa il valore della variabile specificata)
Ls
Elenca i nodi in un formato breve
Next
Salta oltre un xsl:call-template o xsl:apply-templates. Ha lo stesso effetto dell'esecuzione del comando "step" seguito da "up"
Nome scorciatoia: n
Uso di next
next (procede alla successiva istruzione allo stesso livello)
Options
Stampa i valori delle opzioni di xsldbg
Output
Specifica un file locate e scrivibile da usare per l'output dei risultati
Nome scorciatoia: o
Uso di output
output <NOMEFILE> (Un nome di file su cui è permesso scrivere. Può avere un prefisso "~" sulle piattaforme *nix e CYGWIN, o può avere variabili di ambiente in RISC OS)
output <URI> (L'<URI> può usare solo il protocollo "file://". È convertito al nome di un file adatto al sistema operativo)
output - (invia all'output standard. Può essere usato solo al prompt dei comandi di xsldbg)
Public
Stampa il valore associato ad un ID pubblico attraverso li catalogo corrente
Nome scorciatoia: pub
Uso di public
public "<IDPubblico>"
Pwd
Stampa la cartella di lavoro corrente.
Quit
Esce dal processamento del foglio di stile il più presto possibile.
Nome scorciatoia: q
Run
Riavvia il foglio di stile.
Nome scorciatoia: r
Save
Salva le opzioni di xsldbg e le preferenze utente sul disco
Search
Cerca in una banca dati di informazioni raccolte dai fogli di stile caricati
tutti i file di output sono scritti sul percorso specificato da "searchresultspath", se l'opzione è specificata, o nella stessa directory del foglio di stile fornito. searchresults.xml è normalmente trasformato da search.xsl, ma sarà trasformato da seachhtml.xsl se l'opzione "preferhtml" è impostata. Quando viene eseguito il comando di ricerca, sarà creato un file xml (searchresults.xml). Potrai quindi elaborare questo file con un tuo foglio di stile per presentare i dati in altri modi. Se l'opzione "preferhtml" non è impostata, verrà stampato sullo schermo searchresult.txt A seconda della quantità di dati raccolti, il completamento di questo comando può richiedere parecchio tempo.
Uso di search
search <XPATH> (Per vedere quale xpath può essere usato, vedi search.dtd. L'<XPATH> predefinito è '//search/*' )
search -sort <XPATH> (Indica a search.xsl di ordinare i risultati prima di emetterli)
Set
Imposta il valore di una variabile
Uso di set
set <NOME_VARIABILE> <XPATH>
Setoption
Imposta una opzione per l'esecuzione di un foglio di stile
Dovrai usare il comando run per attivare le modifiche
Uso di setoption
setoption <NOME_OPZIONE> <VALORE_INTERO>
Dove <NOME_OPZIONE> può essere
debug (Se <VALORE_INTERO> vale true mostra l'intero albero del risultato)
catalogs (Se <VALORE_INTERO> vale true usa i cataloghi da $SGML_CATALOG_FILES o SGML$CatalogFiles per il sistema operativo RISC)
html (Se <VALORE_INTERO> vale true il documento in ingresso è un file HTML)
docbook (Se <VALORE_INTERO> vale true e docbook è ancora supportato da libxml il documento in ingresso è un docbook SGML)
xinclude (Se <VALORE_INTERO> vale true esegue l'elaborazione di XInclude sui documenti in ingresso)
preferhtml (Se <VALORE_INTERO> vale true viene preferita l'uscita HTML per i risultati della ricerca. Vedi il comando search)
autoencode (Se <VALORE_INTERO> vale true cerca di usare la codifica del foglio di stile)
utf8input (Se <VALORE_INTERO> vale true tutto l'input dell'utente è in UTF-8. Questo è usato normalmente quando xsldbg è eseguito come thread)
gdb (Esegui in modalità compatibile con gdb)
Il valore 1 significa
Stampa molti più messaggi. Aumenta la frequenza della stampa di "Punto di interruzione su..."
Verranno stampate al massimo GDB_LINES_TO_PRINT righe quando è valutata un'espressione, seguite da dei puntini di sospensione ("..."). Vedi options.h per cambiarne il valore, salvo modifiche saranno stampate tre righe di testo.
Stampa sia le variabili globali che le locali quando si usa il comando "locals"
Quando si stampano espressioni con cat/print, il valore valutato sarà preceduto da "= " < EXPRESSION >
Il valore 2 significa Stampa i messaggi necessari a KDbg oltre allo stati dell'output di cui sopra (quando il valore è 1)
nonet (Se <VALORE_INTERO> vale true rifiuta di prelevare DTD o entità dalla rete)
novalid (Se <VALORE_INTERO> vale true salta la fase di caricamento del DTD)
repeat (Se <VALORE_INTERO> vale true esegue la trasformazione 20 volte)
profile (Se <VALORE_INTERO> vale true stampa le informazioni di profilazione)
timing (Se <VALORE_INTERO> vale true stampa il tempo usato)
noout (Se <VALORE_INTERO> vale true non viene stampato il risultato)
Dove il valore è true se non è uguale a zero
Dove il valore è false se è uguale a zero
stdout Stampa tutti i messaggi di errore su stdout. Normalmente i messaggi di errore vanno a stderr.
setoption <NOME_OPZIONE> "<VALORE_STRINGA>" (Non deve contenere virgolette doppie in <VALORE_STRINGA>)
setoption <NOME_OPZIONE> <VALORE_STRINGA> (Non deve contenere spazi né virgolette doppie in <VALORE_STRINGA>)
Dove <NOME_OPZIONE> può essere
data (URI del file di dati)
source (URI del file sorgente)
output (SystemID del file in uscita)
docspath (Percorso da usare per la ricerca della documentazione)
catalognames (I nomi dei cataloghi da usare quando è impostata l'opzione dei cataloghi. Il valore andrà perduto se l'impostazione è effettuata prima dell'opzione dei cataloghi)
encoding (Quale codifica usare per l'output standard)
searchresultspath Quale percorso usare per memorizzare i risultati della ricerca. Se non è impostata, xsldbg userà il percorso del foglio di stile
Shell
Esegue comandi della shell
Uso di shell
shell <TESTO> (<TESTO> è il testo da passare al sistema operativo per l'esecuzione)
Showbreak
Per mostrare un elenco dei punti di interruzione
Nome scorciatoia: showSe esiste un modo sul punto di interruzione di un template, verrà inserito in fondo al nome del template del punto di interruzione. Un esempio dell'uscita è:
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
Total of 3 breakpoints present
Uso di showbreak
showbreak
Showparam
Stampa i parametri libxslt presenti
Uso di showparam
showparam
Showwatch
Mostra l'espressione corrente sotto osservazione
Nome scorciatoia: watches
Uso di showwatch
showwatch (Mostra le espressioni sotto osservazione attualmente selezionate ed i loro valori)
showwatch 1 (Abilita la stampa automatica delle espressioni sotto osservazione. È la modalità predefinita)
showwatch 0 (Disabilita la stampa automatica delle espressioni sotto osservazione)
Source
Passa a mostrare il nodo corrente del foglio di stile. Oppure cambia il foglio di stile da usare
Uso di source
source (Va al nodo corrente del foglio stile)
source <SORGENTE> (Per cambiare file sorgente. Un "~" iniziale è sostituito dal valore della variabile di ambiente $HOME. È necessario usare il comando "run" per eseguire la modifica)
Step
Passa alla prossima istruzione del foglio di stile.
Nome scorciatoia: s
Stepdown
Discende ad un nuovo "frame di chiamata"
Nome scorciatoia: down
Uso di stepdown
stepdown (discende di un frame)
stepdown <NUMERO_DI_FRAME> (discende nello stack del numero di frame specificato)
Stepup
Risale ad un "frame di chiamata" più vecchio.
Nome scorciatoia: upQuesto non è un comando accurato, xsldbg cercherà di fermarsi il più vicino possibile.
Uso di stepup
stepup (risale di un frame)
stepup <NUMERO_DI_FRAME> (risale del numero di frame specificati)
Stylesheets
Stampa una lista di fogli di stile caricati
Nome scorciatoia: style
Uso di stylesheets
stylesheets
System
Stampa il valore associato ad un file di sistema attraverso il catalogo corrente
Nome scorciatoia: sys
Uso di system
system "<IDSistema>"
Templates
Stampa una lista di template disponibili. Cerca un template
Nome scorciatoia: t
Uso di templates
templates
templates <TEMPLATE> (Stampa i dettagli di un template chiamato <TEMPLATE> se è presente)
Trace
Esegue il trace dell'esecuzione del foglio di stile stampando il file e le righe dei passi intermedi
Tty
Apre un terminale. Imposta il livello di redirezione tty.
Uso di tty
tty <PERCORSO_DISPOSITIVO> (Dove <PERCORSO_DISPOSITIVO> è un terminale valido del sistema operativo. Prova soltanto ad aprire il terminale
tty <LIVELLO_TTY> (Imposta il livello di ridirezione su tty, dove <LIVELLO_TTY> è un livello valido di input/output da usare)
Dove livello è
0 = Input/output predefiniti
1 = uscita su terminale del risultato della trasformazione, dei trace e dell'esecuzione passo-passo (Stato predefinito quando il dispositivo tty device è stato aperto. Non ancora completamente implementato.)
2 = Redirezione completa al terminale (Non ancora implementato.)
Tutti gli altri valori interi sono interpretati come livello 0
Validate
Convalida il file di output generato dal foglio di stile (disabilitato)
Walk
Esegue passo a passo il codice usando una gamma di velocità
Uso di walk
walk <VELOCITÀ> (Usa &Ctrl;-c per interrompere l'esecuzione, <VELOCITÀ> è un valore tra 0 e 9, dove 0 significa fermo, 1 molto veloce e 9 molto lento)
Where
Stampa la sequenza delle chiamate ai template (lo stack frame) e stampa la directory attuale.
Nome scorciatoia: w
Write
Da completare