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
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: bxsldbg 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.
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
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.
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.
Dump
Volcado de los detalles internos de este nodo
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
Exit
Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.
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)
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.
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.
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.
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.
Quit
Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.
Nombre para acceso rápido: q
Run
Reinicia la hoja de estilos.
Nombre para acceso rápido: r
Save
Guarda en disco las opciones de xsldbg y las preferencias del usuario.
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: showSi 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
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: upNo 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.
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).
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
Write
Por terminar.