[PATCH] Datacage ref doc: Explain dc:for-each

[Wald Commits]

# HG changeset patch
# User Sascha L. Teichmann <teichmann at intevation.de>
# Date 1381758786 -7200
# Node ID d29a5e703cc42eff7aa5afabd752ead60e0363c3
# Parent  d8ca7a1d522c3b4ed8b31dbb1655247ba7e7d445
Datacage ref doc: Explain dc:for-each

diff -r d8ca7a1d522c -r d29a5e703cc4 artifacts/doc/datacage_ref_de.rst
--- a/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 15:43:34 2013 +0200
+++ b/artifacts/doc/datacage_ref_de.rst	Mon Oct 14 15:53:06 2013 +0200
@@ -143,7 +143,7 @@
  +----+-------+
 
 Innerhalb eines `virtual-column`-Elementes kann der Datensatz mittel `dc:for-each` wie
-gewohnt realisiert werden. Wird das `dc:virtual-column`-Element verlassen, gilt wieder 
+gewohnt realisiert werden. Wird das `dc:virtual-column`-Element verlassen, gilt wieder
 der vormalige Datensatz ohne die zusätzlich Spalte.
 
 Datensätze einschränken
@@ -156,7 +156,48 @@
 Datensätze auffalten
 ~~~~~~~~~~~~~~~~~~~~
 
-``dc:for-each`` **TODO**
+``dc:for-each`` Realisieren eines Datensatzes
+.............................................
+
+.. code:: xml
+
+    <dc:for-each>
+      ...
+    <dc:for-each>
+
+Erzeugt nacheinander alle zeilenweisen Realisationen des aktuellen Datensatzes. Die
+einzelnen Spaltenwerte sind dann über Variablen erreichbar, die nach den Spaltenbezeichnern
+des Datenstzes benannt sind.
+
+Folgendes Beispiel soll den Sachverhalt illustieren:
+
+ +----+
+ +Zahl+
+ +====+
+ +   1+
+ +----+
+ +   2+
+ +----+
+ +   3+
+ +----+
+
+.. code:: xml
+
+    <zahlen>
+      <dc:for-each>
+        <zahl wert="$Zahl"/>
+      <dc:for-each>
+    </zahlen>
+
+Dies erzeugt folgende Ausgabe:
+
+.. code:: xml
+
+    <zahlen>
+        <zahl wert="1"/>
+        <zahl wert="2"/>
+        <zahl wert="3"/>
+    </zahlen>
 
 ``dc:iterate`` **TODO**