[DOCUMENTATION] German:

-  sync up to r16161

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16277 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/de/module_specs/Zend_Application-TheoryOfOperation.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15823 -->
+<!-- EN-Revision: 16067 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.application.theory-of-operation">
     <title>Theorie der Funktionsweise</title>
@@ -596,7 +596,7 @@ class My_Resource_View extends Zend_Application_Resource_ResourceAbstract
 
             $viewRenderer =
                 Zend_Controller_Action_HelperBroker::getStaticHelper(
-                    'ViewRenderer',
+                    'ViewRenderer'
                 );
             $viewRenderer->setView($view);
 

documentation/manual/de/module_specs/Zend_Auth_Adapter_DbTable.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15860 -->
+<!-- EN-Revision: 16050 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.auth.adapter.dbtable">
 
@@ -340,9 +340,9 @@ $adapter = new Zend_Auth_Adapter_DbTable(
             <methodname>authenticate()</methodname> platziert werden.
         </para>
         <para>
-            Als Beispiel einer Situation könnte man die getDbSelect() Methode verwenden um
-            den Status eines Benutzers zu prüfen, in anderen Worten sehen ob der Account des
-            Benutzers aktiviert ist.
+            Als Beispiel einer Situation könnte man die <methodname>getDbSelect()</methodname>
+            Methode verwenden um den Status eines Benutzers zu prüfen, in anderen Worten sehen ob
+            der Account des Benutzers aktiviert ist.
         </para>
         <programlisting language="php"><![CDATA[
 // Das Beispiel von oben weiterführen

documentation/manual/de/module_specs/Zend_Captcha-Operation.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15974 -->
+<!-- EN-Revision: 16125 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.captcha.operation">
     <title>Captcha Anwendung</title>
@@ -61,11 +61,14 @@ $captcha = new Zend_Captcha_Figlet(array(
 ));
 
 $id = $captcha->generate();
+echo "<form method=\"post\" action=\"\">";
 echo $captcha->render($view);
+echo "</form>";
 
 // Eine nachfolgende Anfrage:
-// Annahme das das Captcha vorher eingestellt wurde, und $value der
-// übertragene Wert ist:
+// Angenommen das Captcha wurde wie vorher eingestellt, dann wäre der Wert von
+// $_POST['foo'] ein Schlüssel/Wert Array:
+// id => captcha ID, input => captcha value
 if ($captcha->isValid($_POST['foo'], $_POST)) {
     // Validated!
 }

documentation/manual/de/module_specs/Zend_Console_Getopt-Introduction.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 16050 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.console.getopt.introduction">
     <title>Einführung</title>
@@ -105,7 +105,7 @@
             die Kommandozeile zu analysieren und bietet Objekt-Orientierte Methoden
             für die Abfrage welche Optionen durch den Benutzer angegeben wurden.
             Aber der Code um diese Informationen zu Verwenden und Teile der eigenen
-            Anwendung aufzurufen sollten in einer anderen PHP Klasse sein.
+            Anwendung aufzurufen sollten in einer anderen <acronym>PHP</acronym> Klasse sein.
         </para>
     </note>
     <para>

documentation/manual/de/module_specs/Zend_Console_Getopt-Rules.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15848 -->
+<!-- EN-Revision: 16050 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.console.getopt.rules">
     <title>Definieren von Getopt Regeln</title>
@@ -26,7 +26,7 @@
         <title>Optionen mit der kurzen Syntax definieren</title>
         <para>
             <classname>Zend_Console_Getopt</classname> unterstützt eine kompakte Syntax wie Sie
-            durch GNU Getopt verwendet wird (siehe <ulink
+            durch <acronym>GNU</acronym> Getopt verwendet wird (siehe <ulink
                 url="http://www.gnu.org/software/libc/manual/html_node/Getopt.html">http://www.gnu.org/software/libc/manual/html_node/Getopt.html</ulink>).
             Diese Syntax unterstützt nur Einzel-Zeichen Flags. In einer einzelnen Zeichenkette, wird
             jeder Buchstabe angegeben der einem Flag entspricht das durch die Anwendung unterstützt

documentation/manual/de/module_specs/Zend_Mail-AdditionalHeaders.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 16051 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.additional-headers">
     <title>Zusätzliche Kopfzeilen</title>
@@ -18,6 +18,13 @@ $mail->addHeader('X-greetingsTo', 'Mom', true); // mehrer Werte
 $mail->addHeader('X-greetingsTo', 'Dad', true);
 ]]></programlisting>
     </example>
+
+    <para>
+        Um den Reply-To: Header zu setzen gibt es die Funktion
+        <code>setReplyTo($email, $name=null)</code> weil zusätzliches spezielles Escaping der
+        unterschiedlichen Teile (Email und Name) notwendig ist.
+    </para>
+
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/de/module_specs/Zend_Paginator-Usage.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 16153 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.paginator.usage">
     <title>Verwendung</title>
@@ -175,6 +175,46 @@ $this->view->paginator = $paginator;
         </para>
     </sect2>
 
+    <sect2 id="zend.paginator.usage.dbselect">
+        <title>Die Adapter DbSelect und DbTableSelect</title>
+        <para>
+            Die Verwendung der meisten Adapter ist recht zielgerichtet. Trotzdem benötigen die
+            Datenbank Adapter detailiertere Erklärungen. Im Gegensatz zur üblichen Meinung holen
+            diese Adapter NICHT alle Einträge von der Datenbank um sie zu zählen. Stattdessen
+            manipuliert der Adapter die originale Abfrage um die entsprechende COUNT Abfrage zu
+            erzeugen. Paginator führt dann diese COUNT Abfrage aus um die Anzahl der Zeilen zu
+            erhalten. Das erfordert eine zusätzliche Beanspruchung der Datenbank, ist aber um ein
+            vielfaches schneller als das komplette Ergebnisset zu holen und count() zu verwenden.
+            Speziell bei einer großen Anzahl an Daten.
+        </para>
+
+        <para>
+            Der Datenbank Adapter versucht die effizienteste Abfrage zu erstellen die auf ziemlich
+            allen modernen Datenbanken ausgefürt wird. Trotzdem ist es möglich das, abhängig von
+            der eigenen Datenbank oder sogar dem Setup des eigenen Schemas, ein effizienterer Weg
+            existiert um die Anzahl der Zeilen zu erhalten. Für dieses Szenario erlaubt es der
+            Datenbank Adapter eine eigene COUNT Abfrage zu setzen. Wenn man zum Beispiel die
+            Anzahl der Blog Posts in einer eigenen Tabelle speichert, kann eine schnellere Abfrage
+            der Anzahl mit dem folgenden Setup erreicht werden:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$adapter = new Zend_Paginator_Adapter_DbSelect($db->select()->from('posts'));
+$adapter->setRowCount(
+    $db->select()->from('item_counts', array(Zend_Paginator_Adapter_DbSelect::ROW_COUNT_COLUMN => 'post_count'))
+)
+
+$paginator = new Zend_Paginator($adapter);
+]]></programlisting>
+
+        <para>
+            Dieser Ansatz wird jetzt wahrscheinlich keine große Performance Verbesserung bei
+            kleinen Datemengen und oder einfachen Abfragen ergeben. Aber bei komplexen Abfragen
+            und großen Datenmengen kann ein ähnlicher Weg eine signifikante Performance
+            Verbesserung ergeben.
+        </para>
+    </sect2>
+
     <sect2 id="zend.paginator.rendering">
         <title>Seiten mit View Skripten darstellen</title>
 

documentation/manual/de/module_specs/Zend_Validate-Messages.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 16087 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.messages">
 
@@ -101,6 +101,15 @@
                     <entry>'%value%' is not of the format YYYY-MM-DD</entry>
                 </row>
                 <row>
+                    <entry morerows="1" valign="middle">Db_Abstract</entry>
+                    <entry>ERROR_NO_RECORD_FOUND</entry>
+                    <entry>No record matching %value% was found</entry>
+                </row>
+                <row>
+                    <entry>ERROR_RECORD_FOUND</entry>
+                    <entry>A record matching %value% was found</entry>
+                </row>
+                <row>
                     <entry morerows="1" valign="middle">Digits</entry>
                     <entry>NOT_DIGITS</entry>
                     <entry>'%value%' contains not only digit characters</entry>