<?xml version="1.0" encoding="UTF-8" ?>
<chapter id="using-xsldbg">
<title
>Arbeiten mit &xsldbg;</title>
<para
></para>
<sect1
><title
>xsldbg Befehlszeilen-Argumente</title>
<para
>Auf Systemen mit installierter Readline-Bibliothek können Sie mit den Pfeiltasten auf/ab durch den Verlaufsspeicher der bisher ausgeführten Befehle blättern.  </para>
<para
>Dateinamen werden erweitert, sofern das Betriebssystem dies unterstützt.</para>
<para
>Mehrere Befehle erfordern mehr als ein Argument. Anführungszeichen können benutzt werden, um zusammengesetzte Ausdrücke als ein Argument zu übergeben. &eg;: mit dem Befehl „break &quot;* | @&quot;“ als Argument wird ein Haltepunkt in einer Datei mit dem Namen „break &quot;* | @&quot;“ gesetzt. </para>
</sect1>

<sect1 id="legend"
><title
>Erklärung der Begriffe</title>
<para
>Die folgende Tabelle beschreibt alle Begriffe, die in der nachfolgenden Befehlsreferenz verwendet werden.</para>
<informaltable>
<tgroup cols="1"
><tbody>
     <row
><entry
>TEMPLATE_NAME : Ein gültiger Name einer Vorlage, der nur aus den ASCII-Zeichen 0x00 bis 0x7F besteht. Dieser Name kann ein vollständig qualifizierter Name wie  „xsl:templateName“ sein. </entry
></row>
     <row
><entry
>FILENAME : Ein gültiger lokaler Dateiname auf dem System des Benutzes. Auf Unix- oder Cygwin-Systemen darf der Name das Präfix „~“ als Kurzform für den persönlichen Ordner haben. Auf RISC-OS-Systemen sind auch weitere Umgebungsvariablen erlaubt. </entry
></row>
     <row
><entry
>URI : Ein Uniform Resource Identifier (engl. „einheitlicher Bezeichner für Ressourcen“) definiert in RFC 2396</entry
></row>
     <row
><entry
>MODE_NAME: Der Modus einer Vorlage, der auch ein voll qualifizierter Name wie „xsl:modeName“ sein darf.</entry
></row>
     <row
><entry
>QNAME : Ein voll qualifizierter (ausgeschriebener) Name. Zum Beispiel  <quote
>xsl:localPart</quote
></entry
></row>
     <row
><entry
>LINENO : Eine gültige Zeilennummer in der Datei  &lt;FILENAME&gt;</entry
></row>
     <row
><entry
>NUMBER_OF_FRAMES : Eine gültige Anzahl von Frames für die Änderung der Position</entry
></row>
     <row
><entry
>BREAKPOINT_ID : Eine gültige Haltepunktnummer</entry
></row>
     <row
><entry
>WATCH_ID : Die Nummer eines gültigen Überwachungsausdrucks wie er vom Befehl „showwatch“ angezeigt wird</entry
></row>
     <row
><entry
>SPEED: Ausführungsgeschwindigkeit mit einem Wert zwischen 0 und 9</entry
></row>
     <row
><entry
>&nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(Kommentar)</emphasis
>: Ein Kommentar über die Auswirkung oder Bedeutung eines Befehls </entry
></row>
     <row
><entry
>{ opt1 | opt2 | opt2 .. &etc;} : Eine der Optionen wird aausgewählt</entry
></row>
     <row
><entry
>XPATH : Eine XPath-Auswahl eines oder mehrere Knoten</entry
></row>
     <row
><entry
>PARAM_ID : Eine gültige Parameternummer wie sie vom Befehl showparam angezeigt wird</entry
></row>
     <row
><entry
>PARAM_NAME : Ein gültiger Parametername wie er vom Befehl showparam angezeigt wird</entry
></row>
     <row
><entry
>PATH : Ein Pfad zum Wechseln des Arbeitsordners. Auf einigen Betriebssystemen wird das Präfix „~“ durch den Pfad zu Ihrem persönlichen Ordner ersetzt. </entry
></row>
     <row
><entry
>TEXT : Beliebiger Text &nbsp;&nbsp;&nbsp;&nbsp;<emphasis
>(keine Einschränkungen)</emphasis
> </entry
></row>
     <row
><entry
>COMMAND : Ein gültiger Befehl für xsldbg</entry
></row>
     <row
><entry
>QNAME: Ein gültiger Parameter- oder Variablenname</entry
></row>
     <row
><entry
>SOURCE : Die auszuführende Stilvorlage. Siehe auch &lt;FILENAME&gt; und &lt;URI&gt;</entry
></row>
     <row
><entry
>DATA: Die XML-Daten oder das XML_Dokument, das von der Stilvorlage bearbeitet wird. Siehe auch &lt;FILENAME&gt; und &lt;URI&gt; </entry
></row>
     <row
><entry
>DEVICE_PATH : Ein gültiges Terminal des Betriebssystems</entry
></row>
     <row
><entry
>TTY_LEVEL : Eine gültige Nummer eines Terminals zur Ein- und Ausgabe</entry
></row>
</tbody
></tgroup
></informaltable>
<para
></para>
</sect1>

<sect1 id="command_summary"
><title
>Übersicht der vorhandenen Befehle</title>
<informaltable>
<tgroup cols="1"
><tbody>
<row
><entry
>Hilfe:<link linkend="help_cmd" endterm="help_cmd.title"
>help</link
></entry
></row>
<row
><entry
>Laufzeitbefehle : {<link linkend="bye_cmd" endterm="bye_cmd.title"
>bye</link
>|<link linkend="exit_cmd" endterm="exit_cmd.title"
>exit</link
>|    <link linkend="quit_cmd" endterm="quit_cmd.title"
>quit</link
>}, <link linkend="step_cmd" endterm="step_cmd.title"
>step</link
>, <link linkend=   "stepup_cmd" endterm="stepup_cmd.title"
>stepup</link
>, <link linkend="stepdown_cmd" endterm="stepdown_cmd.title"
>stepdown</link
>, <link    linkend="next_cmd" endterm="next_cmd.title"
>next</link
>, <link linkend="continue_cmd" endterm="continue_cmd.title"
>continue</link
>, <link    linkend="run_cmd" endterm="run_cmd.title"
>run</link
>, <link linkend="trace_cmd" endterm="trace_cmd.title"
>trace</link
>, <link linkend=   "setoption_cmd" endterm="setoption_cmd.title"
>setoption</link
>, <link linkend="options_cmd" endterm="options_cmd.title"
>options</link
> </entry
></row>
<row
><entry
>Libxslt Parameter/Optionen : <link linkend="addparam_cmd" endterm="addparam_cmd.title"
>addparam</link
>, <link linkend="delparam_cmd"    endterm="delparam_cmd.title"
>delparam</link
>, <link linkend="showparam_cmd" endterm="showparam_cmd.title"
>showparam</link
>, <link linkend=   "output_cmd" endterm="output_cmd.title"
>output</link
>, <link linkend="setoption_cmd" endterm="setoption_cmd.title"
>setoption</link
>, <link    linkend="options_cmd" endterm="options_cmd.title"
>options</link
> <link linkend="readconfig_cmd" endterm="readconfig_cmd.title"
>readconfig</link
> <link linkend="writeconfig_cmd" endterm="writeconfig_cmd.title "
>writeconfig</link
> </entry
></row>
<row
><entry
>Vorlagenbefehle : <link linkend="templates_cmd" endterm="templates_cmd.title"
>templates</link
>, <link linkend="where_cmd" endterm="where_cmd.title"
>where</link
>, <link linkend="frame_cmd" endterm="frame_cmd.title"
>frame</link
> </entry
></row>
<row
><entry
>Haltepunktbefehle: <link linkend="break_cmd" endterm="break_cmd.title"
>break</link
>, <link linkend="showbreak_cmd" endterm="showbreak_cmd.title"
>showbreak</link
>, <link linkend="delete_cmd" endterm="delete_cmd.title"
>delete</link
>, <link linkend="enable_cmd" endterm="enable_cmd.title"
>enable</link
> </entry
></row>
<row
><entry
>Anzeige von Ausdrücken (xpath) : <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
> </entry
></row>
<row
><entry
>Anzeige von Knoten: <link linkend="ls_cmd" endterm="ls_cmd.title"
>ls</link
>, <link linkend="dir_cmd" endterm="dir_cmd.title"
>dir</link
>, <link linkend="du_cmd" endterm="du_cmd.title"
>du</link
>, <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
>, <link linkend="pwd_cmd" endterm="pwd_cmd.title"
>pwd</link
> </entry
></row>
<row
><entry
>Anzeige von Variablen: <link linkend="globals_cmd" endterm="globals_cmd.title"
>globals</link
>, <link linkend="locals_cmd" endterm="locals_cmd.title"
>locals</link
>, <link linkend="cat_cmd" endterm="cat_cmd.title"
>cat</link
>, <link linkend="addwatch_cmd" endterm="addwatch_cmd.title"
>addwatch</link
> </entry
></row>
<row
><entry
>Einstellung von Variablen:: <link linkend="set_cmd" endterm="set_cmd.title"
>set</link
> </entry
></row>
<row
><entry
>Knotenauswahl : <link linkend="source_cmd" endterm="source_cmd.title"
>source</link
>, <link linkend="data_cmd" endterm="data_cmd.title"
>data</link
>, <link linkend="cd_cmd" endterm="cd_cmd.title"
>cd</link
> </entry
></row>
<row
><entry
>Suchen :<link linkend="search_cmd" endterm="search_cmd.title"
>search</link
> </entry
></row>
<row
><entry
>Betriebssystembefehle: <link linkend="chdir_cmd" endterm="chdir_cmd.title"
>chdir</link
>, <link linkend="shell_cmd" endterm="shell_cmd.title"
>shell</link
>, <link linkend="tty_cmd" endterm="tty_cmd.title"
>tty</link
></entry
></row>
<row
><entry
>Dateibefehle: <link linkend="output_cmd" endterm="output_cmd.title"
>output</link
>, <link linkend="entities_cmd" endterm="entities_cmd.title"
>entities</link
>, <link linkend="system_cmd" endterm="system_cmd.title"
>system</link
>, <link linkend="public_cmd" endterm="public_cmd.title"
>public</link
> </entry
></row>
<row
><entry
>Nicht aktivierte Dateibefehle: <link linkend="validate_cmd" endterm="validate_cmd.title"
>validate</link
>, <link linkend="load_cmd" endterm="load_cmd.title"
>load</link
>, <link linkend="save_cmd" endterm="save_cmd.title"
>save</link
>, <link linkend="write_cmd" endterm="write_cmd.title"
>write</link
>, <link linkend="free_cmd" endterm="free_cmd.title"
>free</link
> </entry
></row>
</tbody
></tgroup
></informaltable>
</sect1>

</chapter>

