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. Utilização do 'bye' bye
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. Utilização do 'dir' dir
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 indicadodisable -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. Utilização do 'du' du
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 indicadoenable -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 Utilização do 'ls' ls
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. Utilização do 'pwd' pwd
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 Utilização do 'run' run
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 textoTanto 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 zeroOnde o valor é falso, se FOR igual a zerostdout    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' templatestemplates <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 terminaltty <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