path: root/tde-i18n-pt/docs/tdewebdev/xsldbg/commands.docbook

<?xml version="1.0" encoding="UTF-8" ?>
<chapter id="commands">
<title>Referência de Comandos</title>

<sect1 id="addparam_cmd"><title id="addparam_cmd.title">Addparam</title>
<para>Adiciona um parâmetros à 'libxslt' ; é equivalente a oferecer a opção --param &lt;QNAME&gt;:&lt;XPATH&gt; através da linha de comandos. </para>
<para></para>
<table><title>Utilização do 'addparam'</title>
<tgroup cols="1"><tbody>
<row><entry>addparam &lt;QNAME&gt; &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(O &lt;XPATH&gt; não deverá conter quaisquer espaços nem aspas.) </emphasis></entry></row>
<row><entry>addparam &lt;QNAME&gt; "&lt;XPATH&gt;"&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Não deverá conter aspas no &lt;XPATH&gt;)</emphasis></entry></row>
</tbody>
</tgroup> 
</table>
</sect1>

<sect1 id="addwatch_cmd"><title id="addwatch_cmd.title">Addwatch</title>
<para>Adiciona uma expressão para ser vigiada. Veja o 'showwatch' para mostrar os valores das vigias</para>
<para>Nome de atalho: watch</para>
<table><title>Utilização do 'addwatch'</title>
<tgroup cols="1"><tbody>
<row><entry>addwatch &lt;XPATH&gt;</entry></row>
</tbody>
</tgroup> 
</table>
</sect1>

<sect1 id="base_cmd"><title id="base_cmd.title">Base</title>
<para>Imprime a base deste nó</para>
<table><title>Utilização do 'base'</title>
<tgroup cols="1">
<tbody>
<row><entry>base</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="break_cmd"><title id="break_cmd.title">Break</title>
<para>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. </para>
<para>Nome de atalho: b</para><para>O 'xsldbg' irá tentar adivinhar o URL completo, com base em <informaltable> <tgroup cols="1"><tbody> <row><entry>o nome do ficheiro, sem o local indicado.</entry></row> <row><entry>o nome do ficheiro, na mesma pasta que a 'stylesheet' de topo se encontra</entry></row> <row><entry>o nome do ficheiro, relativo à pasta de trabalho actual do 'xsldbg'</entry></row> </tbody></tgroup> </informaltable> Isto significa que, se tiver carregado um ficheiro de uma 'stylesheet' com um ../en/xsldoc.xsl, poderá fazer isto </para><para>break -l xsldoc.xsl 26 </para><para>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" </para><para>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" </para><para>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. </para><para>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'</para>
<table><title>Utilização do 'break'</title>
<tgroup cols="1">
<tbody>
<row><entry>break -l &lt;FICHEIRO&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para definir um ponto de paragem no ficheiro e número de linha indicados)</emphasis></entry></row>
<row><entry>break -l &lt;URI&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para definir um ponto de paragem no URI e número de linha indicados)</emphasis></entry></row>
<row><entry>break &lt;NOME_MODELO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar no modelo com o nome indicado ou que corresponda a ele.)</emphasis></entry></row>
<row><entry>break &lt;NOME_MODELO&gt; &lt;NOME_MODO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar no modelo com o nome e o modo indicados.)></emphasis></entry></row>
<row><entry>break "" &lt;NOME_MODO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar em qualquer modelo que tenha um nome de modo igual ao indicado)</emphasis></entry></row>
<row><entry>break *&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar em qualquer modelo indicado.)</emphasis></entry></row>
<row><entry>break \*&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar no modelo "*". Os outros nomes que incluam o '*' não serão tratados de forma especial.)</emphasis></entry></row>
<row><entry>break &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para parar no nó actual. Sim, isto inclui os nós de dados em XML!)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="bye_cmd"><title id="bye_cmd.title">Bye</title>
<para>Pára o processamento da 'stylesheet' o mais cedo possível.</para>
<table><title>Utilização do 'bye'</title>
<tgroup cols="1">
<tbody>
<row><entry>bye</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="cat_cmd"><title id="cat_cmd.title">Cat</title>
<para>Imprime o resultado de uma expressão de XPath no nó actual relativo.</para>
<table><title>Utilização do 'cat'</title>
<tgroup cols="1">
<tbody>
<row><entry>Utilização : cat &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para ver uma variável ou parâmetro)</emphasis></entry></row>
<row><entry>Utilização : cat $&lt;QNAME&gt;</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="cd_cmd"><title id="cd_cmd.title">Cd</title>
<para>Muda para o local indicado por uma expressão XPath.</para>
<table><title>Utilização do 'cd'</title>
<tgroup cols="1">
<tbody>
<row><entry>&lt;&lt; = preceding-sibling::node()</entry></row>
<row><entry>&gt;&gt; = following-sibling::node()</entry></row>
<row><entry>&lt;- = ancestor::node()</entry></row>
<row><entry>-&gt; = decendant::node()</entry></row>
</tbody></tgroup>
</table>
</sect1>

<sect1 id="chdir_cmd"><title id="chdir_cmd.title">Chdir</title>
<para>Muda a pasta de trabalho</para>
<table><title>Utilização do 'chdir'</title>
<tgroup cols="1">
<tbody>
<row><entry>chdir &lt;LOCALIZAÇÃO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Um local relativo ou absoluto no sistema operativo)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="continue_cmd"><title id="continue_cmd.title">Continue</title>
<para>Continua a execução da 'stylesheet', parando em todos os pontos de paragem encontrados.</para>
<para>Nome de atalho: c</para>
<table><title>Utilização do 'continue'</title>
<tgroup cols="1">
<tbody>
<row><entry>continue</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="data_cmd"><title id="data_cmd.title">Data</title>
<para>Muda para a visualização do nó actual em dados de XML ou muda os dados de XML usados</para>
<table><title>Utilização do 'data'</title>
<tgroup cols="1">
<tbody>
<row><entry>data&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Muda para o nó actual do documento.)</emphasis></entry></row>
<row><entry>data &lt;DADOS&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(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)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="delete_cmd"><title id="delete_cmd.title">Delete</title>
<para>Remove um ponto de paragem de um modelo</para>
<para>Nome de atalho: d</para>
<table><title>Utilização do 'delete'</title>
<tgroup cols="1">
<tbody>
<row><entry>delete&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para remover um ponto de paragem no nó actual)</emphasis></entry></row>
<row><entry>delete &lt;ID_PONTO_PARAGEM&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para remover o ponto de paragem com o número de ponto de paragem indicada)</emphasis></entry></row>
<row><entry>delete -l &lt;FICHEIRO&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Remove o ponto de paragem no ficheiro e número de linha indicados)</emphasis></entry></row>
<row><entry>delete -l &lt;URI&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Remove o ponto de paragem no URI e número de linha indicados)</emphasis></entry></row>
<row><entry>delete &lt;NOME_MODELO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para remover o ponto de paragem no modelo identificado pelo nome.)</emphasis></entry></row>
<row><entry>delete *&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para remover todos os pontos de paragem.)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="delparam_cmd"><title id="delparam_cmd.title">Delparam</title>
<para>Remove um parâmetro do 'libxslt'</para>
<table><title>Utilização do 'delparam'</title>
<tgroup cols="1">
<tbody>
<row><entry>delparam&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Remove todos os parâmetros presentes)</emphasis></entry></row>
<row><entry>delparam &lt;ID_PARAMETRO&gt;</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="delwatch_cmd"><title id="delwatch_cmd.title">Delwatch</title>
<para>Remove uma expressão vigiada ou remove todas as expressões vigiadas que aparecem com o comando "showwatch".</para>
<table><title>Utilização do 'delwatch'</title>
<tgroup cols="1">
<tbody>
<row><entry>delwatch &lt;ID_VIGIA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Remove uma expressão de vigia com o ID indicado)</emphasis></entry></row>
<row><entry>delwatch *&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Remove todas as expressões de vigia)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="dir_cmd"><title id="dir_cmd.title">Dir</title>
<para>Imprime uma lista de nós de uma forma semelhante à do comando 'dir' da consola.</para>
<para/>
<table><title>Utilização do 'dir'</title>
<tgroup cols="1">
<tbody>
<row><entry>dir</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="disable_cmd"><title id="disable_cmd.title">Disable</title>
<para>Desactiva um ponto de paragem</para>
<table><title>Utilização do 'disable'</title>
<tgroup cols="1">
<tbody>
<row><entry>disable&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para desactivar o ponto de paragem no nó actual)</emphasis></entry></row>
<row><entry>disable &lt;ID_PONTO_PARAGEM&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para desactivar o ponto de paragem com o número de ponto de paragem indicado</emphasis></entry></row>
<row><entry>disable -l &lt;FICHEIRO&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Desactiva o ponto de paragem no ficheiro e número de linha indicado)</emphasis></entry></row>
<row><entry>disable -l &lt;URI&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Desactiva o ponto de paragem no URI e número de linha indicados)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="du_cmd"><title id="du_cmd.title">Du</title>
<para>Imprime um resumo dos nós filhos com um formato em árvore.</para>
<table><title>Utilização do 'du'</title>
<tgroup cols="1">
<tbody>
<row><entry>du</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="dump_cmd"><title id="dump_cmd.title">Dump</title>
<para>Revela todos os detalhes deste nó</para>
<table><title>Utilização do 'dump'</title>
<tgroup cols="1">
<tbody>
<row><entry>dump</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="enable_cmd"><title id="enable_cmd.title">Enable</title>
<para>Activa ou desactiva um ponto de paragem (comuta o estado de activo/inactivo)</para>
<para>Nome de atalho: e</para>
<table><title>Utilização do 'enable'</title>
<tgroup cols="1">
<tbody>
<row><entry>enable&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para activar/desactivar o ponto de paragem no nó actual)</emphasis></entry></row>
<row><entry>enable &lt;ID_PONTO_PARAGEM&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Para activar/desactivar o ponto de paragem com o número de ponto de paragem indicado</emphasis></entry></row>
<row><entry>enable -l &lt;FICHEIRO&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Activa/desactivar o ponto de paragem no ficheiro e número de linha indicados)</emphasis></entry></row>
<row><entry>enable -l &lt;URI&gt; &lt;NUM_LINHA&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Activa/desactiva o ponto de paragem no URI e número de linha indicados)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="entities_cmd"><title id="entities_cmd.title">Entities</title>
<para>Imprime uma lista das entidades gerais processadas que são usadas neste ficheiro de dados (documento)</para>
<para>Nome de atalho : ent</para>
<table><title>Utilização do 'ent'</title>
<tgroup cols="1">
<tbody>
<row><entry>entities</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="exit_cmd"><title id="exit_cmd.title">Exit</title>
<para>Pára o processamento da 'stylesheet' o mais cedo possível.</para>
<table><title>Utilização do 'exit'</title>
<tgroup cols="1">
<tbody>
<row><entry>exit</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="frame_cmd"><title id="frame_cmd.title">Frame</title>
<para>Imprime o conteúdo da pilha a uma dada profundidade</para>
<para>Nome de atalho : f</para>
<table><title>Utilização do 'frame'</title>
<tgroup cols="1">
<tbody>
<row><entry>frame &lt;PROFUNDIDADE&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(A profundidade é um número de 0 até à profundidade actual da pilha de chamadas)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="free_cmd"><title id="free_cmd.title">Free</title>
<para>Liberta a 'stylesheet' e os dados (desactivado; veja o 'run')</para>
<table><title>Utilização do 'free'</title>
<tgroup cols="1">
<tbody>
<row><entry>free</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="globals_cmd"><title id="globals_cmd.title">Globals</title>
<para>Imprime uma lista com as variáveis e parâmetros globais da 'stylesheet'. Imprime o valor de uma variável global</para>
<table><title>Utilização do 'globals'</title>
<tgroup cols="1">
<tbody>
<row><entry>globals&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime uma lista com todas as variáveis disponíveis a nível global)</emphasis></entry></row>
<row><entry>globals -f&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime uma lista com todas as variáveis globais e os seus valores)</emphasis></entry></row>
<row><entry>globals &lt;QNAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime o valor da variável indicada)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="help_cmd"><title id="help_cmd.title">Help</title>
<para>Mostra uma ajuda ou uma introdução aos comandos</para>
<para>Nome de atalho: h</para>
<table><title>Utilização do 'help'</title>
<tgroup cols="1">
<tbody>
<row><entry>help &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Mostra uma apresentação do produto)</emphasis></entry></row>
<row><entry>help &lt;COMANDO&gt; &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Mostra alguma ajuda sobre um dado comando)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="load_cmd"><title id="load_cmd.title">Load</title>
<para>Carrega as opções e preferências do utilizador do 'xsldbg' a partir do disco</para>
<table><title>Utilização do 'load'</title>
<tgroup cols="1">
<tbody>
<row><entry>load</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="locals_cmd"><title id="locals_cmd.title">Locals</title>
<para>Imprime uma lista com as variáveis e parâmetros locais da 'stylesheet'. Imprime o valor de uma variável local</para>
<table><title>Utilização do 'locals'</title>
<tgroup cols="1">
<tbody>
<row><entry>locals&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime uma lista com todas as variáveis disponíveis a nível local)</emphasis></entry></row>
<row><entry>locals -f&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime uma lista com todas as variáveis disponíveis a nível local, bem como os seus valores)</emphasis></entry></row>
<row><entry>locals &lt;QNAME&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime o valor da variável indicada)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="ls_cmd"><title id="ls_cmd.title">Ls</title>
<para>Apresenta os nós num formato breve</para>
<table><title>Utilização do 'ls'</title>
<tgroup cols="1">
<tbody>
<row><entry>ls</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="next_cmd"><title id="next_cmd.title">Next</title>
<para>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"</para>
<para>Nome de atalho: n</para>
<table><title>Utilização do 'next'</title>
<tgroup cols="1">
<tbody>
<row><entry>next&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(salta para a próxima instrução ao mesmo nível)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="options_cmd"><title id="options_cmd.title">Options</title>
<para>Imprime os valores das opções do 'xsldbg'</para>
<table><title>Utilização do 'options'</title>
<tgroup cols="1">
<tbody>
<row><entry>options</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="output_cmd"><title id="output_cmd.title">Output</title>
<para>Indica um ficheiro local e com permissões de escrita para onde gravar o resultado</para>
<para>Nome de atalho : o</para>
<table><title>Utilização do 'output'</title>
<tgroup cols="1">
<tbody>
<row><entry>output &lt;FICHEIRO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(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)</emphasis></entry></row>
<row><entry>output &lt;URI&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(O &lt;URI&gt; só poderá usar o protocolo "file://". Este é então convertido para um nome de ficheiro que possa ser adequado para o sistema operativo)</emphasis></entry></row>
<row><entry>output -&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>( Envia para o 'standard output'. Só poderá ser usado se usar a versão para a linha de comandos do 'xsldbg' )</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="public_cmd"><title id="public_cmd.title">Public</title>
<para>Imprime o valor que um ID público mapeia no catálogo actual</para>
<para>Nome de atalho : pub</para>
<table><title>Utilização do 'public'</title>
<tgroup cols="1">
<tbody>
<row><entry>public "&lt;IDPublico&gt;"</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="pwd_cmd"><title id="pwd_cmd.title">Pwd</title>
<para>Imprime a pasta de trabalho actual.</para>
<table><title>Utilização do 'pwd'</title>
<tgroup cols="1">
<tbody>
<row><entry>pwd</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="quit_cmd"><title id="quit_cmd.title">Quit</title>
<para>Pára o processamento da 'stylesheet' o mais cedo possível.</para>
<para>Nome de atalho: q</para>
<table><title>Utilização do 'quit'</title>
<tgroup cols="1">
<tbody>
<row><entry>quit</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="run_cmd"><title id="run_cmd.title">Run</title>
<para>Reinicia a 'stylesheet'.</para>
<para>Nome de atalho: r</para>
<table><title>Utilização do 'run'</title>
<tgroup cols="1">
<tbody>
<row><entry>run</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="save_cmd"><title id="save_cmd.title">Save</title>
<para>Grava as opções ou preferências de utilizador do 'xsldbg' no disco</para>
<table><title>Utilização do 'save'</title>
<tgroup cols="1">
<tbody>
<row><entry>save</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="search_cmd"><title id="search_cmd.title">Search</title>
<para>Procura numa base de dados com toda a informação extraída das 'stylesheets' carregadas</para>
<para>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. </para><para>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'. </para><para>Dependendo da quantidade de dados obtida, poderá levar algum tempo a terminar este comando. </para>
<table><title>Utilização do 'search'</title>
<tgroup cols="1">
<tbody>
<row><entry>search &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Vê o XPath que pode ser usado; veja em search.dtd. O &lt;XPATH&gt; por omissão é o '//search/*' )</emphasis></entry></row>
<row><entry>search -sort &lt;XPATH&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Diz ao 'search.xsl' para ordenar os resultados antes de os devolver)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="set_cmd"><title id="set_cmd.title">Set</title>
<para>Define o valor de uma variável</para>
<table><title>Utilização do 'set'</title>
<tgroup cols="1">
<tbody>
<row><entry>set &lt;NOME_VARIÁVEL&gt; &lt;XPATH&gt;</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="setoption_cmd"><title id="setoption_cmd.title">Setoption</title>
<para>Define uma opção para a execução da 'stylesheet'</para>
<para>Terá de usar o comando 'run' para activar as alterações</para>
<table><title>Utilização do 'setoption'</title>
<tgroup cols="1">
<tbody>
<row><entry>setoption &lt;NOME_OPÇÃO&gt; &lt;VALOR_INTEIRO&gt;</entry></row>
<row><entry>Onde o &lt;NOME_OPÇÃO&gt; tanto poderá ser</entry></row>
<row><entry>
    <para>
    <informaltable>
    <tgroup cols="1"><tbody>
    <row><entry>debug&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, faz uma visualização completa da árvore do resultado em alternativa)</emphasis></entry></row>
    <row><entry>catalogs&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, usa os catálogos de $SGML_CATALOG_FILES ou de SGML$CatalogFiles para o sistema operativo RISC)</emphasis></entry></row>
    <row><entry>html&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, o documento à entrada é um ficheiro em HTML)</emphasis></entry></row>
    <row><entry>docbook&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;INTEGER_VALUE&gt; for verdadeiro e o DocBook ainda for suportado pela 'libxml', o documento de entrada é em DocBook de SGML)</emphasis></entry></row>
    <row><entry>xinclude&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, será feito um processamento de XInclude no documento de entrada)</emphasis></entry></row>
    <row><entry>preferhtml&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, será usado como preferido um resultado em HTML. Veja o comando 'search')</emphasis></entry></row>
    <row><entry>autoencode&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, tenta usar a codificação da 'stylesheet')</emphasis></entry></row>
    <row><entry>utf8input&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; 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)</emphasis></entry></row>
    <row><entry>&nbsp;&nbsp;&nbsp;&nbsp;<emphasis></emphasis></entry></row>
    <row><entry>gdb&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Executa no modo de compatibilidade com o 'gdb')</emphasis> <para> <informaltable> <tgroup cols="1"><tbody>
        <row><entry>Para um valor igual a 1, isto significa <para> <informaltable> <tgroup cols="1"><tbody>
            <row><entry>Imprime bastante mais mensagens. Aumenta a frequência das mensagens "Ponto de paragem em ..."</entry></row>
            <row><entry>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</entry></row>
            <row><entry>Tanto as locais como as globais serão impressas quando for executado o comando "locals" </entry></row>
            <row><entry>Ao imprimir as expressões com o 'cat'/'print'. O valor avaliado será antecedido de um "= " &lt; EXPRESSÃO &gt;</entry></row>
            </tbody></tgroup>
            </informaltable>
            </para>
        </entry></row>
        <row><entry/></row>
        <row><entry>Para um valor igual a 2, significa <para> <informaltable> <tgroup cols="1"><tbody> <row><entry>Imprime as mensagens necessárias pelo KDbg, assim como o estado do 'output' acima (quando o valor é igual a 1) </entry></row>
            </tbody></tgroup>
            </informaltable>
            </para>
        </entry></row>
        </tbody></tgroup>
        </informaltable>
        </para>
    </entry></row>
    <row><entry>nonet&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, recusa-se a obter os DTDs ou entidades a partir da rede)</emphasis></entry></row>
    <row><entry>novalid&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, salta a fase de carregamento da DTD)</emphasis></entry></row>
    <row><entry>repeat&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, executa 20 vezes a transformação)</emphasis></entry></row>
    <row><entry>profile&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, apresenta as informações de análise)</emphasis></entry></row>
    <row><entry>timing&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, mostra o tempo consumido)</emphasis></entry></row>
    <row><entry>noout&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(se o &lt;VALOR_INTEIRO&gt; for verdadeiro, não apresenta o resultado)</emphasis></entry></row>
    </tbody></tgroup>
    </informaltable>
    </para>
</entry></row>
<row><entry>Onde o valor é verdadeiro, se NÃO for igual a zero</entry></row>
<row><entry>Onde o valor é falso, se FOR igual a zero</entry></row>
<row><entry>stdout&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>Imprime todas as mensagens de erro no 'stdout'. Normalmente, as mensagens de erro vão para o 'stderr'.</emphasis></entry></row>
<row><entry>setoption &lt;NOME_OPÇÃO&gt; "&lt;VALOR_TEXTO&gt;"&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Não deverá conter aspas no &lt;VALOR_TEXTO&gt;)</emphasis></entry></row>
<row><entry>setoption &lt;NOME_OPÇÃO&gt; &lt;VALOR_TEXTO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Não deverá conter quaisquer espaços, nem aspas, no &lt;VALOR_TEXTO&gt;)</emphasis></entry></row>
<row><entry>Onde o &lt;NOME_OPÇÃO&gt; tanto poderá ser</entry></row>
<row><entry>
    <para>
    <informaltable>
    <tgroup cols="1"><tbody>
    <row><entry>data&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(URI do ficheiro de dados)</emphasis></entry></row>
    <row><entry>source&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(URI do ficheiro de código)</emphasis></entry></row>
    <row><entry>output&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(IDSistema do ficheiro de saída)</emphasis></entry></row>
    <row><entry>docspath&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Local a usar quando procurar por documentação)</emphasis></entry></row>
    <row><entry>catalognames&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(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')</emphasis></entry></row>
    <row><entry>encoding&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Qual a codificação a usar para o 'standard output')</emphasis></entry></row>
    <row><entry>searchresultspath&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>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'</emphasis></entry></row>
    </tbody></tgroup>
    </informaltable>
    </para>
</entry></row></tbody>
</tgroup>
</table>
</sect1>

<sect1 id="shell_cmd"><title id="shell_cmd.title">Shell</title>
<para>Executar um comando da consola</para>
<table><title>Utilização do 'shell'</title>
<tgroup cols="1">
<tbody>
<row><entry>shell &lt;TEXTO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(o &lt;TEXTO&gt; é o texto a passar ao sistema operativo para ser executado)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="showbreak_cmd"><title id="showbreak_cmd.title">Showbreak</title>
<para>Para mostrar uma lista dos pontos de paragem dos modelos.</para>
<para>Nome de atalho: show</para><para>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á: <informaltable> <tgroup cols="1"><tbody>
<row><entry>Ponto de paragem 3 activo para o modelo :"*" no ficheiro teste1.xsl : linha 105</entry></row>
<row><entry>Ponto de paragem 2 activo para o modelo :"* modoTeste" no ficheiro teste1.xsl : linha 109</entry></row>
<row><entry>Ponto de paragem 1 activo para o modelo :"* http://www.w3.org/1999/XSL/Transform:modoTeste" no ficheiro teste1.xsl : linha 113</entry></row>
<row><entry/></row>
<row><entry>Um total de 3 pontos de paragem presentes</entry></row>
</tbody></tgroup></informaltable></para>
<table><title>Utilização do 'showbreak'</title>
<tgroup cols="1">
<tbody>
<row><entry>showbreak</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="showparam_cmd"><title id="showparam_cmd.title">Showparam</title>
<para>Imprime os parâmetros da 'libxslt' presentes</para>
<table><title>Utilização do 'showparam'</title>
<tgroup cols="1">
<tbody>
<row><entry>showparam</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="showwatch_cmd"><title id="showwatch_cmd.title">Showwatch</title>
<para>Mostra a expressão actual que está a ser vigiada</para>
<para>Nome de atalho: watches</para>
<table><title>Utilização do 'showwatch'</title>
<tgroup cols="1">
<tbody>
<row><entry>showwatch&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Mostra as vigias actuais e os seus valores)</emphasis></entry></row>
<row><entry>showwatch 1&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Activa a impressão automática das expressões vigiadas. Isto é usado por omissão.)</emphasis></entry></row>
<row><entry>showwatch 0&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Desactiva a impressão automática das expressões vigiadas.)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="source_cmd"><title id="source_cmd.title">Source</title>
<para>Muda para a visualização do nó actual na 'stylesheet' ou muda a 'stylesheet' usada</para>
<table><title>Utilização do 'source'</title>
<tgroup cols="1">
<tbody>
<row><entry>source&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Muda para o nó actual da 'stylesheet'.)</emphasis></entry></row>
<row><entry>source &lt;CÓDIGO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(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)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="step_cmd"><title id="step_cmd.title">Step</title>
<para>Avança até à próxima instrução da 'stylesheet'.</para>
<para>Nome de atalho: s</para>
<table><title>Utilização do 'step'</title>
<tgroup cols="1">
<tbody>
<row><entry>step</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="stepdown_cmd"><title id="stepdown_cmd.title">Stepdown</title>
<para>Avança, descendo para um novo nível da "pilha de chamadas". </para>
<para>Nome de atalho: down</para>
<table><title>Utilização do 'stepdown'</title>
<tgroup cols="1">
<tbody>
<row><entry>stepdown &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(desce um nível na pilha de chamadas)</emphasis></entry></row>
<row><entry>stepdown &lt;NUMERO_DE_TRAMAS&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(desce o número de níveis indicado na pilha de chamadas)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="stepup_cmd"><title id="stepup_cmd.title">Stepup</title>
<para>Volta para um nível superior na "pilha de chamadas". </para>
<para>Nome de atalho: up</para><para>Este não é um comando correcto, pelo que o 'xsldbg' irá parar assim que possa. </para>
<table><title>Utilização do 'stepup'</title>
<tgroup cols="1">
<tbody>
<row><entry>stepup &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(sobe um nível da pilha)</emphasis></entry></row>
<row><entry>stepup &lt;NUMERO_DE_TRAMAS&gt; &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(sobe o número indicado de níveis da pilha de chamadas)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="stylesheets_cmd"><title id="stylesheets_cmd.title">Stylesheets</title>
<para>Imprime uma lista com as 'stylesheets' carregadas</para>
<para>Nome de atalho: style</para>
<table><title>Utilização do 'stylesheets'</title>
<tgroup cols="1">
<tbody>
<row><entry>stylesheets</entry></row>
</tbody>
</tgroup>
</table>
</sect1>


<sect1 id="system_cmd"><title id="system_cmd.title">System</title>
<para>Imprime o valor que um ficheiro do sistema mapeia no catálogo actual</para>
<para>Nome de atalho : sys</para>
<table><title>Utilização do 'system'</title>
<tgroup cols="1">
<tbody>
<row><entry>system "&lt;IDSistema&gt;"</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="templates_cmd"><title id="templates_cmd.title">Templates</title>
<para>Imprime uma lista com os modelos disponíveis. Procura por um modelo</para>
<para>Nome de atalho: t</para>
<table><title>Utilização do 'templates'</title>
<tgroup cols="1">
<tbody>
<row><entry>templates</entry></row>
<row><entry>templates &lt;MODELO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Imprime os detalhes do modelo com o nome &lt;MODELO&gt; se existir)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="trace_cmd"><title id="trace_cmd.title">Trace</title>
<para>Faz um registo da execução da 'stylesheet', apresentando o ficheiro e os números de linha dos passos intermédios</para>
<table><title>Utilização do 'trace'</title>
<tgroup cols="1">
<tbody>
<row><entry>trace</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="tty_cmd"><title id="tty_cmd.title">Tty</title>
<para>Abre um terminal. Altera o nível de redireccionamento do TTY.</para>
<table><title>Utilização do 'tty'</title>
<tgroup cols="1">
<tbody>
<row><entry>tty &lt;LOCAL_DISPOSITIVO&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(em que o &lt;LOCAL_DISPOSITIVO&gt; é um terminal válido no sistema operativo. Tenta simplesmente aceder ao terminal</emphasis></entry></row>
<row><entry>tty &lt;NIVEL_TTY&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Altera o nível de redireccionamento do TTY, onde o &lt;NIVEL_TTY&gt; é um nível válido de entrada/saída a usar)</emphasis> <para> <informaltable> <tgroup cols="1"><tbody>
    <row><entry>Onde o 'nível' é </entry></row>
    <row><entry>0 = entrada/saída por omissão </entry></row>
    <row><entry>1 = Saída para o terminal dos resultados da transformação, do registo e do percurso &nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(O estado por omissão quando o dispositivo de TTY tiver sido aberto. Não está ainda completamente implementado.)</emphasis></entry></row>
    <row><entry>2 = Redireccionamento completo para o terminal&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Ainda não implementado.)</emphasis></entry></row>
    <row><entry>Todos os outros valores inteiros correspondem ao nível 0 </entry></row>
    </tbody>
    </tgroup>
    </informaltable>
</para>
</entry></row></tbody>
</tgroup>
</table>
</sect1>

<sect1 id="validate_cmd"><title id="validate_cmd.title">Validate</title>
<para>Valida o ficheiro de saída gerado pela 'stylesheet' (desactivado)</para>
<table><title>Utilização do 'validate'</title>
<tgroup cols="1">
<tbody>
<row><entry>validate</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="walk_cmd"><title id="walk_cmd.title">Walk</title>
<para>Percorre o código, usando um intervalo de velocidades</para>
<table><title>Utilização do 'walk'</title>
<tgroup cols="1">
<tbody>
<row><entry>walk &lt;VELOCIDADE&gt;&nbsp;&nbsp;&nbsp;&nbsp;<emphasis>(Use o Ctrl-c para parar a execução, a &lt;VELOCIDADE&gt; é um valor entre 0 e 9, em que o 0 significa parado, o 1 é muito rápido e o 9 é muito lento)</emphasis></entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="where_cmd"><title id="where_cmd.title">Where</title>
<para>Imprime um registo das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho.</para>
<para>Nome de atalho: w</para>
<table><title>Utilização do 'where'</title>
<tgroup cols="1">
<tbody>
<row><entry>where</entry></row>
</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="write_cmd"><title id="write_cmd.title">Write</title>
<para>A ser terminada</para>
<table><title>Utilização do 'write'</title>
<tgroup cols="1">
<tbody>
<row><entry>write</entry></row>
</tbody>
</tgroup>
</table>
</sect1>





</chapter>