# 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ó

## Uso do 'base'

base

## 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: b

O '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.

## Uso do 'bye'

bye

## 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.

## Uso do 'dir'

dir

## 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.

## Uso do 'du'

du

## Dump

Revela todos os detalhes deste nó

## Uso do 'dump'

dump

## 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

## Uso do 'ent'

entities

## Exit

Pára o processamento da folha de estilo o mais cedo possível.

## Uso do 'exit'

exit

## 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')

## Uso do 'free'

free

## 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

## Uso do 'load'

load

## 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

## Uso do 'ls'

ls

## 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'

## Uso do 'options'

options

## 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.

## Uso do 'pwd'

pwd

## Quit

Pára o processamento da folha de estilo o mais cedo possível.

Nome de atalho: q

## Uso do 'quit'

quit

## Run

Reinicia a folha de estilo.

Nome de atalho: r

## Uso do 'run'

run

## Save

Salva as opções ou preferências do usuário do 'xsldbg' no disco

## Uso do 'save'

save

## 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: show

Se 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

## Uso do 'step'

step

## 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: up

Este 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

## Uso do 'trace'

trace

## 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

## Uso do 'where'

where

## Write

A ser terminada

## Uso do 'write'

write