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

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

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

<refnamediv>
<refname
><command
>xsldbg</command
></refname>
<refpurpose
>Ein Befehlszeilenprogramm für das Debuggen von XSLT-Skripten</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
>Beschreibung</title>

<para
>&xsldbg; ist ein Werkzeug zur Untersuchung von Stilvorlagen. Im Unterschied zu anderen Programmen für Stilvorlagen ist die Suche nach bestimmten Elementen möglich und die Ausführung der Stilvorlage kann verfolgt werden. </para>

<para
>&xsldbg; ist ein Programm zur Fehlersuche (debuggen) in XSL-Stilvorlagen (XSL = eXtensible Stylesheet Language). &xsldbg; hat ähnliche Befehle wie der Unix/Linux Debugger gdb. Es gibt drei Möglichkeiten, eine Stilvorlage auszuführen: </para>
<itemizedlist>
<listitem
><para
>Ausführung der gesamten Stilvorlage</para
></listitem>
<listitem
><para
>Schrittweise zum nächsten XSL-Befehl</para
></listitem>
<listitem
><para
>Ausführung  bis zum nächsten Haltepunkt oder bis zum Neustart der Stilvorlage</para
></listitem>
</itemizedlist>

</refsect1>



<refsect1>
<title
>Optionen</title>

<variablelist>
<title
>Anwendungsoptionen</title>
<para
>Hinweis: Um eine Option abzuschalten, setzen Sie ein „no“ vor den Namen der Option, &eg; „nonet“</para>
<para
>Hinweis: Alle mit „*“ markierten Optionen sind als Voreinstellung eingeschaltet</para>
<varlistentry>
<term
><option
>--shell</option
></term>
<listitem
><para
>Startet eine Shell. Geben Sie dann den &xsldbg;-Befehl „help“ ein, um eine Übersicht der Hilfe zu erhalten.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--cd &lt;PATH&gt;</option
></term>
<listitem
><para
>Pfad zum Ordner, in den vor dem Laden von Dateien gewechselt werden soll. Sihe auch die Dokumentation zum Befehl „cd“</para
></listitem>
</varlistentry>

<varlistentry>
	<term
><option
>--param &lt;NAME&gt;:&lt;VALUE&gt;</option
></term>
	<listitem
><para
>Fügt den Parameter mit dem Namen &lt;NAME&gt; und dem Wert &lt;VALUE&gt; zu den XSL-Umgebungsvariablen hinzu. Siehe auch die Dokumentation zum Befehl  „addparam“</para>
		<para
>Hinweis: Auch das Zeichen „=“ kann anstelle des „:“ als Trennung zwischen Name und Wert benutzt werden</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--lang &lt;LANG&gt;</option
></term>
<listitem
><para
>Verwendet den angegebenen ISO-639-Sprachcode, zum Beispiel de_DE</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--output &lt;FILE&gt;</option
></term>
<listitem
><para
>Speichert in eine angegebene Datei. Siehe die Dokumentation zu Ausgabebefehlen</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--version</option
></term>
<listitem
><para
>Zeigt die Version von libxml und libxslt an</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--verbose</option
></term>
<listitem
><para
>Zeigt Protokolle über den Ablauf an</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--timing</option
></term>
<listitem
><para
>Zeigt die verstrichene Zeit an</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--repeat</option
></term>
<listitem
><para
>Führt die Umwandlung 20 mal aus, wenn --repeat zweifach aangegeben ist, wird die Umwandlung 100 mal ausgeführt</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--debug</option
></term>
<listitem
><para
>Ausgabe des Ergebnisbaums, wenn die Unterstützung dafür in libxml aktiviert worden ist</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--valid*</option
></term>
<listitem
><para
>Führt den DTD-Ladevorgang aus, das ist als Voreinstellung eingeschaltet</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--out*</option
></term>
<listitem
><para
>Aktiviert die Ausgabe des Ergebnisses, das ist als Voreinstellung eingeschaltet</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--maxdepth val</option
></term>
<listitem
><para
>Vergrößert die maximale Tiefe</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--html</option
></term>
<listitem
><para
>Die Eingabedokumente werden als HTML-Dateien behandelt, wenn die Unterstützung dafür in libxml aktiviert worden ist</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--docbook</option
></term>
<listitem
><para
>Das Eingabedokument wird als SGML-Docbook behandelt, wenn die Unterstützung dafür in libxml aktiviert worden ist</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--net*</option
></term>
<listitem
><para
>Ermöglicht das Laden von DTDs oder Entitäten über das Netzwerk, das ist als Voreinstellung eingeschaltet</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--catalogs</option
></term>
<listitem
><para
>Verwendet die Kataloge in $SGML_CATALOG_FILES, wenn die Unterstützung dafür in libxml aktiviert worden ist</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--xinclude*</option
></term>
<listitem
><para
>Aktiviert die XInclude-Verarbeitung des Eingabedokuments, wenn die Unterstützung dafür in libxml aktiviert worden ist. Das ist als Voreinstellung eingeschaltet</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--profile</option
></term>
<listitem
><para
>Profiling-Informationen drucken</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--gdb*</option
></term>
<listitem
><para
>Ausführung im GDB-Kompalibitätsmodus mit ausführlichen Informationen, das ist als Voreinstellung eingeschaltet</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autoencode*</option
></term>
<listitem
><para
>Sucht nach einer Kodierung in der Stilvorlage und benutzt diese Kodierung</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--utf8input</option
></term>
<listitem
><para
>Behandelt die Befehlszeileneingabe als UTF-8 kodiert</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--preferhtml</option
></term>
<listitem
><para
>Verwendet HTML-Ausgabe beim Erstellen der Suchergebnisse</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--stdout</option
></term>
<listitem
><para
>Druckt alle Fehlermeldungen nach stdout, normalerweise gehen Fehlermeldungen nach stderr</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>--autorestart</option
></term>
<listitem
><para
>Schaltet den automatischen Neustart der Ausführung ein, wenn der gegenwärtige Durchlauf beendet ist</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XSLSource</option
></term>
<listitem
><para
>XSL-Skript zum Ausführen (optional)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><option
>+XMLData</option
></term>
<listitem
><para
>XML-Dateen zur Umwandlung (optional wenn die XSL-Quelle angegeben wurde)</para
></listitem>
</varlistentry>

</variablelist>

</refsect1>

<refsect1>
<title
>Autor</title>
<para
>&xsldbg; wurde von Keith Isdale<email
>keith@kdewebdev.org</email
> geschrieben. Er ist auch der derzeitige Betreuer. </para>
</refsect1>


</refentry>
