<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY xsldbg "<application
>xsldbg</application
>">
  <!ENTITY kappname "&xsldbg;">
  <!ENTITY package "kdewebdev">
  <!ENTITY % addindex "IGNORE">
<!ENTITY % Brazilian-Portuguese "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<author
><personname
><firstname
>Keith</firstname
><surname
>Isdale</surname
></personname
><email
>keith@kdewebdev.org</email
></author>
<date
>27 de março de 2006</date>
</refentryinfo>

<refmeta>
<refentrytitle
><command
>xsldbg</command
></refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
><command
>xsldbg</command
></refname>
<refpurpose
>Uma ferramenta da linha de comando para depurar arquivos XSLT</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>xsldbg</command
> <group
><option
>--shell</option
></group
> <group
><option
>--cd &lt;PASTA&gt;</option
></group
> <group
><option
>--param &lt;NOME&gt;:&lt;VALOR&gt;</option
></group
> <group
><option
>--lang &lt;LÍNGUA&gt;</option
></group
> <group
><option
>--output &lt;ARQUIVO&gt;</option
></group
> <group
><option
>--version</option
></group
> <group
><option
>--verbose</option
></group
> <group
><option
>--timing</option
></group
> <group
><option
>--repeat</option
></group
> <group
><option
>--debug</option
></group
> <group
><option
>--valid</option
></group
> <group
><option
>--out</option
></group
> <group
><option
>--maxdepth val</option
></group
> <group
><option
>--html</option
></group
> <group
><option
>--docbook</option
></group
> <group
><option
>--net</option
></group
> <group
><option
>--catalogs</option
></group
> <group
><option
>--xinclude</option
></group
> <group
><option
>--profile</option
></group
> <group
><option
>--gdb</option
></group
> <group
><option
>--autoencode</option
></group
> <group
><option
>--utf8input</option
></group
> <group
><option
>--preferhtml</option
></group
> <group
><option
>--stdout</option
></group
> <group
><option
>--autorestart</option
></group
> <group
><option
>+XSLSource</option
></group
> <group
><option
>+XMLData</option
></group
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>O &xsldbg; é uma ferramenta que procura ajudar a compreender as folhas de estilo. O que o torna diferente em relação aos outros depuradores de folhas de estilo é a capacidade de procurar por itens de interesse e de rastrear a execução da folha de estilo. </para>

<para
>O &xsldbg; é uma ferramenta baseada em texto para depurar 'stylesheets' ou folhas de estilo (na linguagem eXtensible Stylesheet Language) e tem comandos semelhantes ao depurador 'gdb' do Unix/Linux. Ele tem três modos importantes de execução das 'stylesheets'. </para>
<itemizedlist>
<listitem
><para
>Executar a 'stylesheet' por completo</para
></listitem>
<listitem
><para
>Saltar para a próxima instrução de XSL</para
></listitem>
<listitem
><para
>Continuar até ao próximo ponto de parada ou reiniciar a 'stylesheet'</para
></listitem>
</itemizedlist>

</refsect1>



<refsect1>
<title
>Opções</title>

<variablelist>
<title
>Opções do aplicativo</title>
<para
>Nota: Para desativar uma opção, acrescente um 'no' antes do nome da opção, como por exemplo 'nonet'</para>
<para
>Nota: As opções marcadas com um '*' estão ativas por padrão</para>
<varlistentry>
<term
><option
>--shell</option
></term>
<listitem
><para
>Inicia uma linha de comando. Uma vez iniciada, use a ajuda do &xsldbg; para obter alguma ajuda em tempo de execução.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--cd &lt;LOCALIZAÇÃO&gt;</option
></term>
<listitem
><para
>Local para onde mudar antes de carregar os arquivos. Veja também a documentação do comando 'cd'</para
></listitem>
</varlistentry>

<varlistentry>
	<term
><option
>--param &lt;NOME&gt;:&lt;VALOR&gt;</option
></term>
	<listitem
><para
>Adiciona um parâmetro chamado &lt;NOME&gt; e com valor &lt;VALOR&gt; ao ambiente da XSL. Veja também a documentação do comando 'addparam'</para>
		<para
>Nota: Um '=' poderá ser usado como um separador entre nome e valor, em vez do ':'</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--lang &lt;LÍNGUA&gt;</option
></term>
<listitem
><para
>Usar o código da língua do ISO 639 indicado; por exemplo 'pt'</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--output &lt;ARQUIVO&gt;</option
></term>
<listitem
><para
>Salva para um determinado arquivo. Veja a documentação do comando 'output'</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--version</option
></term>
<listitem
><para
>Mostrar a versão da 'libxml' e da 'libxslt' usadas</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--verbose</option
></term>
<listitem
><para
>Mostrar registros do que está ocorrendo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--timing</option
></term>
<listitem
><para
>Mostrar o tempo usado</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--repeat</option
></term>
<listitem
><para
>Executa a transformação 20 vezes; se o '--repeat' for indicado duas vezes, então executa a transformação 100 vezes</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--debug</option
></term>
<listitem
><para
>Devolve a árvore do resultado, no caso de a 'libxml' ter esse suporte ativo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--valid*</option
></term>
<listitem
><para
>Ativa a fase de leitura do DTD; por padrão, a opção está ativa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--out*</option
></term>
<listitem
><para
>Ativa a apresentação do resultado; por padrão, a opção está ativa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--maxdepth val</option
></term>
<listitem
><para
>Aumentar a profundidade máxima</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--html</option
></term>
<listitem
><para
>Os documentos de entrada são arquivos HTML; deve tratá-los como tal, desde que a 'libxml' tenha esse suporte ativo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--docbook</option
></term>
<listitem
><para
>O documento de entrada é um DocBook em SGML, caso a 'libxml' tenha esse suporte ativo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--net*</option
></term>
<listitem
><para
>Desativar a obtenção dos DTDs ou das entidades da rede; por padrão, a opção está ativa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--catalogs</option
></term>
<listitem
><para
>Usar os catálogos do $SGML_CATALOG_FILES, caso a 'libxml' tenha esse suporte ativo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--xinclude*</option
></term>
<listitem
><para
>Ativa o processamento do XInclude na entrada do documento, caso a 'libxml' tenha esse suporte ativo; por padrão, a opção está ativa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--profile</option
></term>
<listitem
><para
>Imprimir as informações de análise</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--gdb*</option
></term>
<listitem
><para
>Roda o modo de compatibilidade com o 'gdb' e imprime mais dados; por padrão, esta opção está ativa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autoencode*</option
></term>
<listitem
><para
>Detectar e usar as codificações da folha de estilo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--utf8input</option
></term>
<listitem
><para
>Trata a entrada da linha de comando como UTF-8 codificado</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--preferhtml</option
></term>
<listitem
><para
>Usar o resultado em HTML ao gerar os relatórios de procura</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stdout</option
></term>
<listitem
><para
>Imprimir todas as mensagens de erro no 'stdout', embora normalmente estas vão para o 'stderr'</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autorestart</option
></term>
<listitem
><para
>Ativa o reinício da execução quando o passo de processamento atual terminar</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XSLSource</option
></term>
<listitem
><para
>O arquivo de XSL a executar (opcional)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XMLData</option
></term>
<listitem
><para
>Os dados em XML a transformar (opcional se a XSLSource for usada)</para
></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>
<title
>Autores</title>
<para
>O &xsldbg; é desenvolvido e mantido de momento por Keith Isdale <email
>keith@kdewebdev.org</email
> </para>
</refsect1>


</refentry>
