[GENERIC] Manual:

- sync up to r21211

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

documentation/manual/de/module_specs/Zend_Application-CoreFunctionality-Application.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20943 -->
+<!-- EN-Revision: 21130 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.application.core-functionality.application">
     <title>Zend_Application</title>
@@ -142,8 +142,9 @@
                                             einzelne Konfiguration zusammengefügt werden sollen. Das
                                             Hilft bei der Reduzierung von doppelten Konfigurationen
                                             über mehrere Kontexte welche die gleichen gemeinsamen
-                                            Einstellungen teilen (z.B. Konfiguration für HTTP, oder
-                                            CLI, welche alle einige Charakteristiken teilen aber mit
+                                            Einstellungen teilen (z.B. Konfiguration für
+                                            <acronym>HTTP</acronym>, oder <acronym>CLI</acronym>,
+                                            welche alle einige Charakteristiken teilen aber mit
                                             deren eigenen wiedersprüchlichen Werten für andere)
                                             oder indem eine lange Konfiguration in viele kleinere
                                             kategorisierte Dateien geteilt wird. Der Parameter ist
@@ -151,7 +152,7 @@
                                             "configs" dessen Wert ein Array von Dateien ist welche
                                             zusammengefügt werden. Beachte: Dies bedeutet das man
                                             entweder einen literalen Pfad übergibt, oder
-                                            array("configs"=>array("/path1","/path2"[,...])).
+                                            <command>array("configs"=>array("/path1","/path2"[,...]))</command>.
                                         </para>
                                     </listitem>
 

documentation/manual/de/module_specs/Zend_Cache-Frontends.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21109 -->
+<!-- EN-Revision: 21130 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.cache.frontends">
     <title>Zend_Cache Frontends</title>
@@ -686,9 +686,10 @@ $res = $cache->foobar2('1', '2');
                     Anfrage sein. Um dies zu garantieren muss der Ausgabebuffer, den der Dispatcher
                     verwendet, deaktiviert sein indem die <methodname>setParam()</methodname>
                     Methode von <classname>Zend_Controller_Front</classname> verwendet wird. Zum
-                    Beispiel $front->setParam('disableOutputBuffering', true) oder durch hinzufügen
-                    von "resources.frontcontroller.params.disableOutputBuffering = true" zum eigenen
-                    Konfigurationsdatei der Bootstrap (INI angenommen) wenn
+                    Beispiel <command>$front->setParam('disableOutputBuffering', true)</command>
+                    oder durch hinzufügen von
+                    "resources.frontcontroller.params.disableOutputBuffering = true" zum eigenen
+                    Konfigurationsdatei der Bootstrap (<acronym>INI</acronym> angenommen) wenn
                     <classname>Zend_Application</classname> verwendet wird.
                 </para>
             </note>

documentation/manual/de/module_specs/Zend_Config_Ini.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20765 -->
+<!-- EN-Revision: 21130 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.adapters.ini">
     <title>Zend_Config_Ini</title>
@@ -115,6 +115,7 @@ echo $config->database->params->dbname; // Ausgabe "dbname"
                         <entry><varname>$filename</varname></entry>
                         <entry>Die <acronym>INI</acronym> Datei die geladen wird.</entry>
                     </row>
+
                     <row>
                         <entry><varname>$section</varname></entry>
 
@@ -127,7 +128,9 @@ echo $config->database->params->dbname; // Ausgabe "dbname"
                     </row>
 
                     <row>
-                        <entry><varname>$options</varname> (Default <constant>FALSE</constant>)</entry>
+                        <entry>
+                            <varname>$options</varname> (Default <constant>FALSE</constant>)
+                        </entry>
 
                         <entry>
                             Options Array. Die folgenden Schlüssel werden unterstützt:

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

@@ -1,20 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21129 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.realpath">
     <title>RealPath</title>
 
     <para>
         Dieser Filter löst gegebene Links und Pfadnamen auf und gibt kanonische absolute Pfadnamen
-        zurück. Referenzen zu <filename>'/./'</filename>, <filename>'/../'</filename> und extra
-        <filename>'/'</filename> Zeichen im Eingabepfad werden entfernt. Der Ergebnispfad hat
-        keine symbolischen Links, <filename>'/./'</filename> oder <filename>'/../'</filename>
+        zurück. Referenzen zu '<filename>/./</filename>', '<filename>/../</filename>' und extra
+        '<filename>/</filename>' Zeichen im Eingabepfad werden entfernt. Der Ergebnispfad hat
+        keine symbolischen Links, '<filename>/./</filename>' oder '<filename>/../</filename>'
         Zeichen mehr.
     </para>
 
     <para>
         <classname>Zend_Filter_RealPath</classname> gibt bei einem Fehler <constant>FALSE</constant>
-        zurück, z.B. wenn die Datei nicht existiert. Auf BSD Systemen schlägt
+        zurück, z.B. wenn die Datei nicht existiert. Auf <acronym>BSD</acronym> Systemen schlägt
         <classname>Zend_Filter_RealPath</classname> nicht fehl wenn nur die letzte Komponente des
         Pfades nicht existiert, wärend andere Systeme <constant>FALSE</constant> zurückgeben.
     </para>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21129 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.set" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Standard Filter Klassen</title>
@@ -116,10 +116,11 @@
         <title>StripTags</title>
 
         <para>
-            Dieser Filter gibt den Eingabestring zurück, wobei alle HTML und <acronym>PHP</acronym>
-            Tags von Ihm entfernt werden ausser diesen die explizit erlaubt sind. Zusätzlich zur
-            Möglichkeit zu definieren welche Tags erlaubt sind können Entwickler definieren welche
-            Attribute über alle erlaubten Tags erlaubt sind und auch nur für spezielle Tags.
+            Dieser Filter gibt den Eingabestring zurück, wobei alle <acronym>HTML</acronym> und
+            <acronym>PHP</acronym> Tags von Ihm entfernt werden ausser diesen die explizit erlaubt
+            sind. Zusätzlich zur Möglichkeit zu definieren welche Tags erlaubt sind können
+            Entwickler definieren welche Attribute über alle erlaubten Tags erlaubt sind und auch
+            nur für spezielle Tags.
         </para>
     </sect2>
 </sect1>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21129 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.writing_filters">
     <title>Filter schreiben</title>
@@ -20,8 +20,9 @@
 
     <para>
         Das folgende Beispiel demonstriert wie ein eigener Filter geschrieben wird:
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 class MyFilter implements Zend_Filter_Interface
 {
     public function filter($value)
@@ -33,14 +34,13 @@ class MyFilter implements Zend_Filter_Interface
     }
 }
 ]]></programlisting>
-    </para>
 
     <para>
         Um eine Instanz des Filters der oben definiert wurde in eine Filterkette hinzuzufügen:
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $filterChain = new Zend_Filter();
 $filterChain->addFilter(new MyFilter());
 ]]></programlisting>
-    </para>
 </sect1>

documentation/manual/de/module_specs/Zend_Filter.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21193 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.introduction">
     <title>Einführung</title>

documentation/manual/de/module_specs/Zend_Http_Client-Adapters.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20946 -->
+<!-- EN-Revision: 21145 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.http.client.adapters">
     <title>Zend_Http_Client - Verbindungsadapter</title>
@@ -123,7 +123,7 @@
                             <entry>string</entry>
                             <entry><constant>NULL</constant></entry>
                         </row>
-                        
+
                         <row>
                             <entry>sslusecontext</entry>
 
@@ -662,7 +662,7 @@ $client = new Zend_Http_Client('http://www.example.com', array(
 ));
 
 // Erzwingen das die nächste Anfrage mit einer Exception fehlschlägt
-$adapter->nextRequestWillFail(true);
+$adapter->setNextRequestWillFail(true);
 
 try {
     // Dieser Aufruf führt zu einer Zend_Http_Client_Adapter_Exception

documentation/manual/de/module_specs/Zend_Service_Amazon.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20872 -->
+<!-- EN-Revision: 21154 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.amazon">
     <title>Zend_Service_Amazon</title>
@@ -769,6 +769,16 @@ foreach ($results as $result) {
                             </row>
 
                             <row>
+                                <entry>MerchantName</entry>
+                                <entry>string</entry>
+
+                                <entry>
+                                    Der Amazon Name des Anbieters. Benötigt die Option
+                                    <code>ResponseGroup</code> auf <code>OfferFull</code> um
+                                    Empfangen werden zu können.
+                                </entry>
+                            </row>
++                            <row>
                                 <entry>GlancePage</entry>
                                 <entry>string</entry>
 

documentation/manual/de/module_specs/Zend_Service_Amazon_Ec2-Ebs.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20818 -->
+<!-- EN-Revision: 21194 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.amazon.ec2.ebs">
     <title>Zend_Service_Amazon_Ec2: Elastischer Block Speicher (EBS)</title>

documentation/manual/de/module_specs/Zend_Translate-Plurals.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20799 -->
+<!-- EN-Revision: 21194 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.translate.plurals">
     <title>Plurale Schreibweisen für Übersetzungen</title>

documentation/manual/de/module_specs/Zend_Translate-Using.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20799 -->
-<!-- Reviewed: 20799 -->
+<!-- EN-Revision: 21194 -->
+<!-- Reviewed: 21194 -->
 <sect1 id="zend.translate.using">
     <title>Verwendung der Übersetzungsadapter</title>
 

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20352 -->
+<!-- EN-Revision: 21194 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.messages">
     <title>Prüfungsmeldungen</title>

documentation/manual/de/module_specs/Zend_Validate.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20799 -->
+<!-- EN-Revision: 21194 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.introduction">
     <title>Einführung</title>

documentation/manual/de/ref/coding_standard.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20876 -->
+<!-- EN-Revision: 21161 -->
 <!-- Reviewed: no -->
 <appendix id="coding-standard">
     <title>Zend Framework Coding Standard für PHP</title>
@@ -184,6 +184,51 @@
                     Klassen vor dieser Version kann es sein das sie dieser Regel nicht folgen, aber
                     Sie werden in Zukunft umbenannt um zu entsprechen.
                 </para>
+
+                <para>
+                    Der Hintergrund dieser Änderung ist die Verwendung von Namespaces. Da wir auf
+                    Zend Framework 2.0 und die Verwendung von PHP 5.3 zugehen, werden wir Namespaces
+                    verwenden. Der einfachste Weg die Konvertierung zu Namespaces zu automatisieren
+                    besteht darin die Unterstriche in Namespace Separatoren zu konvertieren -- aber
+                    in der alten Namenskonvention, lässt dies den Klassennamen einfach als
+                    "Abstract" oder "Interface" zurück" -- beide sind reservierte Schlüsselwörter
+                    in PHP. Wenn wir den Namen der (Unter)Komponente dem Klassennamen voranstellen
+                    können wir diese Probleme vermeiden.
+                </para>
+
+                <para>
+                    Um die Situation zu illustrieren, nehmen wir an dass die Klasse
+                    <classname>Zend_Controller_Request_Abstract</classname> konvertiert wird um
+                    Namespaces zu verwenden:
+                </para>
+
+                <programlisting language="php"><![CDATA[
+namespace Zend\Controller\Request;
+
+abstract class Abstract
+{
+    // ...
+}
+]]></programlisting>
+
+                <para>
+                    Natürlich wird das nicht funktionieren. In der neuen Namenskonvention würde
+                    dies aber trotzdem zu folgendem werden:
+                </para>
+                <programlisting language="php"><![CDATA[
+namespace Zend\Controller\Request;
+
+abstract class RequestAbstract
+{
+    // ...
+}
+]]></programlisting>
+
+                <para>
+                    Wir bleiben trotzdem bei der Semantik und der Trennung auf Namespaces, wärend
+                    wir die Probleme mit den Schlüsselworten vermeiden; simultan beschreibt dies
+                    abstrakte Klassen besser.
+                </para>
             </note>
         </sect2>
 
@@ -210,7 +255,10 @@
                 <para>
                     Diese Namens Konvention ist neu mit Version 1.9.0 des Zend Frameworks. Bei
                     Klassen vor dieser Version kann es sein das sie dieser Regel nicht folgen, aber
-                    Sie werden in Zukunft umbenannt um zu entsprechen.
+                    Sie werden in Zukunft umbenannt um zu entsprechen. Siehe <link
+                        linkend="coding-standard.naming-conventions.abstracts">den vorhergehenden
+                        Abschnitt</link> für weitere Informationen über die Hintergründe für diese
+                    Änderung.
                 </para>
             </note>
         </sect2>