# Referencia de comandos

## Addparam

Añade un parámetro libxslt ; equivalente a proporcionar --param <QNAME>:<XPATH> en la línea de órdenes.

## Uso de addparam

addparam <QNAME> <XPATH> (El <XPATH> no puede contener ni espacios ni comillas dobles).
addparam <QNAME> "<XPATH>" (No debe contener comillas dobles en <XPATH>)

## Addwatch

Añade un observador para una expresión. Puede dirigirse a showwatch para obtener más información sobre la muestra de valores de watch.

Nombre para acceso rápido: watch

## Uso de addwatch

addwatch <XPATH>

## Base

Imprime la base de este nodo

## Uso de base

base

## Break

Se detiene en la plantilla, en una ubicación de la hoja de estilos o en un archivo xml cargado por xsldbg, o en el nodo actual. Nuevo en xsldbg 3.1.4: en modo de compatibilidad con gdb, los puntos de interrupción huérfanos se pueden definir en un archivo específico y en un número de línea, y se puede resolver más tarde sobre uno activo.

Nombre para acceso rápido: b

xsldbg intentará averiguar la URL completa, dado un

nombre de archivo sin una ruta especificada.
un archivo del mismo directorio que la hoja de estilos cargada «superior»
un nombre de archivo relativo al directorio de trabajo actual de xsldbg

Por ejemplo, si ha cargado un archivo de hoja de estilos de ../en/xsldoc.xsl, puede hacerlo con

break -l xsldoc.xsl 26

Este comando hará coincidir con una plantilla QNAME parcial o completa y/o un nombre de modo proporcionado. Por ejemplo, «plantilla» se encajará con cualquier QNAME que tenga una parte local «template».

Cualquier espacio de nombres que haya en el QNAME que se proporciona se expandirá como se indique en los espacios de nombres que estén definidos en el archivo fuente XSL. Por ejemplo, «xsl:test1» se expandirá como «http://www.w3.org/199/XSL/Transform:test1».

Puede ser necesario que se resuelva un punto de introducción solicitado con su URL y número de línea asociados. Esto se hace automáticamente una vez que xsldbg ha visto la primera plantilla. Los puntos de interrupción se vuelven a validar poco después del comienzo de cada ejecución.

La validación automática de puntos de interrupción se usa cuando está activado el modo gdb: el comportamiento predefinido de xsldbg.

## Uso de break

break -l <FILENAME> <LINENO> (Para definir el punto de interrupción en un archivo y número de línea específicos).
break -l <URI> <LINENO> (Para definir el punto de interrupción en una URI y número de línea específicos).
break <TEMPLATE_NAME> (Para detenerse en una plantilla nombrada o que coincida con la que se indica).
break <TEMPLATE_NAME> <MODE_NAME> (Para detenerse en una plantilla en el modo indicado).>
break "" <MODE_NAME> (Para detenerse en cualquier plantilla que tenga un nombre de modo indicado).
break * (Para detenerse en cualquier plantilla que se encuentre).
break \* (Para detenerse en la plantilla «*». No se dará un trato especial a otros nombres que incluyan «*»).
break (Para poner el punto de interrupción en el nodo actual. Sí que se incluye en los nodos de datos xml.)

## Bye

Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.

## Uso de bye

bye

## Cat

Imprime el resultado de una expresión de xpath en el nodo relativo actual.

## Uso de cat

Uso: cat <XPATH> (Para ver una variable o un parámetro).
Usago: cat $<QNAME>

## Cd

Pasa a la ruta especificada en un xpath.

## Uso de cd

<< = predecesor::nodo()
>> = sucesor::nodo()
<- = antepasado::nodo()
-> = descendiente::nodo()

## Chdir

Pasa al directorio de trabajo

## Uso de chdir

chdir <PATH> (Una ruta relativa o absoluta para el sistema operativo).

## Continue

Continúa la ejecución de una hoja de estilos, deteniéndose en cualquier punto de interrupción que se encuentre.

Nombre para acceso rápido: c

## Uso de continue

continue

## Data

Pasa a mostrar el nodo actual en los datos xml. O cambia los datos xml que se usan

## Uso de data

data (Pasa al nodo del documento actual).
data <DATA> (Para pasar a un nuevo archivo de datos xml. Una «~» al comienzo se reemplaza por el valor de la variable de entorno $HOME. Se tendrá que usar el comando «run» para procesarlo).

## Delete

Elimina un punto de interrupción de la plantilla

Nombre para acceso rápido: c

## Uso de delete

delete (Para eliminar un punto de interrupción del nodo actual).
delete <ID_PUNTOINT> (Para eliminar un punto de interrupción, conocido el número específico del punto de interrupción).
delete -l <NOMBREARCH> <NUMLINEA> (Elimina el punto de interrupción del número de línea y archivo especificados).
delete -l <URI> <NUMLINEA> (Elimina el punto de interrupción del número de línea y la URI especificados).
delete <NOMBREPLANTILLA> (Para eliminar un punto de interrupción de la plantilla que se indica).
delete * (Para eliminar todos los puntos de interrupción).

## Delparam

Elimina un parámetro de libxslt

## Uso de delparam

delparam (Elimina todos los parámetros presentes).
delparam <ID_PARAM>

## Delwatch

Elimina la observación de una expresión o elimina todas las expresiones observadas que se muestran en el comando «showwatch».

## Uso de delwatch

delwatch <IDOBSERV> (Elimina la observación de una expresión, con un id. dado).
delwatch * (Elimina las observaciones de todas las variables).

## Dir

Muestra la lista de nodos de forma similar a como lo hace el comando «dir» en la shell.

## Uso de dir

dir

## Disable

Inactiva un punto de interrupción

## Uso de disable

disable (Para desactivar un punto de interrupción en el nodo actual).
disable <ID_PUNTOINT> (Para inactivar un punto de interrupción con un número específico).
disable -l <NOMBREARCH> <NUMLINEA> (Inactiva el punto de interrupción del archivo y número de línea que se indique).
disable -l <URI> <NUMLINEA> (Inactiva el punto de interrupción de la URI y el número de línea que se indique).

## Du

Muestra un resumen de los nodos hijo en formato de árbol.

## Uso de du

du

## Dump

Volcado de los detalles internos de este nodo

## Uso de dump

dump

## Enable

Activa o inactiva un punto de interrupción (alterna entre activar e inactivar).

Nombre para acceso rápido: e

## Uso de enable

enable (Para activar o inactivar un punto de interrupción en el nodo actual).
enable <ID_PUNTOINT> (Para activar o inactivar un punto de interrupción, estando especificado el número del punto).
enable -l <NOMBREARCH> <NUMLINEAO> (Activa o inactiva el punto de interrupción en el archivo y número de línea que se indica).
enable -l <URI> <NUMLINEA> (Activa o inactiva el punto de interrupción que hay en la URI y el número de línea que se indica).

## Entities

Muestra la lista de entidades externas generales analizadas que se han usado en el archivo de datos (documento).

Nombre para acceso rápido: ent

## Uso de entities

entities

## Exit

Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.

## Uso de exit

exit

## Frame

Muestra el marco de pila con la profundidad indicada.

Nombre para acceso rápido: f

## Uso de frame

frame <PROFUND_MARCO> (La profundidad es un número de 0 a la profundidad actual de la pila de llamadas).

## Free

Libera la hoja de estilos y los datos (si está inactivo, vea lo que se dice de run)

## Uso de free

free

## Globals

Muestra una lista de las variables o parámetros de la hoja de estilos globales. Muestra el valor de una variable global.

## Uso de globals

globals (Muestra la lista de todas las variables globales que hay disponibles).
globals -f (Muestra la lista de todas las variables globales que hay disponibles y de sus valores).
globals <QNOMBRE> (Muestra el valor de la variable indicada).

## Help

Muestra ayuda genérica o sobre el comando

Nombre para acceso rápido: h

## Uso de help

help (Muestra una visión general del producto).
help <COMANDO> (Muestra ayuda sobre un comando).

## Load

Carga desde disco las opciones de xsldbg y las preferencias del usuario.

## Uso de load

load

## Locals

Muestra una lista con las variables o parámetros locales de la hoja de estilos. Muestra el valor de una variable local.

## Uso de locals

locals (Muestra una lista con todas las variables disponibles localmente).
locals -f (Muestra una lista con todas las variables locales que hay disponibles y con sus valores).
locals <QNOMBRE> (Muestra el valor de la variable especificada).

## Ls

Lista de nodos en formato breve.

## Uso de ls

ls

## Next

Evita una llamada a plantilla xsl (xsl:call-template) o una aplicación de plantilla xsl (xsl:apply-templates). Este comando tiene el mismo efecto que introducir los comando «step» y luego «up».

Nombre para acceso rápido: n

## Uso de next

next (seguir a la siguiente instrucción emparentada).

## Options

Muestra los valores de las opciones de xsldbg.

## Uso de options

options

## Output

Especifica un archivo local y en el que se puede escribir, para mandar allí los resultados.

Nombre para acceso rápido: o

## Uso de output

output <NOMBREARCH> (El nombre de un archivo local en el que se puede escribir. Puede contener el prefijo «~» en las plataformas *nix y CYGWIN, o variables de entorno en RISC OS).
output <URI> (La <URI> sólo debe puede usar el protocolo «file://». Esa URI se convierte a un nombre de archivo adecuado para el sistema operativo).
output - (Envía a la salida estándar. Sólo se debe usar cuando se esté usando xsldbg desde la línea de órdenes).

## Public

Muestra el valor al que está mapeado un id. público según el catálogo actual.

Nombre para el acceso rápido: pub

## Uso de public

public "<IDPublico>"

## Pwd

Muestra el directorio de trabajo actual.

## Uso de pwd

pwd

## Quit

Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.

Nombre para acceso rápido: q

## Uso de quit

quit

## Run

Reinicia la hoja de estilos.

Nombre para acceso rápido: r

## Uso de run

run

## Save

Guarda en disco las opciones de xsldbg y las preferencias del usuario.

## Uso de save

save

## Search

Busca en una base de datos con toda la información recogida de la hojas de estilos cargadas

Todos los archivos de salida se almacenan donde indique el valor de la opción «searchresultpath», si está definida, o en el mismo directorio que la hoja de estilos. searchresults.xml se suele transformar en search.xsl, pero se transformará usando searchhtml.xsl, si está definida la opción «prefrehtml».

Cuando el comando «search» se hace funcionar, se crea un archivo (searchresults.xml). Luego puede procesar este archivo con su propia hoja de estilos para presentar los datos de otras maneras. Si no está definida la opción «preferhtml», se mostrará en pantalla «searchresult.txt».

Según la cantidad de datos que se haya recogido, puede llevar cierto tiempo la finalización de este comando.

## Uso de search

search <XPATH> (Puede ver qué xpath se puede usar en search.dtd. El <XPATH> predefinido es «//search/*».)
search -sort <XPATH> (Le dice a search.xsl que ordene el resultado antes de mostrarlo en la salida).

## Set

Define el valor de una variable.

## Uso de set

set <NOMBRE_VARIABLE> <XPATH>

## Setoption

Define una opción para la ejecución de una hoja de estilos.

Tiene que usar el comando «run» para activar los cambios.

## Uso de setoption

setoption <NOMBRE_OPCION> <VALOR_ENTERO>
Donde <NOMBRE_OPCION> puede ser o bien

debug (Si <VALOR_ENTERO> es cierto, se vuelca el árbol del resultado en su lugar).
catalogs (Si <VALOR_ENTERO> es cierto, usa los catálogos de $SGML_CATALOG_FILES o SGML$CatalogFiles para el sistema operativo risc).
html (Si <VALOR_ENTERO> es cierto, el documento de entrada es un archivo HTML).
docbook (Si <VALOR_ENTERO> es cierto y la biblioteca libxml lo admite, el documento de entrada en un docbook de SGML).
xinclude (Si <VALOR_ENTERO> es cierto, usa el procesamiento XInclude para el documento input).
preferhtml (Si <VALOR_ENTERO> es cierto, se prefiere la salida html para los resultados de «search». : Puede ver el comando «search»).
autoencode (Si <VALOR_ENTERO> es cierto, se intenta usar la codificación de la hoja de estilos.)
utf8input (Si <VALOR_ENTERO> es cierto, toda la salida del usuario se hace en UTF-8. Se suele usar cuando xsldbg se hace funcionar como hilo).
gdb (Ejecuta gdb en modo de compatibilidad).

Para un valor de 1, significa

Mostrar muchos más mensajes. Aumenta la frecuencia, mostrando «Punto de interrupción en...»
En la mayoría de líneas de GDB_LINES_TO_PRINT se mostrarán cuando se estén evaluando expresiones, seguidas de «...». Puede cambiar este valor en options.h. De forma predefinida, son tres líneas de texto.
Tanto las locales como las globales se mostrarán cuando se haga funcionar el comando «locals».
Al mostrar las expresiones con cat/print. El valor evaluado se precederá con «= » < EXPRESION >

Para un valor de 2, significa

Mostrar los mensajes que necesite KDbg, así como el estado de la salida de arriba (cuando el valor es 1).

nonet (Si <VALOR_ENTERO> es cierto, rechaza obtener las DTDs de las entidades por la red).
novalid (Si <VALOR_ENTERO> es cierto, evita la fase de carga de la DTD).
repeat (Si <VALOR_ENTERO> es cierto, se hace funcionar la transformación 20 veces).
profile (Si <VALOR_ENTERO> es cierto, se vuelca información sobre perfiles).
timing (Si <VALOR_ENTERO> es cierto, se muestra el tiempo que se emplea).
noout (Si <VALOR_ENTERO> es cierto, no se vuelca el resultado).

Donde el valor es cierto si NO es igual a cero.
Donde el valor es falso, SI ES igual a cero.
stdout Muestra todos los mensajes de error en la salida estándar (stdout). Normalmente, los mensajes de error van a la salida de error (stderr).
setoption <NOMBRE_OPCION> "<VALOR_DE_CADENA>" (No debe contener comillas dobles dentro de <VALOR_DE_CADENA>).
setoption <NOMBRE_DE_OPCION> <VALOR_DE_CADENA> (No debe contener ningún espacio ni comillas dobles en <VALOR_DE_CADENA>).
Donde <NOMBRE_OPCION> puede ser o bien

data (La URI del archivo de datos).
source (La URI del archivo de origen).
output (El id. del sistema del archivo de salida).
docspath (Ruta para usar al buscar documentación).
catalognames (Los nombres de los catálogos que se usan cuando la opción catalogs está definida. El valor se pierde si se define antes de definir la opción catalogs).
encoding (Qué codificación usar para la salida estándar).
searchresultspath Qué ruta se va a usar para almacenar el resultado de la búsqueda. Si no está definido, xsldbg usará la ruta de la hoja de estilos.

## Shell

Ejecuta un comando en la shell

## Uso de shell

shell <TEXTO> (<TEXTO> es el texto que se pasa al sistema operativo para que lo ejecute).

## Showbreak

Para mostrar la lista de puntos de interrupción de la plantilla.

Nombre para acceso rápido: show

Si existe un modo en el punto de interrupción de la plantilla, se añadirá al final del nombre de la plantilla para el punto de interrupción. Ejemplo de la salida:

Punto de interrupción 3 activado para la plantilla «*» en la línea 105 del archivo test1.xsl.
Punto de interrupción 2 activado para la plantilla «* testMode» en la línea 109 del archivo test1.xsl.
Punto de interrupción 1 activado para la plantilla «* http://www.w3.org/1999/XSL/Transform:testMode» en la línea 113 del archivo test1.xsl.
En total hay 3 puntos de interrupción.

## Uso de showbreak

showbreak

## Showparam

Muestra la lista de parámetros presentes en libxslt.

## Uso de showparam

showparam

## Showwatch

Muestra la expresión que se está observando en este momento.

Nombre para acceso rápido: watches

## Uso de showwatch

showwatch (Muestra las variables que se están observando en este momento y sus valores).
showwatch 1 (Activa la muestra automática de las expresiones que se están observando. Es lo que se usa de forma predefinida).
showwatch 0 (Desactiva la muestra automática de las expresiones que se están observando).

## Source

Pasa a mostrar el nodo actual de la hoja de estilos. O cambia la hoja de estilos que se está usando.

## Uso de source

source (Pasa al nodo actual de la hoja de estilos).
source <FUENTE> (Para pasar a un nuevo archivo fuente. El «~» del comienzo se reemplaza por el valor de la variable de entorno $HOME. Se tiene que usar el comando «run» para ejecutarlo).

## Step

Avanza hasta la siguiente instrucción de la hoja de estilos.

Nombre para acceso rápido: s

## Uso de step

step

## Stepdown

Retrocede hasta un «marco de llamada» más reciente.

Nombre para acceso rápido: down

## Uso de stepdown

stepdown (retrocede un marco).
stepdown <NUMERO_DE_MARCOS> (retrocede el número de marcos que se le indique).

## Stepup

Avanza a un «marco de llamada» anterior.

Nombre para acceso rápido: up

No es un comando preciso. xsldbg se detendrá tan pronto como pueda.

## Uso de stepup

stepup (avanza un marco).
stepup <NUMERO_DE_MARCOS> (avanza el número de marcos que se le indique).

## Stylesheets

Muestra una lista de las hojas de estilos que están cargadas.

Nombre para acceso rápido: style

## Uso de stylesheets

stylesheets

## System

Muestra el valor con el que se mapea el archivo de sistema por medio del catálogo actual

Nombre para acceso rápido: sys

## Uso de system

system "<id. sistema>"

## Templates

Muestra la lista de las plantillas disponibles. Busca una plantilla.

Nombre para acceso rápido: t

## Uso de templates

templates
templates <PLANTILLA> (Muestra detalles de la plantilla llamada <PLANTILLA>, si es que existe).

## Trace

Traza una ejecución de la hoja de estilo, mostrando el archivo y las líneas de los pasos intermedios.

## Uso de trace

trace

## Tty

Abre un terminal. Define el nivel de la redirección de tty.

## Uso de tty

tty <RUTA_DISPOSITIVO> (Donde <RUTA_DISPOSITIVO> es un terminal válido del sistema operativo. Sólo intenta abrir el terminal.
tty <NIVEL_TTY> (Define el nivel de la redirección de tty, donde <NIVEL_TTY> es un nivel válido de entrada/salida que se va a usar).

Donde el nivel es
0 = Entrada/salida predefinida
1 = Salida por terminal de los resultados de la transformación, siguiendo la traza y avanzando (El estado predefinido cuando se ha abierto el dispositivo tty. Aún no está implementado por completo).
2 = Redirección completa al terminal (Aún no implementado).
Se asume que todos los demás valores enteros son el nivel 0.

## Validate

Valida el archivo de salida que genera la hoja de estilos (desactivado).

## Uso de validate

validate

## Walk

Avanza a través del código, usando un rango de velocidades.

## Uso de walk

walk <VELOCIDAD> (Use Ctrl-c para detener la ejecución, <VELOCIDAD> es un valor entre 0 y 9, donde 0 significa detenido 1 es muy rápido y 9 es muy lento).

## Where

Muestra una traza de las llamadas de las plantillas (pila del marco) y muestra el directorio de trabajo.

Nombre para acceso rápido: w

## Uso de where

where

## Write

Por terminar.

## Uso de write

write