# 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

### Uso di base

base

## 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: b

xsldbg 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 o completi, o con il nome di modo fornito. 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.

### Uso di bye

bye

## 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

### Uso di continue

continue

## 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>
delparam <NOME_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.

### Uso di dir

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.

### Uso di du

du

## Dump

Mostra tutti i dettagli del nodo

### Uso di dump

dump

## 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

### Uso di entities

entities

## Exit

Esce dal processamento del foglio di stile il più presto possibile.

### Uso di exit

exit

## 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)

### Uso di free

free

## 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

### Uso di load

load

## 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

### Uso di ls

ls

## 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

### Uso di options

options

## 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.

### Uso di pwd

pwd

## Quit

Esce dal processamento del foglio di stile il più presto possibile.

Nome scorciatoia: q

### Uso di quit

quit

## Readconfig

Legge la configurazione di xsldbg dalle impostazioni memorizzate su disco.

### Uso di readconfig

readconfig

## Run

Riavvia il foglio di stile.

Nome scorciatoia: r

### Uso di run

run

## Save

Salva le opzioni di xsldbg e le preferenze utente sul disco

### Uso di save

save

## 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

Esempio d'uso: setoption net 1
Esempio d'uso: setoption encoding "Some encoding value"
setoption <NOME_OPZIONE> (<VALORE_INTERO> | <VALORE_STRINGA>)
Dove <VALORE_INTERO> è opzionale per le opzioni che possono essere trattate come valori interi
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)

net (Se <VALORE_INTERO> vale true preleva DTD o entità dalla rete)
valid (Se <VALORE_INTERO> vale true esegue la fase di caricamento del DTD)
repeat (Se <VALORE_INTERO> è maggiore di zero (0)esegue la trasformazione <INTEGER_VALUE> volte)
profile (Se <VALORE_INTERO> vale true stampa le informazioni di profilazione)
timing (Se <VALORE_INTERO> vale true stampa il tempo usato)
out (Se <VALORE_INTERO> vale true stampa il risultato)

Dove il valore è true se viene usata la parola «true» oppure il valore NON È uguale a zero
Dove il valore è false se viene usata la parola «false» oppure il valore È uguale a zero
Dove valore vale true se non viene specificato alcun valore; es. setoption net
Dove valore vale false se il nome dell'opzione è preceduto da «no»; es. setoption nonet
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
cwd (La directory cambiata col comando chdir.)
comment (Un commento a piacere sulla sessione di debug attuale)

## 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: show

Se 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

### Uso di step

step

## Stepdown

Scende in 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: up

Questo 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

### Uso di trace

trace

## 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)

### Uso di validate

validate

## 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

### Uso di where

where

## Write

Da completare

### Uso di write

write

## Writeconfig

Scrive la configurazione di xsldbg dalle impostazioni memorizzate su disco.

### Uso di writeconfig

writeconfig