<?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 % Italian "INCLUDE">
]>

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

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

<refnamediv>
<refname
><command
>xsldbg</command
></refname>
<refpurpose
>Uno strumento a linea di comando per il debug di script XSLT</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>xsldbg</command
> <group
><option
>--shell</option
></group
> <group
><option
>--cd &lt;PATH&gt;</option
></group
> <group
><option
>--param &lt;NAME&gt;:&lt;VALUE&gt;</option
></group
> <group
><option
>--lang &lt;LANG&gt;</option
></group
> <group
><option
>--output &lt;FILE&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
>Descrizione</title>

<para
>&xsldbg; è uno strumento il cui scopo è aiutare a capire i fogli di stile. Ciò che lo rende diverso da altri debugger di fogli di stile è la capacità di ricerca per oggetti d'interesse e di seguire l'esecuzione dei fogli di stile. </para>

<para
>&xsldbg; è uno strumento basato sul testo per il debug di fogli di stile (eXtensible Stylesheet Language) e ha comandi simili al debugger Unix/Linux gdb. Ha tre modalità principali di esecuzione di fogli di stile. </para>
<itemizedlist>
<listitem
><para
>Esegue il foglio di stile completo</para
></listitem>
<listitem
><para
>Passa alla prossima istruzione xsl</para
></listitem>
<listitem
><para
>Continua fino al raggiungimento del prossimo punto d'interruzione, o riavvia il fogli di stile</para
></listitem>
</itemizedlist>

</refsect1>



<refsect1>
<title
>Opzioni</title>

<variablelist>
<title
>Opzioni applicazione</title>
<para
>Nota: per disabilitare un'opzione aggiungi «no» prima del nome dell'opzione, eg «nonet»</para>
<para
>Nota: le opzioni che sono segnate con un «*» sono predefinite</para>
<varlistentry>
<term
><option
>--shell</option
></term>
<listitem
><para
>Avvia una shell, una volta avviata usa il comando di aiuto di &xsldbg; per avere aiuto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--cd &lt;PATH&gt;</option
></term>
<listitem
><para
>Percorso da trasformare prima di caricare i file. Vedi anche la documentazione del comando «cd»</para
></listitem>
</varlistentry>

<varlistentry>
	<term
><option
>--param &lt;NAME&gt;:&lt;VALUE&gt;</option
></term>
	<listitem
><para
>Aggiunge un parametro chiamato &lt;NAME&gt; e un valore &lt;VALUE&gt; all'ambiente XSL. Vedi anche la documentazione del comando «addparam»</para>
		<para
>Nota:A «=» può essere usato come nome, separatore di valore anziché «:»</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--lang &lt;LANG&gt;</option
></term>
<listitem
><para
>Usa la codifica ISO 639 specifica per il linguaggio; per esempio en_US</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--output &lt;FILE&gt;</option
></term>
<listitem
><para
>Salva in un dato file. Vedi anche la documentazione del comando di output</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--version</option
></term>
<listitem
><para
>Mostra la versione usata di libxml e libxslt</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--verbose</option
></term>
<listitem
><para
>Mostra i log di cosa sta accadendo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--timing</option
></term>
<listitem
><para
>Mostra il tempo usato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--repeat</option
></term>
<listitem
><para
>Esegue la trasformazione 20 volte, se --repeat è elencato due volte allora esegue la trasformazione 100 volte</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--debug</option
></term>
<listitem
><para
>Riversa l'albero dei risultati se libxml ha tale supporto abilitato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--valid*</option
></term>
<listitem
><para
>Abilita la fase di caricamento del DTD, è abilitata in modo predefinito</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--out*</option
></term>
<listitem
><para
>Abilita l'output del risultato, è abilitato in modo predefinito</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--maxdepth val</option
></term>
<listitem
><para
>Aumenta la profondità massima</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--html</option
></term>
<listitem
><para
>Il documento d'ingresso è (sono) file HTML se libxml ha tale supporto abilitato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--docbook</option
></term>
<listitem
><para
>Il documento in ingresso è un docbook SGML se libxml ha tale supporto abilitato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--net*</option
></term>
<listitem
><para
>Abilita il fetching del DTD sulle entita della rete, è abilitato in modo predefinito</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--catalogs</option
></term>
<listitem
><para
>Usa i cataloghi da $SGML_CATALOG_FILES se libxml ha tale supporto abilitato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--xinclude*</option
></term>
<listitem
><para
>Abilita l'elaborazione XInclude sul documento d'ingresso se libxml ha tale supporto abilitato, è abilitato in modo predefinito</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--profile</option
></term>
<listitem
><para
>Stampa informazioni del profilo</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--gdb*</option
></term>
<listitem
><para
>Esegue in modalità compatibile GDB e stampa più informazioni, è abilitato in modo predefinito</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autoencode*</option
></term>
<listitem
><para
>Rileva e usa la codifica nel foglio di stile</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--utf8input</option
></term>
<listitem
><para
>Tratta l'ingresso della linea di comando come codificato in UTF-8</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--preferhtml</option
></term>
<listitem
><para
>Usa l'output HTML quando genera risultati di ricerca</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stdout</option
></term>
<listitem
><para
>Stampa tutti i messaggi di errore nello stdout, normalmente i messaggi di errore vanno nello stderr</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autorestart</option
></term>
<listitem
><para
>Abilita il riavvio automatico dell'esecuzione quando l'elaborazione corrente è completa</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XSLSource</option
></term>
<listitem
><para
>Script XSL da eseguire (opzionale)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XMLData</option
></term>
<listitem
><para
>Dati XML da trasformare (opzionale se è specificato XSLSource)</para
></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>
<title
>Autori</title>
<para
>&xsldbg; adesso è scritto e mantenuto da Keith Isdale<email
>keith@kdewebdev.org</email
> </para>
</refsect1>


</refentry>
