[MANUAL] German:

- sync up to 19159

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

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17597 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.currency.usage">
 

documentation/manual/de/module_specs/Zend_Db_Select.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18196 -->
+<!-- EN-Revision: 19109 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.select">
 
@@ -804,7 +804,6 @@ $select = $db->select()
             </para>
 
             <example id="zend.db.select.building.where.example-param">
-
                 <title>Beispiel für einen Parameter in der where() Methode</title>
 
                 <programlisting language="php"><![CDATA[
@@ -823,6 +822,28 @@ $select = $db->select()
             </example>
 
             <para>
+                Man kann als zweiten Parameter ein Array an die <methodname>where()</methodname>
+                Methode übergeben wenn der SQL IN Operator verwendet wird.
+            </para>
+
+            <example id="zend.db.select.building.where.example-array">
+                <title>Beispiel eines Array Parameters in der where() Methode</title>
+                <programlisting language="php"><![CDATA[
+// Diese Abrage wird gebaut:
+//   SELECT product_id, product_name, price
+//   FROM "products"
+//   WHERE (product_id IN (1, 2, 3))
+
+$productIds = array(1, 2, 3);
+
+$select = $db->select()
+             ->from('products',
+                    array('product_id', 'product_name', 'price'))
+             ->where('product_id IN (?)', $productIds);
+]]></programlisting>
+            </example>
+
+            <para>
                 Die <methodname>where()</methodname> Methode kann mehrere Male in dem selben
                 <classname>Zend_Db_Select</classname> Objekt aufgerufen werden. Die daraus folgenden
                 Anfrage kombiniert die unterschiedlichen Ausdrücke unter Benutzung von

documentation/manual/de/module_specs/Zend_Db_Table.xml

@@ -1,12 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18737 -->
+<!-- EN-Revision: 19139 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.table">
-
     <title>Zend_Db_Table</title>
 
     <sect2 id="zend.db.table.introduction">
-
         <title>Einführung</title>
 
         <para>
@@ -910,7 +908,9 @@ $rows = $table->find(array(1234, 5678), array('ABC', 'DEF'));
                     <para>
 
                         <programlisting language="php"><![CDATA[
-// Ein Rowset holen
+/**
+ * Ein Rowset holen
+ */
 $rows = $table->fetchAll(
     'bug_status = "NEW"',
     'bug_id ASC',
@@ -923,8 +923,18 @@ $rows = $table->fetchAll(
         ->order('bug_id ASC')
         ->limit(10, 0)
     );
+// oder mit Bindung
+$rows = $table->fetchAll(
+    $table->select()
+        ->where('bug_status = :status')
+        ->bind(array(':status'=>'NEW')
+        ->order('bug_id ASC')
+        ->limit(10, 0)
+    );
 
-// Eine einzelne Zeile holen
+/**
+ * Eine einzelne Zeile holen
+ */
 $row = $table->fetchRow(
     'bug_status = "NEW"',
     'bug_id ASC'
@@ -934,6 +944,13 @@ $row = $table->fetchRow(
         ->where('bug_status = ?', 'NEW')
         ->order('bug_id ASC')
     );
+// oder mit Bindung
+$row = $table->fetchRow(
+    $table->select()
+        ->where('bug_status = :status')
+        ->bind(array(':status'=>'NEW')
+        ->order('bug_id ASC')
+    );
 ]]></programlisting>
 
                     </para>

documentation/manual/de/module_specs/Zend_Dojo-Form-Elements.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17598 -->
+<!-- EN-Revision: 19143 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.dojo.form.elements">
     <title>Dijit-Specifische Fomularelemente</title>
@@ -756,6 +756,40 @@ $form->addElement('editor', 'content', array(
 ));
 ]]></programlisting>
         </example>
+
+        <note>
+            <title>Das Editor Dijit verwendet standardmäßig div</title>
+
+            <para>
+                Das Editor dijit verwendet standardmäßig ein <acronym>HTML</acronym>
+                <acronym>DIV</acronym>. Die Dokumentation für
+                <classname>dijit._editor.RichText</classname> zeigt dass es potentielle Sicherheits
+                Probleme bereiten kann wenn man es auf ein HTML <acronym>TEXTAREA</acronym>
+                erstellt.
+            </para>
+
+            <para>
+                Deshalb kann es Zeiten geben in denen man ein Editor Widget benötigt das korrekt zu
+                einer <acronym>TEXTAREA</acronym> degradiert. In solchen Situationen kann man dass
+                durchführen indem die Eigenschaft <varname>degrade</varname> auf
+                <constant>true</constant> gesetzt wird:
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Bei der Instanzierung:
+$editor = new Zend_Dojo_Form_Element_Editor('foo', array(
+    'degrade' => true,
+));
+
+// Erstellung über die Form:
+$form->addElement('editor', 'content', array(
+    'degrade' => true,
+));
+
+// Oder nach der Instanzierung:
+$editor->degrade = true;
+]]></programlisting>
+        </note>
     </sect3>
 
     <sect3 id="zend.dojo.form.elements.horizontalSlider">

documentation/manual/de/module_specs/Zend_Dojo-View-Helpers.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 19143 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.dojo.view.dijit">
     <title>Dijit-Spezifische View Helfer</title>
@@ -634,6 +634,29 @@ echo $view->dateTextBox(
                 <programlisting language="php"><![CDATA[
 echo $view->editor('foo');
 ]]></programlisting>
+
+                <note>
+                    <title>Das Editor Dijit verwendet standardmäßig div</title>
+
+                    <para>
+                        Das Editor dijit verwendet standardmäßig ein <acronym>HTML</acronym>
+                        <acronym>DIV</acronym>. Die Dokumentation für
+                        <classname>dijit._editor.RichText</classname> zeigt dass es potentielle
+                        Sicherheits Probleme bereiten kann wenn man es auf ein HTML
+                        <acronym>TEXTAREA</acronym> erstellt.
+                    </para>
+
+                    <para>
+                        Deshalb kann es Zeiten geben in denen man ein Editor Widget benötigt das
+                        korrekt zu einer <acronym>TEXTAREA</acronym> degradiert. In solchen
+                        Situationen kann man dass durchführen indem die Eigenschaft
+                        <varname>degrade</varname> auf <constant>true</constant> gesetzt wird:
+                    </para>
+
+                    <programlisting language="php"><![CDATA[
+echo $this->editor('foo', '', array('degrade' => true));
+]]></programlisting>
+        </note>
             </listitem>
 
             <listitem>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.file.transfer.introduction">
 

documentation/manual/de/module_specs/Zend_Filter-Decryption.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17154 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.decrypt">
     <title>Decrypt</title>

documentation/manual/de/module_specs/Zend_Filter-Encryption.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17154 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.encrypt">
     <title>Encrypt</title>

documentation/manual/de/module_specs/Zend_Filter.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17848 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.introduction">
 

documentation/manual/de/module_specs/Zend_Ldap-API-Ldap-Node-RootDse.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.ldap.api.reference.zend-ldap-node-rootdse">
     <title>Zend_Ldap_Node_RootDse</title>

documentation/manual/de/module_specs/Zend_Ldap-API-Ldap-Node-Schema.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 19111 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.ldap.api.reference.zend-ldap-node-schema">
     <title>Zend_Ldap_Node_Schema</title>

documentation/manual/de/module_specs/Zend_Ldap-API-Ldap-Node.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.ldap.api.reference.zend-ldap-node">
     <title>Zend_Ldap_Node</title>

documentation/manual/de/module_specs/Zend_Locale-Functions.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.locale.functions">
 

documentation/manual/de/module_specs/Zend_OpenId-Consumer.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17407 -->
+<!-- EN-Revision: 19074 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.openid.consumer">
     <title>Zend_OpenId_Consumer Grundlagen</title>
@@ -366,11 +366,13 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
     {
         $table = $this->_association_table;
         $secret = base64_encode($secret);
-        $this->_db
-             ->query('insert into ' .
-                     $table . " (url, handle, macFunc, secret, expires) " .
-                     "values ('$url', '$handle', '$macFunc', " .
-                     "'$secret', $expires)");
+        $this->_db->insert($table, array(
+            'url'     => $url,
+            'handle'  => $handle,
+            'macFunc' => $macFunc,
+            'secret'  => $secret,
+            'expires' => $expires,
+        ));
         return true;
     }
 
@@ -381,9 +383,14 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
                                    &$expires)
     {
         $table = $this->_association_table;
-        $this->_db->query("delete from $table where expires < " . time());
-        $res = $this->_db->fetchRow('select handle, macFunc, secret, expires ' .
-                                    "from $table where url = '$url'");
+        $this->_db->delete(
+            $table, $this->_db->quoteInto('expires < ?', time())
+        );
+        $select = $this-_db->select()
+                ->from($table, array('handle', 'macFunc', 'secret', 'expires'))
+                ->where('url = ?', $url);
+        $res = $this->_db->fetchRow($select);
+
         if (is_array($res)) {
             $handle  = $res['handle'];
             $macFunc = $res['macFunc'];
@@ -401,10 +408,14 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
                                            &$expires)
     {
         $table = $this->_association_table;
-        $this->_db->query("delete from $table where expires < " . time());
-        $res = $this->_db
-                    ->fetchRow('select url, macFunc, secret, expires ' .
-                               "from $table where handle = '$handle'");
+        $this->_db->delete(
+            $table, $this->_db->quoteInto('expires < ', time())
+        );
+        $select = $this->_db->select()
+                ->from($table, array('url', 'macFunc', 'secret', 'expires')
+                ->where('handle = ?', $handle);
+        $res = $select->fetchRow($select);
+
         if (is_array($res)) {
             $url     = $res['url'];
             $macFunc = $res['macFunc'];
@@ -429,11 +440,14 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
                                      $expires)
     {
         $table = $this->_discovery_table;
-        $this->_db
-             ->query("insert into $table " .
-                     "(id, realId, server, version, expires) " .
-                     "values (" .
-                     "'$id', '$realId', '$server', $version, $expires)");
+        $this->_db->insert($table, array(
+            'id'      => $id,
+            'realId'  => $realId,
+            'server'  => $server,
+            'version' => $version,
+            'expires' => $expires,
+        ));
+
         return true;
     }
 
@@ -444,10 +458,12 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
                                      &$expires)
     {
         $table = $this->_discovery_table;
-        $this->_db->query("delete from $table where expires < " . time());
-        $res = $this->_db
-                    ->fetchRow('select realId, server, version, expires ' .
-                               "from $table where id = '$id'");
+        $this->_db->delete($table, $this->quoteInto('expires < ?', time()));
+        $select = $this->_db->select()
+                ->from($table, array('realId', 'server', 'version', 'expires'))
+                ->where('id = ?', $id);
+        $res = $this->_db->fetchRow($select);
+
         if (is_array($res)) {
             $realId  = $res['realId'];
             $server  = $res['server'];
@@ -461,7 +477,7 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
     public function delDiscoveryInfo($id)
     {
         $table = $this->_discovery_table;
-        $this->_db->query("delete from $table where id = '$id'");
+        $this->_db->delete($table, $this->_db->quoteInto('id = ?', $id));
         return true;
     }
 
@@ -469,8 +485,9 @@ class DbStorage extends Zend_OpenId_Consumer_Storage
     {
         $table = $this->_nonce_table;
         try {
-            $ret = $this->_db
-                        ->query("insert into $table (nonce) values ('$nonce')");
+            $ret = $this->_db->insert($table, array(
+                'nonce' => $nonce,
+            ));
         } catch (Zend_Db_Statement_Exception $e) {
             return false;
         }

documentation/manual/de/module_specs/Zend_Rest.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 19118 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.rest.introduction">
     <title>Einführung</title>
@@ -13,7 +13,7 @@
     </para>
 
     <para>
-        Das Zend Framework bietet beide Möglichkeiten, Client und Server, welche, wenn Sie zusammen
+        Zend Framework bietet beide Möglichkeiten, Client und Server, welche, wenn Sie zusammen
         benutzt werden, eine viel größere "logische" Interface Erfahrung über den Zugriff, auf
         virtuelle Objekt Eigenschaften erlauben. Die Server Komponente bietet automatische
         Darstellung von Funktionen und Klassen und verwendet ein bedeutungsvolles und einfaches
@@ -22,6 +22,14 @@
         gewünscht sein den Client mit einem nicht-Zend_Rest_Server basierenden Service zu verwenden,
         bietet er immer noch vereinfachten Zugriff auf die Daten.
     </para>
+
+    <para>
+        Zusätzlich zu den Komponenten <classname>Zend_Rest_Server</classname> und
+        <classname>Zend_Rest_Client</classname> bieten die Klassen <link
+            linkend="zend.controller.router.routes.rest"><classname>Zend_Rest_Route</classname> und
+            <classname>Zend_Rest_Controller</classname></link> Hilfe beim Routen von REST Anfragen
+        zum Controller.
+    </para>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

documentation/manual/de/module_specs/Zend_Test-PHPUnit-Db-Adapter.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17985 -->
+<!-- EN-Revision: 19082 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.test.phpunit.db.adapter">
     <title>Verwenden des Datenbank Test Adapters</title>
@@ -91,6 +91,8 @@ echo $qp->getQuerY(); // SELECT * FROM bugs
     <para>
         Der Test Adapter spezifiziert auch Methoden um die Verwendung der Methoden
         <methodname>listTables()</methodname>, <methodname>describeTables()</methodname> und
-        <methodname>lastInsertId()</methodname> simuliert.
+        <methodname>lastInsertId()</methodname> simuliert. Wenn man
+        <methodname>setQuoteIdentifierSymbol()</methodname> verwendet kann man spezifizieren welches
+        Symbol für die Kommentierung verwendet werden soll, da Standardmäßig keines verwendet wird.
     </para>
 </sect2>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18986 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.validate.set.ip">
     <title>Ip</title>

documentation/manual/de/module_specs/Zend_Validate.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18028 -->
+<!-- EN-Revision: 19150 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.introduction">