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

O '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' `../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. &eg; 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. &eg;, 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>
delparam <NOME_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 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.

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

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

## Readconfig

Lê a configuração do 'xsldbg' a partir da configuração gravada no disco.

### Utilização do 'readconfig'

readconfig

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

Utilização de exemplo : setoption net 1
Utilização de exemplo : setoption encoding "Valor de codificação"
setoption <NOME_OPÇÃO> (<VALOR_INTEIRO> | <VALOR_TEXTO>)
Onde o <VALOR_INTEIRO> é opcional para as opções que possam ser tratadas como números inteiros
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)

net (Se o <VALOR_INTEIRO> for verdadeiro, obtém os DTD's ou entidades da rede)
valid (Se o <VALOR_INTEIRO> for verdadeiro, efectua a fase de carregamento do DTD)
repeat (Se o <VALOR_INTEIRO> for maior que zero(0), então executa a transformação <VALOR_INTEIRO> vezes)
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)
out (se o <VALOR_INTEIRO> for verdadeiro, apresenta o resultado)

Onde o valor é verdadeiro se for indicada a palavra "true" ou se o valor NÃO for igual a zero
Onde o valor é falso se for indicada a palavra "false" ou se o valor FOR igual a zero
Onde o valor por omissão é 'true'; por exemplo 'setoption net'
Onde o valor por omissão é 'false', caso o nome da opção seja antecedido de um "o"; por exemplo 'setoption nonet'
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'
cwd (A pasta muda de posição, de acordo com o comando 'chdir')
comment (Um comentário livre sobre a sessão actual de depuração)

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

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

Este 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

## Writeconfig

Grava a configuração do 'xsldbg' num ficheiro em disco.

### Utilização do 'writeconfig'

writeconfig