Referência de Comandos
Addparam
Adiciona um parâmetro à 'libxslt' ; é equivalente a oferecer a opção --param <QNAME>:<XPATH> através da linha de comando.
Uso 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
Uso do 'addwatch'
addwatch <XPATH>
Base
Imprime a base deste nó
Break
Interrompe num modelo, num determinado local de uma folha de estilo ou arquivo em XML carregado pelo 'xsldbg' ou no nó atual. É novo no xsldbg 3.1.4: Quando está no modo de compatibilidade com o 'gdb', os pontos de parada órfãos podem ser definidos num arquivo e número de linha específicos e podem ser traduzidos para um ponto de parada ativo mais tarde.
Nome de atalho: bO 'xsldbg' tentará adivinhar o URL completo, com base no nome do arquivo, sem o caminho especificado.
nome do arquivo, na mesma pasta que a folha de estilo de topo se encontra
nome do arquivo, relativo à pasta de trabalho atual do 'xsldbg'
Isto significa que, se tiver carregado um arquivo de uma folha de estilo 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 arquivo 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 parada pedido com o seu URL e número de linha associado. Isto é feito automaticamente, depois do primeiro modelo ter sido visto pelo 'xsldbg'. Os pontos de parada são validados de novo, pouco depois do início de cada execução. A validação automática dos pontos de parada é usada quando o modo do 'gdb' está ativo - o que é o comportamento padrão do 'xsldbg'
Uso do 'break'
break -l <ARQUIVO> <NUM_LINHA> (Para definir um ponto de parada no arquivo e número de linha indicados)
break -l <URI> <NUM_LINHA> (Para definir um ponto de parada 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ó atual. Sim, isto inclui os nós de dados em XML!)
Bye
Pára o processamento da folha de estilo o mais cedo possível.
Cat
Imprime o resultado de uma expressão de XPath no nó atual relativo.
Uso do 'cat'
Uso : cat <XPATH> (Para ver uma variável ou parâmetro)
Uso : cat $<QNAME>
Cd
Muda para o local indicado por uma expressão XPath.
Uso do 'cd'
<< = preceding-sibling::node()
>> = following-sibling::node()
<- = ancestor::node()
-> = decendant::node()
Chdir
Muda a pasta de trabalho
Uso do 'chdir'
chdir <LOCALIZAÇÃO> (Um local relativo ou absoluto no sistema operacional)
Continue
Continua a execução da folha de estilo, parando em todos os pontos de parada encontrados.
Nome de atalho: c
Uso do 'continue'
continue
Data
Muda para a visualização do nó atual em dados de XML ou muda os dados de XML usados
Uso do 'data'
data (Muda para o nó atual do documento.)
data <DADOS> (Para mudar para um arquivo 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 processá-lo)
Delete
Remove um ponto de parada de um modelo
Nome de atalho: d
Uso do 'delete'
delete (Para remover um ponto de parada no nó atual)
delete <ID_PONTO_PARADA> (Para remover o ponto de parada com o número de ponto de parada indicado)
delete -l <ARQUIVO> <NUM_LINHA> (Remove o ponto de parada no arquivo e número de linha indicados)
delete -l <URI> <NUM_LINHA> (Remove o ponto de parada no URI e número de linha indicados)
delete <NOME_MODELO> (Para remover o ponto de parada no modelo identificado pelo nome.)
delete * (Para remover todos os pontos de parada.)
Delparam
Remove um parâmetro do 'libxslt'
Uso 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".
Uso 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' do console.
Disable
Desativa um ponto de parada
Uso do 'disable'
disable (Para desativar o ponto de parada no nó atual)
disable <ID_PONTO_PARADA> (Para desativar o ponto de parada com o número de ponto de parada indicado
disable -l <ARQUIVO> <NUM_LINHA> (Desativa o ponto de parada no arquivo e número de linha indicado)
disable -l <URI> <NUM_LINHA> (Desativa o ponto de parada 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ó
Enable
Ativa ou desativa um ponto de parada (comuta o estado de ativo/inativo)
Nome de atalho: e
Uso do 'enable'
enable (Para ativar/desativar o ponto de parada no nó atual)
enable <ID_PONTO_PARADA> (Para ativar/desativar o ponto de parada com o número de ponto de parada indicado
enable -l <ARQUIVO> <NUM_LINHA> (Ativa/desativar o ponto de parada no arquivo e número de linha indicados)
enable -l <URI> <NUM_LINHA> (Ativa/desativa o ponto de parada no URI e número de linha indicados)
Entities
Imprime uma lista das entidades gerais processadas que são usadas neste arquivo de dados (documento)
Nome de atalho : ent
Exit
Pára o processamento da folha de estilo o mais cedo possível.
Frame
Imprime o conteúdo da pilha a uma determinada profundidade
Nome de atalho : f
Uso do 'frame'
frame <PROFUNDIDADE> (A profundidade é um número de 0 até à profundidade atual da pilha de chamadas)
Free
Liberta a folha de estilo e os dados (desativado; veja o 'run')
Globals
Imprime uma lista com as variáveis e parâmetros globais da folha de estilo. Imprime o valor de uma variável global
Uso 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 visão geral dos comandos
Nome de atalho: h
Uso do 'help'
help (Mostra uma apresentação do produto)
help <COMANDO> (Mostra a ajuda sobre um determinado comando)
Load
Carrega as opções e preferências do usuário do 'xsldbg' a partir do disco
Locals
Imprime uma lista com as variáveis e parâmetros locais da folha de estilo. Imprime o valor de uma variável local
Uso 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 resumido
Next
Pula um 'xsl:call-template' ou um 'xsl:apply-templates'. Este comando tem o mesmo efeito que a inserção dos comandos "step" e "up"
Nome de atalho: n
Uso do 'next'
next (salta para a próxima instrução ao mesmo nível)
Options
Imprime os valores das opções do 'xsldbg'
Output
Indica um arquivo local e com permissões de escrita onde salvar a saída do comando
Nome de atalho : o
Uso do 'output'
output <ARQUIVO> (Um arquivo 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://". Ele é então convertido para um nome de arquivo que possa ser adequado para o sistema operacional)
output - ( Envia para a saída padrão. Só poderá ser usado se usar a versão para a linha de comando do 'xsldbg' )
Public
Imprime o valor que um ID público mapeia no catálogo atual
Nome de atalho : pub
Uso do 'public'
public "<IDPublico>"
Pwd
Imprime a pasta de trabalho atual.
Quit
Pára o processamento da folha de estilo o mais cedo possível.
Nome de atalho: q
Run
Reinicia a folha de estilo.
Nome de atalho: r
Save
Salva as opções ou preferências do usuário do 'xsldbg' no disco
Search
Procura numa base de dados com todas as informações extraídas das folhas de estilo carregadas
Todos os arquivos de saída são gravados no valor da opção "searchresultspath", se estiver definida, ou na mesma pasta que a folha de estilo 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 arquivo em XML (searchresults.xml). Você poderá então processar este arquivo com a sua própria folha de estilo 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 para terminar este comando.
Uso do 'search'
search <XPATH> (Vê o XPath que pode ser usado; veja em search.dtd. O <XPATH> padrão é o '//search/*' )
search -sort <XPATH> (Diz ao 'search.xsl' para ordenar os resultados antes de devolvê-los)
Set
Define o valor de uma variável
Uso do 'set'
set <NOME_VARIÁVEL> <XPATH>
Setoption
Define uma opção para a execução da folha de estilo
Você terá que usar o comando 'run' para ativar as alterações
Uso 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 operacional RISC)
html (se o <VALOR_INTEIRO> for verdadeiro, o documento de entrada é um arquivo 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 folha de estilo)
utf8input (se o <VALOR_INTEIRO> for verdadeiro, todos os dados de entrada do usuário 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 muito mais mensagens. Aumenta a frequência das mensagens "Ponto de parada 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, sendo o padrã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 arquivo de dados)
source (URI do arquivo de código)
output (IDSistema do arquivo 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 ativa. 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 folha de estilo
Shell
Executar um comando de 'shell'
Uso do 'shell'
shell <TEXTO> (o <TEXTO> é o texto a passar ao sistema operacional para ser executado)
Showbreak
Para mostrar uma lista dos pontos de parada dos modelos.
Nome de atalho: showSe existir um modo e um ponto de parada no modelo, então este será adicionado ao fim do nome do modelo para o ponto de parada. Um exemplo do resultado será:
Ponto de parada 3 ativo para o modelo :"*" no arquivo teste1.xsl : linha 105
Ponto de parada 2 ativo para o modelo :"* modoTeste" no arquivo teste1.xsl : linha 109
Ponto de parada 1 ativo para o modelo :"* http://www.w3.org/1999/XSL/Transform:modoTeste" no arquivo teste1.xsl : linha 113
Um total de 3 pontos de parada presentes
Uso do 'showbreak'
showbreak
Showparam
Imprime os parâmetros da 'libxslt' presentes
Uso do 'showparam'
showparam
Showwatch
Mostra a expressão atual que está sendo vigiada
Nome de atalho: watches
Uso do 'showwatch'
showwatch (Mostra as vigias atuais e os seus valores)
showwatch 1 (Ativa a impressão automática das expressões vigiadas. Isto é usado por padrão.)
showwatch 0 (Desativa a impressão automática das expressões vigiadas.)
Source
Muda para a visualização do nó atual na folha de estilo ou muda a folha de estilo usada
Uso do 'source'
source (Muda para o nó atual da folha de estilo.)
source <CÓDIGO> (Muda para um novo arquivo de código. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Terá que usar o comando "run" para executá-lo)
Step
Avança até à próxima instrução da folha de estilo.
Nome de atalho: s
Stepdown
Avança, descendo para um novo nível da "pilha de chamadas".
Nome de atalho: down
Uso do 'stepdown'
stepdown (desce um nível na pilha de chamadas)
stepdown <NUMERO_DE_QUADROS> (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 correto, logo o 'xsldbg' irá parar assim que possa.
Uso do 'stepup'
stepup (sobe um nível da pilha)
stepup <NUMERO_DE_QUADROS> (sobe o número indicado de níveis da pilha de chamadas)
Stylesheets
Imprime uma lista com as folhas de estilo carregadas
Nome de atalho: style
Uso do 'stylesheets'
stylesheets
System
Imprime o valor que um arquivo do sistema mapeia no catálogo atual
Nome de atalho : sys
Uso do 'system'
system "<IDSistema>"
Templates
Imprime uma lista com os modelos disponíveis. Procura por um modelo
Nome de atalho: t
Uso do 'templates'
templates
templates <MODELO> (Imprime os detalhes do modelo com o nome <MODELO> se existir)
Trace
Faz um registro da execução da folha de estilo, apresentando o arquivo e os números de linha dos passos intermediários
Tty
Abre um terminal. Altera o nível de redirecionamento do TTY.
Uso do 'tty'
tty <LOCAL_DISPOSITIVO> (em que o <LOCAL_DISPOSITIVO> é um terminal válido no sistema operacional. Tenta simplesmente acessar o terminal
tty <NIVEL_TTY> (Altera o nível de redirecionamento 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 padrão
1 = Saída para o terminal dos resultados da transformação, do registro e do percurso (O estado padrão quando o dispositivo de TTY tiver sido aberto. Não está ainda completamente implementado.)
2 = Redirecionamento completa para o terminal (Ainda não implementado.)
Todos os outros valores inteiros correspondem ao nível 0
Validate
Valida o arquivo de saída gerado pela folha de estilo (desativado)
Uso do 'validate'
validate
Walk
Percorre o código, usando um intervalo de velocidade
Uso 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 registro das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho.
Nome de atalho: w
Write
A ser terminada