Adiciona um parâmetros à 'libxslt' ; é equivalente a oferecer a opção --param <QNAME>:<XPATH> através da linha de comandos. addparam <QNAME> <XPATH>    (O <XPATH> não deverá conter quaisquer espaços nem aspas.) addparam <QNAME> "<XPATH>"    (Não deverá conter aspas no <XPATH>) Adiciona uma expressão para ser vigiada. Veja o 'showwatch' para mostrar os valores das vigias Nome de atalho: watch addwatch <XPATH> Imprime a base deste nó base 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' 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!) Pára o processamento da 'stylesheet' o mais cedo possível. bye Imprime o resultado de uma expressão de XPath no nó actual relativo. Utilização : cat <XPATH>    (Para ver uma variável ou parâmetro)Utilização : cat $<QNAME> Muda para o local indicado por uma expressão XPath. << = preceding-sibling::node()>> = following-sibling::node()<- = ancestor::node()-> = decendant::node() Muda a pasta de trabalho chdir <LOCALIZAÇÃO>    (Um local relativo ou absoluto no sistema operativo) Continua a execução da 'stylesheet', parando em todos os pontos de paragem encontrados. Nome de atalho: c continue Muda para a visualização do nó actual em dados de XML ou muda os dados de XML usados 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) Remove um ponto de paragem de um modelo Nome de atalho: d 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.) Remove um parâmetro do 'libxslt' delparam    (Remove todos os parâmetros presentes)delparam <ID_PARAMETRO> Remove uma expressão vigiada ou remove todas as expressões vigiadas que aparecem com o comando "showwatch". delwatch <ID_VIGIA>    (Remove uma expressão de vigia com o ID indicado)delwatch *    (Remove todas as expressões de vigia) Imprime uma lista de nós de uma forma semelhante à do comando 'dir' da consola. dir Desactiva um ponto de paragem 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) Imprime um resumo dos nós filhos com um formato em árvore. du Revela todos os detalhes deste nó dump Activa ou desactiva um ponto de paragem (comuta o estado de activo/inactivo) Nome de atalho: e 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) Imprime uma lista das entidades gerais processadas que são usadas neste ficheiro de dados (documento) Nome de atalho : ent entities Pára o processamento da 'stylesheet' o mais cedo possível. exit Imprime o conteúdo da pilha a uma dada profundidade Nome de atalho : f frame <PROFUNDIDADE>    (A profundidade é um número de 0 até à profundidade actual da pilha de chamadas) Liberta a 'stylesheet' e os dados (desactivado; veja o 'run') free Imprime uma lista com as variáveis e parâmetros globais da 'stylesheet'. Imprime o valor de uma variável global 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) Mostra uma ajuda ou uma introdução aos comandos Nome de atalho: h help     (Mostra uma apresentação do produto)help <COMANDO>     (Mostra alguma ajuda sobre um dado comando) Carrega as opções e preferências do utilizador do 'xsldbg' a partir do disco load Imprime uma lista com as variáveis e parâmetros locais da 'stylesheet'. Imprime o valor de uma variável local 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) Apresenta os nós num formato breve ls 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 next    (salta para a próxima instrução ao mesmo nível) Imprime os valores das opções do 'xsldbg' options Indica um ficheiro local e com permissões de escrita para onde gravar o resultado Nome de atalho : o 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' ) Imprime o valor que um ID público mapeia no catálogo actual Nome de atalho : pub public "<IDPublico>" Imprime a pasta de trabalho actual. pwd Pára o processamento da 'stylesheet' o mais cedo possível. Nome de atalho: q quit Reinicia a 'stylesheet'. Nome de atalho: r run Grava as opções ou preferências de utilizador do 'xsldbg' no disco save 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. 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) Define o valor de uma variável set <NOME_VARIÁVEL> <XPATH> Define uma opção para a execução da 'stylesheet' Terá de usar o comando 'run' para activar as alterações 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' Executar um comando da consola shell <TEXTO>    (o <TEXTO> é o texto a passar ao sistema operativo para ser executado) 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 showbreak Imprime os parâmetros da 'libxslt' presentes showparam Mostra a expressão actual que está a ser vigiada Nome de atalho: watches 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.) Muda para a visualização do nó actual na 'stylesheet' ou muda a 'stylesheet' usada 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) Avança até à próxima instrução da 'stylesheet'. Nome de atalho: s step Avança, descendo para um novo nível da "pilha de chamadas". Nome de atalho: down 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) 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. stepup     (sobe um nível da pilha)stepup <NUMERO_DE_TRAMAS>     (sobe o número indicado de níveis da pilha de chamadas) Imprime uma lista com as 'stylesheets' carregadas Nome de atalho: style stylesheets Imprime o valor que um ficheiro do sistema mapeia no catálogo actual Nome de atalho : sys system "<IDSistema>" Imprime uma lista com os modelos disponíveis. Procura por um modelo Nome de atalho: t templatestemplates <MODELO>    (Imprime os detalhes do modelo com o nome <MODELO> se existir) Faz um registo da execução da 'stylesheet', apresentando o ficheiro e os números de linha dos passos intermédios trace Abre um terminal. Altera o nível de redireccionamento 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 Valida o ficheiro de saída gerado pela 'stylesheet' (desactivado) validate Percorre o código, usando um intervalo de velocidades 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) Imprime um registo das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho. Nome de atalho: w where A ser terminada write