Referência de Comandos
Addparam
Adiciona um parâmetros à 'libxslt' ; é equivalente a oferecer a opção --param <QNAME>:<XPATH> através da linha de comandos.
Utilização do 'addparam'
addparam <QNAME> <XPATH> (O <XPATH> não deverá conter quaisquer espaços nem aspas.)
addparam <QNAME> "<XPATH>" (Não deverá conter aspas no <XPATH>)
Addwatch
Adiciona uma expressão para ser vigiada. Veja o 'showwatch' para mostrar os valores das vigias
Nome de atalho: watch
Utilização do 'addwatch'
addwatch <XPATH>
Base
Imprime a base deste nó
Utilização do 'base'
base
Break
Pára num modelo, num determinado local de uma 'stylesheet' ou ficheiro em XML carregado pelo 'xsldbg' ou no nó actual. É novo no xsldbg 3.1.4: Quando está no modo de compatibilidade com o 'gdb', os pontos de paragem órfãos podem ser definidos num ficheiro e número de linha específicos e podem ser traduzidos para um ponto de paragem activo mais tarde.
Nome de atalho: bO 'xsldbg' irá tentar adivinhar o URL completo, com base em o nome do ficheiro, sem o local indicado.
o nome do ficheiro, na mesma pasta que a 'stylesheet' de topo se encontra
o nome do ficheiro, relativo à pasta de trabalho actual do 'xsldbg'
Isto significa que, se tiver carregado um ficheiro de uma 'stylesheet' com um ../en/xsldoc.xsl, poderá fazer isto break -l xsldoc.xsl 26 Este comando fará a correspondência com um modelo QNAME parcial ou completo, assim como a um modo específico. Por exemplo, o "modelo" irá corresponder a qualquer QNAME com uma parte local de "modelo" Quaisquer espaços de nomes no QNAME indicado serão expandidos, tal como está definido no ficheiro de CÓDIGO de XSL. Por exemplo, o "xsl:teste1" será expandido para "http://www.w3.org/199/XSL/Transform:teste1" Poderá ser necessário resolver um ponto de paragem pedido com o seu URL e número de linha associado. Isto é feito automaticamente, depois de o primeiro modelo ter sido visto pelo 'xsldbg'. Os pontos de paragem são validados de novo, pouco depois do início de cada execução. A validação automática dos pontos de paragem é usada quando o modo do 'gdb' está activo - o que é o comportamento por omissão do 'xsldbg'
Utilização do 'break'
break -l <FICHEIRO> <NUM_LINHA> (Para definir um ponto de paragem no ficheiro e número de linha indicados)
break -l <URI> <NUM_LINHA> (Para definir um ponto de paragem no URI e número de linha indicados)
break <NOME_MODELO> (Para parar no modelo com o nome indicado ou que corresponda a ele.)
break <NOME_MODELO> <NOME_MODO> (Para parar no modelo com o nome e o modo indicados.)>
break "" <NOME_MODO> (Para parar em qualquer modelo que tenha um nome de modo igual ao indicado)
break * (Para parar em qualquer modelo indicado.)
break \* (Para parar no modelo "*". Os outros nomes que incluam o '*' não serão tratados de forma especial.)
break (Para parar no nó actual. Sim, isto inclui os nós de dados em XML!)
Bye
Pára o processamento da 'stylesheet' o mais cedo possível.
Cat
Imprime o resultado de uma expressão de XPath no nó actual relativo.
Utilização do 'cat'
Utilização : cat <XPATH> (Para ver uma variável ou parâmetro)
Utilização : cat $<QNAME>
Cd
Muda para o local indicado por uma expressão XPath.
Utilização do 'cd'
<< = preceding-sibling::node()
>> = following-sibling::node()
<- = ancestor::node()
-> = decendant::node()
Chdir
Muda a pasta de trabalho
Utilização do 'chdir'
chdir <LOCALIZAÇÃO> (Um local relativo ou absoluto no sistema operativo)
Continue
Continua a execução da 'stylesheet', parando em todos os pontos de paragem encontrados.
Nome de atalho: c
Utilização do 'continue'
continue
Data
Muda para a visualização do nó actual em dados de XML ou muda os dados de XML usados
Utilização do 'data'
data (Muda para o nó actual do documento.)
data <DADOS> (Para mudar para um ficheiro de dados em XML novo. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Será necessário usar o comando "run" para o processar)
Delete
Remove um ponto de paragem de um modelo
Nome de atalho: d
Utilização do 'delete'
delete (Para remover um ponto de paragem no nó actual)
delete <ID_PONTO_PARAGEM> (Para remover o ponto de paragem com o número de ponto de paragem indicada)
delete -l <FICHEIRO> <NUM_LINHA> (Remove o ponto de paragem no ficheiro e número de linha indicados)
delete -l <URI> <NUM_LINHA> (Remove o ponto de paragem no URI e número de linha indicados)
delete <NOME_MODELO> (Para remover o ponto de paragem no modelo identificado pelo nome.)
delete * (Para remover todos os pontos de paragem.)
Delparam
Remove um parâmetro do 'libxslt'
Utilização do 'delparam'
delparam (Remove todos os parâmetros presentes)
delparam <ID_PARAMETRO>
Delwatch
Remove uma expressão vigiada ou remove todas as expressões vigiadas que aparecem com o comando "showwatch".
Utilização do 'delwatch'
delwatch <ID_VIGIA> (Remove uma expressão de vigia com o ID indicado)
delwatch * (Remove todas as expressões de vigia)
Dir
Imprime uma lista de nós de uma forma semelhante à do comando 'dir' da consola.
Disable
Desactiva um ponto de paragem
Utilização do 'disable'
disable (Para desactivar o ponto de paragem no nó actual)
disable <ID_PONTO_PARAGEM> (Para desactivar o ponto de paragem com o número de ponto de paragem indicado
disable -l <FICHEIRO> <NUM_LINHA> (Desactiva o ponto de paragem no ficheiro e número de linha indicado)
disable -l <URI> <NUM_LINHA> (Desactiva o ponto de paragem no URI e número de linha indicados)
Du
Imprime um resumo dos nós filhos com um formato em árvore.
Dump
Revela todos os detalhes deste nó
Utilização do 'dump'
dump
Enable
Activa ou desactiva um ponto de paragem (comuta o estado de activo/inactivo)
Nome de atalho: e
Utilização do 'enable'
enable (Para activar/desactivar o ponto de paragem no nó actual)
enable <ID_PONTO_PARAGEM> (Para activar/desactivar o ponto de paragem com o número de ponto de paragem indicado
enable -l <FICHEIRO> <NUM_LINHA> (Activa/desactivar o ponto de paragem no ficheiro e número de linha indicados)
enable -l <URI> <NUM_LINHA> (Activa/desactiva o ponto de paragem no URI e número de linha indicados)
Entities
Imprime uma lista das entidades gerais processadas que são usadas neste ficheiro de dados (documento)
Nome de atalho : ent
Utilização do 'ent'
entities
Exit
Pára o processamento da 'stylesheet' o mais cedo possível.
Utilização do 'exit'
exit
Frame
Imprime o conteúdo da pilha a uma dada profundidade
Nome de atalho : f
Utilização do 'frame'
frame <PROFUNDIDADE> (A profundidade é um número de 0 até à profundidade actual da pilha de chamadas)
Free
Liberta a 'stylesheet' e os dados (desactivado; veja o 'run')
Utilização do 'free'
free
Globals
Imprime uma lista com as variáveis e parâmetros globais da 'stylesheet'. Imprime o valor de uma variável global
Utilização do 'globals'
globals (Imprime uma lista com todas as variáveis disponíveis a nível global)
globals -f (Imprime uma lista com todas as variáveis globais e os seus valores)
globals <QNAME> (Imprime o valor da variável indicada)
Help
Mostra uma ajuda ou uma introdução aos comandos
Nome de atalho: h
Utilização do 'help'
help (Mostra uma apresentação do produto)
help <COMANDO> (Mostra alguma ajuda sobre um dado comando)
Load
Carrega as opções e preferências do utilizador do 'xsldbg' a partir do disco
Utilização do 'load'
load
Locals
Imprime uma lista com as variáveis e parâmetros locais da 'stylesheet'. Imprime o valor de uma variável local
Utilização do 'locals'
locals (Imprime uma lista com todas as variáveis disponíveis a nível local)
locals -f (Imprime uma lista com todas as variáveis disponíveis a nível local, bem como os seus valores)
locals <QNAME> (Imprime o valor da variável indicada)
Ls
Apresenta os nós num formato breve
Next
Salta por cima de um 'xsl:call-template' ou um 'xsl:apply-templates'. Este comando tem o mesmo efeito que a introdução dos comandos "step" e "up"
Nome de atalho: n
Utilização do 'next'
next (salta para a próxima instrução ao mesmo nível)
Options
Imprime os valores das opções do 'xsldbg'
Utilização do 'options'
options
Output
Indica um ficheiro local e com permissões de escrita para onde gravar o resultado
Nome de atalho : o
Utilização do 'output'
output <FICHEIRO> (Um ficheiro local com permissões de escrita. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS)
output <URI> (O <URI> só poderá usar o protocolo "file://". Este é então convertido para um nome de ficheiro que possa ser adequado para o sistema operativo)
output - ( Envia para o 'standard output'. Só poderá ser usado se usar a versão para a linha de comandos do 'xsldbg' )
Public
Imprime o valor que um ID público mapeia no catálogo actual
Nome de atalho : pub
Utilização do 'public'
public "<IDPublico>"
Pwd
Imprime a pasta de trabalho actual.
Quit
Pára o processamento da 'stylesheet' o mais cedo possível.
Nome de atalho: q
Utilização do 'quit'
quit
Run
Reinicia a 'stylesheet'.
Nome de atalho: r
Save
Grava as opções ou preferências de utilizador do 'xsldbg' no disco
Utilização do 'save'
save
Search
Procura numa base de dados com toda a informação extraída das 'stylesheets' carregadas
Todos os ficheiros de saída são gravados no valor da opção "searchresultspath", se estiver definida, ou na mesma pasta que a 'stylesheet' indicada. O 'searchresults.xml' é normalmente transformado pelo 'search.xsl', mas também pode ser transformado com o 'searchhtml.xsl' se a opção "prefrehtml" estiver definida. Quando o comando 'search' é invocado, é gerado um ficheiro em XML (searchresults.xml). Poderá então processar este ficheiro com a sua própria 'stylesheet' para apresentar os dados de outra forma. Se a opção "preferhtml" não estiver definida, então será apresentado o 'searchresult.txt'. Dependendo da quantidade de dados obtida, poderá levar algum tempo a terminar este comando.
Utilização do 'search'
search <XPATH> (Vê o XPath que pode ser usado; veja em search.dtd. O <XPATH> por omissão é o '//search/*' )
search -sort <XPATH> (Diz ao 'search.xsl' para ordenar os resultados antes de os devolver)
Set
Define o valor de uma variável
Utilização do 'set'
set <NOME_VARIÁVEL> <XPATH>
Setoption
Define uma opção para a execução da 'stylesheet'
Terá de usar o comando 'run' para activar as alterações
Utilização do 'setoption'
setoption <NOME_OPÇÃO> <VALOR_INTEIRO>
Onde o <NOME_OPÇÃO> tanto poderá ser
debug (se o <VALOR_INTEIRO> for verdadeiro, faz uma visualização completa da árvore do resultado em alternativa)
catalogs (se o <VALOR_INTEIRO> for verdadeiro, usa os catálogos de $SGML_CATALOG_FILES ou de SGML$CatalogFiles para o sistema operativo RISC)
html (se o <VALOR_INTEIRO> for verdadeiro, o documento à entrada é um ficheiro em HTML)
docbook (se o <INTEGER_VALUE> for verdadeiro e o DocBook ainda for suportado pela 'libxml', o documento de entrada é em DocBook de SGML)
xinclude (se o <VALOR_INTEIRO> for verdadeiro, será feito um processamento de XInclude no documento de entrada)
preferhtml (se o <VALOR_INTEIRO> for verdadeiro, será usado como preferido um resultado em HTML. Veja o comando 'search')
autoencode (se o <VALOR_INTEIRO> for verdadeiro, tenta usar a codificação da 'stylesheet')
utf8input (se o <VALOR_INTEIRO> for verdadeiro, todos os dados de entrada do utilizador estão em UTF-8. Isto é usado normalmente quando o 'xsldbg' é usado como uma tarefa ('thread') em separado)
gdb (Executa no modo de compatibilidade com o 'gdb')
Para um valor igual a 1, isto significa
Imprime bastante mais mensagens. Aumenta a frequência das mensagens "Ponto de paragem em ..."
Serão impressas no máximo GDB_LINES_TO_PRINT linhas ao avaliar as expressões, seguidas de um "...". Veja o 'options.h' para alterar este valor, pelo que o predefinido são três linhas de texto
Tanto as locais como as globais serão impressas quando for executado o comando "locals"
Ao imprimir as expressões com o 'cat'/'print'. O valor avaliado será antecedido de um "= " < EXPRESSÃO >
Para um valor igual a 2, significa Imprime as mensagens necessárias pelo KDbg, assim como o estado do 'output' acima (quando o valor é igual a 1)
nonet (se o <VALOR_INTEIRO> for verdadeiro, recusa-se a obter os DTDs ou entidades a partir da rede)
novalid (se o <VALOR_INTEIRO> for verdadeiro, salta a fase de carregamento da DTD)
repeat (se o <VALOR_INTEIRO> for verdadeiro, executa 20 vezes a transformação)
profile (se o <VALOR_INTEIRO> for verdadeiro, apresenta as informações de análise)
timing (se o <VALOR_INTEIRO> for verdadeiro, mostra o tempo consumido)
noout (se o <VALOR_INTEIRO> for verdadeiro, não apresenta o resultado)
Onde o valor é verdadeiro, se NÃO for igual a zero
Onde o valor é falso, se FOR igual a zero
stdout Imprime todas as mensagens de erro no 'stdout'. Normalmente, as mensagens de erro vão para o 'stderr'.
setoption <NOME_OPÇÃO> "<VALOR_TEXTO>" (Não deverá conter aspas no <VALOR_TEXTO>)
setoption <NOME_OPÇÃO> <VALOR_TEXTO> (Não deverá conter quaisquer espaços, nem aspas, no <VALOR_TEXTO>)
Onde o <NOME_OPÇÃO> tanto poderá ser
data (URI do ficheiro de dados)
source (URI do ficheiro de código)
output (IDSistema do ficheiro de saída)
docspath (Local a usar quando procurar por documentação)
catalognames (Os nomes dos catálogos a usar quando a opção 'catalogs' estiver activa. O valor será perdido se for definido antes de configurar a opção 'catalogs')
encoding (Qual a codificação a usar para o 'standard output')
searchresultspath Qual o local a usar ao guardar os resultados da pesquisa. Se não estiver definido, então o 'xsldbg' irá usar o mesmo local que o da 'stylesheet'
Shell
Executar um comando da consola
Utilização do 'shell'
shell <TEXTO> (o <TEXTO> é o texto a passar ao sistema operativo para ser executado)
Showbreak
Para mostrar uma lista dos pontos de paragem dos modelos.
Nome de atalho: showSe existir um modo e um ponto de paragem no modelo, então este será adicionado ao fim do nome do modelo para o ponto de paragem. Um exemplo do resultado será:
Ponto de paragem 3 activo para o modelo :"*" no ficheiro teste1.xsl : linha 105
Ponto de paragem 2 activo para o modelo :"* modoTeste" no ficheiro teste1.xsl : linha 109
Ponto de paragem 1 activo para o modelo :"* http://www.w3.org/1999/XSL/Transform:modoTeste" no ficheiro teste1.xsl : linha 113
Um total de 3 pontos de paragem presentes
Utilização do 'showbreak'
showbreak
Showparam
Imprime os parâmetros da 'libxslt' presentes
Utilização do 'showparam'
showparam
Showwatch
Mostra a expressão actual que está a ser vigiada
Nome de atalho: watches
Utilização do 'showwatch'
showwatch (Mostra as vigias actuais e os seus valores)
showwatch 1 (Activa a impressão automática das expressões vigiadas. Isto é usado por omissão.)
showwatch 0 (Desactiva a impressão automática das expressões vigiadas.)
Source
Muda para a visualização do nó actual na 'stylesheet' ou muda a 'stylesheet' usada
Utilização do 'source'
source (Muda para o nó actual da 'stylesheet'.)
source <CÓDIGO> (Muda para um novo ficheiro de código. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Terá de usar o comando "run" para o executar)
Step
Avança até à próxima instrução da 'stylesheet'.
Nome de atalho: s
Utilização do 'step'
step
Stepdown
Avança, descendo para um novo nível da "pilha de chamadas".
Nome de atalho: down
Utilização do 'stepdown'
stepdown (desce um nível na pilha de chamadas)
stepdown <NUMERO_DE_TRAMAS> (desce o número de níveis indicado na pilha de chamadas)
Stepup
Volta para um nível superior na "pilha de chamadas".
Nome de atalho: upEste não é um comando correcto, pelo que o 'xsldbg' irá parar assim que possa.
Utilização do 'stepup'
stepup (sobe um nível da pilha)
stepup <NUMERO_DE_TRAMAS> (sobe o número indicado de níveis da pilha de chamadas)
Stylesheets
Imprime uma lista com as 'stylesheets' carregadas
Nome de atalho: style
Utilização do 'stylesheets'
stylesheets
System
Imprime o valor que um ficheiro do sistema mapeia no catálogo actual
Nome de atalho : sys
Utilização do 'system'
system "<IDSistema>"
Templates
Imprime uma lista com os modelos disponíveis. Procura por um modelo
Nome de atalho: t
Utilização do 'templates'
templates
templates <MODELO> (Imprime os detalhes do modelo com o nome <MODELO> se existir)
Trace
Faz um registo da execução da 'stylesheet', apresentando o ficheiro e os números de linha dos passos intermédios
Utilização do 'trace'
trace
Tty
Abre um terminal. Altera o nível de redireccionamento do TTY.
Utilização do 'tty'
tty <LOCAL_DISPOSITIVO> (em que o <LOCAL_DISPOSITIVO> é um terminal válido no sistema operativo. Tenta simplesmente aceder ao terminal
tty <NIVEL_TTY> (Altera o nível de redireccionamento do TTY, onde o <NIVEL_TTY> é um nível válido de entrada/saída a usar)
Onde o 'nível' é
0 = entrada/saída por omissão
1 = Saída para o terminal dos resultados da transformação, do registo e do percurso (O estado por omissão quando o dispositivo de TTY tiver sido aberto. Não está ainda completamente implementado.)
2 = Redireccionamento completo para o terminal (Ainda não implementado.)
Todos os outros valores inteiros correspondem ao nível 0
Validate
Valida o ficheiro de saída gerado pela 'stylesheet' (desactivado)
Utilização do 'validate'
validate
Walk
Percorre o código, usando um intervalo de velocidades
Utilização do 'walk'
walk <VELOCIDADE> (Use o Ctrl-c para parar a execução, a <VELOCIDADE> é um valor entre 0 e 9, em que o 0 significa parado, o 1 é muito rápido e o 9 é muito lento)
Where
Imprime um registo das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho.
Nome de atalho: w
Utilização do 'where'
where
Write
A ser terminada
Utilização do 'write'
write