Second part of prior commit

1 files changed, 717 insertions, 0 deletions

diff --git a/tde-i18n-de/docs/tdewebdev/kommander/specials.docbook b/tde-i18n-de/docs/tdewebdev/kommander/specials.docbook
new file mode 100644
index 00000000000..5277f0036b0
--- /dev/null
+++ b/tde-i18n-de/docs/tdewebdev/kommander/specials.docbook
@@ -0,0 +1,717 @@
+<?xml version="1.0"  encoding="UTF-8" ?>
+
+<sect1 id="specials">
+<sect1info>
+<title
+>Anweisungen und eingebaute globale Variable</title>
+<authorgroup>
+<author
+><firstname
+></firstname
+> <surname
+></surname
+> <affiliation
+><address
+> <email
+></email>
+</address
+></affiliation>
+</author>
+
+<othercredit role="translator"
+><firstname
+>Georg</firstname
+><surname
+>Schuster</surname
+><affiliation
+><address
+><email
+>gschuster@utanet.at</email
+></address
+></affiliation
+><contrib
+>Deutsche Übersetzung</contrib
+></othercredit
+> 
+
+</authorgroup>
+</sect1info>
+
+<title
+>Anweisungen und eingebaute globale Variable</title>
+
+<para
+>Anweisungen sind Funktionen, die von &kommander; ausgeführt werden. Bis &kommander; über einem vollständigen Parser verfügt, werden alle Anweisungen vor dem Skript ausgeführt. Meistens ist das kein Problem. </para>
+
+<variablelist>
+<varlistentry>
+<term
+><function
+>@dcop(<parameter
+>AnwendungsId</parameter
+>, <parameter
+>Objekt</parameter
+>, <parameter
+>Funktion</parameter
+>, <parameter
+>Argumente</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Führe einen &DCOP; Aufruf durch. @dcop(<quote
+>kmail</quote
+>, <quote
+>KMailIface</quote
+>, <quote
+>checkMail()</quote
+>, <quote
+></quote
+>) </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@dcopid</function
+></term>
+<listitem>
+<para
+>Die &DCOP;-ID des Prozesses. (kmdr-executor-@pid) </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@dialog(<parameter
+>Dialog</parameter
+>[,<parameter
+>Parameter</parameter
+>])</function
+></term>
+<listitem>
+<para
+>Zeigt den bestimmten Kommander-Dialog an. Der Dialog wird im Dialogordner und im aktuellen Ordner gesucht, in dieser Reihenfolge. Das bestimmt den Aufruf von kommander-executor vor und setzt den Standardordner auf den Ordner, in dem sich die Kommander-Anwendung befindet. Parameter können im in Unix üblichen Weg oder namentlich wie z. B. <quote
+>Variable=Wert</quote
+> übergeben werden. Übergebene Parameter können im Globalbereich gefunden werden. @global(Variable) würde den <quote
+>Wert</quote
+> zurückgeben. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@env(<parameter
+>Umgebungsvariable</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Füllt die angegebene Umgebungsvariable aus. @env(PWD) setzt $PWD ein. Bitte beachten Sie, dass <quote
+>$</quote
+> ein Teil der Shell ist und nicht verwendet werden sollte. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@exec(<parameter
+>Befehl</parameter
+>)</function
+></term>
+<listitem>
+<para
+>liefert die Ausgabe des damit ausgeführten Befehls zurück. @exec(ls -l). </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@execBegin ... @execEnd</function
+></term>
+<listitem>
+<para
+>gleich wie <function
+>@exec</function
+>, unterstützt aber mehrzeilige um Ummantelungs-Skripte. Das dient für einige Skriptsprachen entweder über eine Deklaration oder mittels einer Ummantelung. </para>
+<itemizedlist>
+<listitem
+><para
+><function
+>@execBegin(php)</function
+></para
+></listitem>
+<listitem
+><para
+><function
+>@execBegin</function
+>#!/usr/bin/php</para
+></listitem>
+</itemizedlist>
+<para
+>Das Erste benutzt den Namen des <acronym
+>PHP</acronym
+>-Programms. &kommander; durchsucht den Pfad PATH nach <application
+>php</application
+> und sieht, wenn es nicht gefunden wird, nach. ob es mit &kommander; außerhalb des Pfades registriert ist. Ist dies nicht der Fall, meldet es dem Benutzer, dass es nicht gefunden werden konnte. Das zweite Beispiel benutzt die klassische <quote
+>Ummantelung</quote
+>, die Vorteile aber auch Probleme bringen kann. Wenn zum Beispiel eine Beta-Version von <acronym
+>PHP5</acronym
+> in <filename
+>/usr/local/bin</filename
+> vorhanden ist, die nicht gefunden wird, weil es  in <filename
+>/usr/bin</filename
+> eine gibt , wäre dies nützlich. Wird der Dialog aber von jemandem verwendet, der <acronym
+>PHP</acronym
+> nur in <filename
+>/usr/local/bin </filename
+>hat, würde es mit der Ummantelung nicht gefunden. Deshalb ist die Verwendung von Ummantelungen problematisch und die Verwendung des Programmes wird empfohlen, wenn die Dateien weitergegeben werden.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@global(<parameter
+>Variable</parameter
+>)</function
+></term>
+<listitem>
+<para
+>wird mit dem Inhalt der angegebenen globalen Variable ersetzt. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@null</function
+></term>
+<listitem>
+<para
+>Liefert Null zurück. Da &kommander; nun bei der Ausführung auf leere widgetText prüft, verhindert dies im Falle eines undefinierten Status des Bedienelementes Fehler.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@parentPid</function
+></term>
+<listitem>
+<para
+>Die &PID; des Vaterprozesses. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@pid</function
+></term>
+<listitem>
+<para
+>Die &PID; des Prozesses. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@readSetting(<parameter
+>Schlüssel</parameter
+>, <parameter
+>Standardwert</parameter
+>)</function
+></term>
+<listitem>
+<para
+>liest einen Wert aus der <filename
+>kommanderrc</filename
+> </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@selectedWidgetText</function
+></term>
+<listitem>
+<para
+>der ausgewählte Inhalt in einem Bedienelement, das mehrere Werte anzeigen kann, wie etwa Listen </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@setGlobal(<parameter
+>Variable</parameter
+>, <parameter
+>Wert</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Setzt die globale Variable auf den angegebenen Wert. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@widgetText</function
+></term>
+<listitem>
+<para
+>der Inhalt eines Bedienelementes </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@writeSetting(<parameter
+>Schlüssel</parameter
+>, <parameter
+>Wert</parameter
+>)</function
+></term>
+<listitem>
+<para
+>schreibe den Wert in die <filename
+>kommanderrc</filename
+> </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<sect2 id="arrays">
+<title
+>Feldfunktionengruppe (Arrays)</title>
+
+<variablelist>
+<varlistentry>
+<term
+><function
+>@Array.values(<parameter
+>Feld</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Gibt eine mit Zeilenschaltungen getrennte Liste aller Werte eines Feldes zurück. Kann zum Durchgehen eines Feldes verwendet werden.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.keys(<parameter
+>Feld</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Gibt eine mit Zeilenschaltungen getrennte Liste aller Schlüssel im Feld zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.setValue(<parameter
+>Feld</parameter
+>, <parameter
+>Schlüssel</parameter
+>, <parameter
+>Wert</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Setzt einen Schlüssel und Wert für ein Element eines Feldes. Wenn das Feld nicht existiert, wird es erstellt.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.clear(<parameter
+>Feld</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Entfernt alle Elemente aus einem Feld.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.count(<parameter
+>Feld</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert die Anzahl der Elemente in einem Feld.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.value(<parameter
+>Feld</parameter
+>,<parameter
+>Schlüssel</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Gibt den mit dem angegebenen Schlüssel verbundenen Wert zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.remove(<parameter
+>Feld</parameter
+>,<parameter
+>Schlüssel</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Entfernt das Element mit dem angegeben Schlüssel aus dem Feld.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.fromString(<parameter
+>Feld</parameter
+>,<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Fügt alle Elemente der Zeichenkette dem Feld hinzu. Die Zeichenkette sollte ein <emphasis
+>Schlüssel\tWert\n</emphasis
+> Format haben."</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@Array.toString(<parameter
+>Feld</parameter
+>,<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>"Liefert alle Elemente im Feld im <emphasis
+>Schlüssel\tWert\n</emphasis
+> Format."</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="files">
+<title
+>Dateifunktionengruppe</title>
+<variablelist>
+
+<varlistentry>
+<term
+><function
+>@File.read(<parameter
+>Datei</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert den Inhalt der angegebenen Datei zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@File.write(<parameter
+>Datei</parameter
+><parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Schreibt die angegebene Zeichenkette in eine Datei.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@File.append(<parameter
+>Datei</parameter
+><parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Hängt die angegebene Zeichenkette an das Ende der Datei an.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="strings">
+<title
+>Zeichenketten-Funktionengruppe</title>
+<variablelist>
+
+<varlistentry>
+<term
+><function
+>@String.length(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Gibt die Anzahl der Zeichen einer Zeichenkette zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.contains(<parameter
+>Zeichenkette</parameter
+>,<parameter
+>Unterzeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Prüft, ob die Zeichenkette die angegebene Teilzeichenkette enthält.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.find(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert die Position einer Teilzeichenkette in einer Zeichenkette, oder -1, wenn sie darin nicht gefunden wurde."</para>
+<note
+><para
+>Dies wird in Alpha6 eine optionale ganzzahlige Startposition zum Finden weiterer Treffer haben.</para
+></note>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.left(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Ganzzahl</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert die ersten n Zeichen der Zeichenkette zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.right(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Ganzzahl</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert die letzten n Zeichen der Zeichenkette zurück.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.mid(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Ganzzahl Start</parameter
+>, <parameter
+>Ganzzahl Ende</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Liefert eine Teilzeichenkette aus der Zeichenkette, beginnend mit der angegebene Position.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.remove(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Teilzeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Entfernt alle Vorkommen einer angegebenen Teilzeichenkette.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.replace(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Teilzeichenkette zu finden</parameter
+>, <parameter
+>Teilzeichenkette zu ersetzen</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Ersetzt alle Vorkommen einer angegebenen Teilzeichenkette mit dem angegebenen Ersatz.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.upper(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Wandelt die Zeichenkette in Großbuchstaben um.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.lower(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Wandelt die Zeichenkette in Kleinbuchstaben um.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.compare(<parameter
+>Zeichenkette</parameter
+>, <parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Vergleicht zwei Zeichenketten. Gibt 0 zurück, wenn sie gleich sind, -1, wenn die Erste kleiner ist und 1, wenn die Erste größer ist</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.isEmpty(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Prüft, ob die Zeichenkette leer ist.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><function
+>@String.isNumber(<parameter
+>Zeichenkette</parameter
+>)</function
+></term>
+<listitem>
+<para
+>Prüft, ob die Zeichenkette eine gültige Zahl ist.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+</sect2>
+
+<sect2 id="builtins">
+<title
+>Eingebaute globale Konstanten</title>
+<para
+>Eingebaute globale Konstanten werden gleich wie reguläre globale Variable mit <function
+>@global</function
+> angesprochen.</para>
+<variablelist>
+<varlistentry>
+<term
+><function
+>@global(_KDDIR)</function
+></term>
+<listitem>
+<para
+>Der Ordner, in dem sich der aktuelle Dialog befindet.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term
+><function
+>@global(_NAME)</function
+></term>
+<listitem
+><para
+>Der Name des Dialoges</para
+></listitem>
+</varlistentry>
+</variablelist>
+</sect2>
+
+</sect1>