# Usar o &xsldbg;

## Argumentos do comando 'xsldbg'

Nos sistemas que tenham a biblioteca 'readline' disponível, poderá usar as teclas para recuar/avançar para navegar no histórico de comandos introduzidos. Em todos os sistemas, o último comando introduzido poderá ser repetido se carregar na tecla <ENTER>.

Se o seu sistema operativo o suportar, os nomes dos ficheiros serão expandidos.

Vários dos comandos recebem mais que um argumento. Podem ser usadas plicas para que as expressões complexas seja tratadas como apenas um argumento, ⪚ o 'break "* | @"' iria permitir usar um ponto de paragem no modelo com o nome "* | @"

## Legenda de termos

A tabela seguinte descreve os termos usados no guia de comandos subsequente

NOME_MODELO : Um nome de modelo válido só contém os caracteres ASCII de 0x00 até 0x7F. Poderá ser um nome qualificado por completo como por exemplo "xsl:nomeModelo".
FICHEIRO : Um nome de ficheiro válido e local ao sistema do utilizador. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS
URI : Um Uniform Resource Identifier, tal como está definido no RFC 2396
NOME_MODO O modo do modelo, o qual poderá ser um nome completo qualificado, por exemplo "xsl:nomeModo".
QNAME : Um nome qualificado e completo, por exemplo "xsl:parteLocal"
NUM_LINHA : Um número de linha válido no <FICHEIRO> associado
NUMERO_DE_TRAMAS : Um número de tramas da linha para o qual mudar de posição
ID_PONTO_PARAGEM : Um número de ponto de paragem válido
ID_VIGIA : Um número de expressão de vigia válido, tal como é indicado no comando 'showwatch'
VELOCIDADE: a velocidade com a qual percorrer o código, entre 0 e 9
(Comentário): um comentário sobre o significado ou utilização do comando
{ opç1 | opç2 | opç3 .. etc} : Escolher um das opções
XPATH : uma selecção de nós via XPath
ID_PARAM : um número de parâmetro válido, tal como é indicado pelo comando 'showparam'
LOCALIZAÇÃO : Um local para o qual mudar a pasta de trabalho. Em alguns sistemas operativos, um prefixo "~" será substituído pelo seu local de trabalho
TEXTO : Algum texto livre (sem restrições)
COMANDO : Um comando válido para o 'xsldbg'
QNAME : Um nome de parâmetro/variável válido
CÓDIGO : A 'stylesheet' que está a ser/será executada. Veja o <FICHEIRO> e o <URI>
DADOS : Os dados em XML (o documento) que está a ser/será processado pela 'stylesheet'. Veja o <FICHEIRO> e o <URI>
LOCAL_DISPOSITIVO : É um terminal válido no sistema operativo
NIVEL_TTY : É um nível válido de entrada/saída a usar

## Apresentação aos comandos disponíveis

Relacionados com a ajuda :help
Relacionados com a execução : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options
Relacionados com os parâmetros da Libxslt : addparam, delparam, showparam, output, setoption, options
Relacionados com os modelos : templates, where, frame
Relacionados com os pontos de paragem : break, showbreak, delete, enable
Visualização de expressões (XPath) : cat
Visualização de nós : ls, dir, du, cat, pwd
Visualização de variáveis : globals, locals, cat, addwatch
Definição de variáveis: set
Selecção de nós : source, data, cd
Procura :search
Relacionados com o sistema operativo :chdir, shell, tty
Relacionados com ficheiros : output, entities, system, public
Comandos de ficheiros desactivados: validate, load, save, write, free