[PATCH] Datacage ref doc: More docs for functions

[Wald Commits]

# HG changeset patch
# User Sascha L. Teichmann <teichmann at intevation.de>
# Date 1382454047 -7200
# Node ID f5948a07f3172b20b9f94923ab3dab904bf3e2a0
# Parent  2facd4066a28827b274fbc1c73ac1ba2690bbbbd
Datacage ref doc: More docs for functions.

diff -r 2facd4066a28 -r f5948a07f317 artifacts/doc/datacage_ref_de.rst
--- a/artifacts/doc/datacage_ref_de.rst	Tue Oct 22 16:24:08 2013 +0200
+++ b/artifacts/doc/datacage_ref_de.rst	Tue Oct 22 17:00:47 2013 +0200
@@ -682,6 +682,29 @@
 ``dc:replace-all('KlausGabiPeter', '(Klaus|Peter)', '>$1<')`` resultiert demnach
 in ``>Klaus<Gabi>Peter<``.
 
+``dc:find-all`` Extraktion von Strings aus einem String anhand eines regulären Ausdrucks
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``dc:find-all(Nadel, Heuhaufen)`` extrahiert aus einem String Heuhaufen all jene Substrings,
+die auf den regulären Ausdruck Nadel passen. Das Resultat dieser Funktion ist eine Liste
+von Strings. Sie ist leer, wenn das Muster nicht gefunden wurde.
+
+``dc:find-all('\d{4}', '1900 1930 1941 1960')`` liefert dem entsprechend die Liste
+``'1900'``, ``'1930'``, ``'1941'``, ``'1960'``.
+
+``dc:date-format`` Formatierte Ausgabe eines Datums
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``dc:date-format(Format, Datum)`` leifert für ein Datum Datum einen String, der
+nach den Formatierungsregeln aus Format formatiert wird. Für die Formatierungen
+gelten die in SimpleFormat_ beschriebenen Regeln.
+
+.. _SimpleFormat: http://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
+
+``dc::date-format(''dd.MM.yyyy', $datum,)`` liefert für ein ``$datum`` mit dem Wert 1. Dezember 1941
+den String ``01.12.1941``.
+
+
 ``dc:group-key`` Wert des aktuellen Gruppierungsschlüssels
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -693,17 +716,19 @@
 ``dc:dump-variables()`` liefert einen String mit der aktuellen Belegung aller Variablen.
 Dies ist zusammen mit ``dc:message`` nützlich, um eine Ablaufverfolgung zu implementieren.
 
-``dc:fromValue`` **TODO**
+``dc:get`` Dynamische Variablenauswertung
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-``dc:toValue`` **TODO**
-
-``dc:date-format`` **TODO**
-
-``dc:get`` **TODO**
+``dc:get(Variablenname)`` ermöglicht es, eine Variable über ihren Namen als String
+auszuwerten. Gegenüber der normalen XPath-Variablenauswertung kann die Variable auch
+null liefern. Bis auf diese Ausnahme ist der Aufruf ``dc:get('a')`` identisch zu ``$a``
+in XPath-Kontexten.
 
 ``dc:max-number`` **TODO**
 
 ``dc:min-number`` **TODO**
 
-``dc:find-all`` **TODO**
+``dc:fromValue`` **TODO**
 
+``dc:toValue`` **TODO**
+