[PATCH] Datacage ref doc: Explain dc:variable and dc:convert

[Wald Commits]

# HG changeset patch
# User Sascha L. Teichmann <teichmann at intevation.de>
# Date 1381754451 -7200
# Node ID 52bc38e6bbe1a70c90ead866a28b2a850df3f826
# Parent  8498fdd71a1e5d9df612a11c1458e90d452bdc9b
Datacage ref doc: Explain dc:variable and dc:convert.

diff -r 8498fdd71a1e -r 52bc38e6bbe1 artifacts/doc/datacage_ref_de.rst
--- a/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 13:44:54 2013 +0200
+++ b/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 14:40:51 2013 +0200
@@ -154,6 +154,7 @@
 
 ``dc:comment`` Kommentare im Beschreibungsdokument
 ..................................................
+
 .. code:: xml
 
     <dc:comment>
@@ -165,12 +166,44 @@
 Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen!
 
 
-``dc:message`` **TODO**
+``dc:message`` Ausgabe auf die Diagnoseausgabe (Log)
+....................................................
 
-``dc:variable`` **TODO**
+.. code:: xml
 
-``dc:convert`` **TODO**
+    <dc:message>
+      Text für die Diagnose.
+    </dc:message>
 
+Gibt den Text innerhalb des Elementes aus Ausgabe im Log aus. Dies dient in erster Linie
+dem Nachvollziehen von Aufrufen innerhalb des Datenkorbdokumentes. Für den Text gelten
+die `{$}-Ersetzungen`_.
+
+``dc:variable`` Erzeugung einer kontext-lokalen Variablen
+.........................................................
+
+.. code:: xml
+
+    <dc:variable name="Name" type="Typ" expr="XPath-Ausdruck"/>
+
+Legt im aktuellen Kontext eine lokale Variable namens Name an. Diese hat den
+Typ Typ und entsteht durch Auswertung des XPath-Ausdruck expr. Der Typ
+ist optional. Wird dieser nicht gesetzt, wird das Ergebnis als String interpretiert.
+Alternativ können hier die Werte 'number' für Zahlen, 'bool' für Boolean-Werte
+benutzt werden. Für den Namen und den Typ gelten die `${}-Ersetzungen`_.
+Wird der aktuellen `dc:context` verlassen, ist diese Variable nicht mehr definiert.
+
+
+``dc:convert`` kontext-lokale Konvertierung von Variablen
+.........................................................
+
+.. code:: xml
+
+    <dc:convert name="Name" type="Typ"/>
+
+Konvertiert die Variable namens Name für die Gültigkeit des aktuellen Kontextes in
+einen anderen Typ. Für Name und Typ gelten die `${}-Ersetzungen`_. Für die
+Typen gilt das gleiche wie für die Typen von `dc:variable`.
 
 Bedingte Ausführung
 ~~~~~~~~~~~~~~~~~~~