[GENERIC] Manual:

- sync up to r21128

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

documentation/manual/de/module_specs/Zend_Feed_Writer.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21121 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.feed.writer">
     <title>Zend_Feed_Writer</title>
@@ -11,9 +11,10 @@
             <classname>Zend_Feed_Writer</classname> ist die Bruderkomponente zu
             <classname>Zend_Feed_Reader</classname> und verantwortlich für die Erzeugung von
             Feeds für die Ausgabe. Sie unterstützt die Atom 1.0 Spezifikation (RFC 4287) und
-            RSS 2.0 wie vom RSS Advisory Board (RSS 2.0.11) spezifiziert. Es ist kein Nachkomme
-            dieser Standard. Trotzdem bietet es ein einfaches System der Erweiterung welches es
-            erlaube jede Erweiterung/Modul für jede der zwei Spezifikationen zu implementieren
+            <acronym>RSS</acronym> 2.0 wie vom <acronym>RSS</acronym> Advisory Board
+            (<acronym>RSS</acronym> 2.0.11) spezifiziert. Es ist kein Nachkomme dieses
+            Standards. Trotzdem bietet es ein einfaches System der Erweiterung welches es erlaubt
+            jede Erweiterung und jedes Modul für jede der zwei Spezifikationen zu implementieren
             wenn diese nicht von Haus aus angeboten werden.
         </para>
 
@@ -22,20 +23,21 @@
             <classname>Zend_Feed_Reader</classname>. Wobei <classname>Zend_Feed_Reader</classname>
             darauf fokusiert ist ein einfach zu verwendendes Architektur Frontend durch Getter
             Methoden anzubieten, und <classname>Zend_Feed_Writer</classname> durch ähnlich
-            benannte Setter oder Mutatoren. Das stellt sicher das die API keine weitere Lernkurve
-            erfordert wenn jemand bereits mit <classname>Zend_Feed_Reader</classname> bekannt ist.
+            benannte Setter oder Mutatoren. Das stellt sicher das die <acronym>API</acronym> keine
+            weitere Lernkurve erfordert wenn jemand bereits mit
+            <classname>Zend_Feed_Reader</classname> bekannt ist.
         </para>
 
         <para>
             Als Ergebnis dieses Designs, ist der Rest sogar einleuchtend. Dahinter, wird jedes
             Datenset eines <classname>Zend_Feed_Reader</classname> Objekts wärend der
-            Darstellungszeit in ein <classname>DOMDocument</classname> Objekt übersetzt indem die
+            Darstellungszeit in ein DOMDocument Objekt übersetzt indem die
             notwendigen Feed Elemente verwendet werden. Für jeden unterstützten Feed Typen gibt es
-            beide, sowohl einen Atom 1.0 als auch einen RSS 2.0 Renderer. Die Verwendung von
-            <classname>DOMDocument</classname> statt einer Template Lösung hat viele Vorteile.
-            Der offensichtlichste ist die Möglichkeit das <classname>DOMDocument</classname> zu
-            exportieren um es weiter zu bearbeiten und auf PHP DOM für die Korrakturen und
-            richtige Darstellung zu setzen.
+            beide, sowohl einen Atom 1.0 als auch einen <acronym>RSS</acronym> 2.0 Renderer. Die
+            Verwendung von DOMDocument statt einer Template Lösung hat viele Vorteile.
+            Der offensichtlichste ist die Möglichkeit das DOMDocument zu
+            exportieren um es weiter zu bearbeiten und auf <acronym>PHP</acronym>
+            <acronym>DOM</acronym> für die Korrakturen und richtige Darstellung zu setzen.
         </para>
 
         <para>
@@ -60,10 +62,10 @@
             Feed Klasse angehängt werden. Der einzige Zweck dieses Containers ist es Daten über den
             zu erstellenden Feed zu sammelnindem ein einfaches Interface von Setter Methoden
             verwendet wird. Diese Methode führen einige Test zur Datenprüfung durch. Zum Beispiel
-            prüft er übergebene URIs, Datum, usw. Diese Checks sind nicht an einen der Feed
-            Standards gebunden. Das Container Objekt enthält auch Methoden welche die schnelle
-            Darstellung und den Export des endgültigen Feeds erlauben, und Sie können auf Wunsch
-            wiederverwendet werden.
+            prüft er übergebene <acronym>URI</acronym>s, Datum, usw. Diese Checks sind nicht an
+            einen der Feed Standards gebunden. Das Container Objekt enthält auch Methoden welche die
+            schnelle Darstellung und den Export des endgültigen Feeds erlauben, und Sie können auf
+            Wunsch wiederverwendet werden.
         </para>
 
         <para>
@@ -146,55 +148,59 @@ $out = $feed->export('atom');
             Die dargestellt Ausgabe sollte folgende sein:
         </para>
 
-        <programlisting language="xml">
-&#60;?xml version="1.0" encoding="utf-8"?&#62;
-&#60;feed xmlns="http://www.w3.org/2005/Atom"&#62;
-    &#60;title type="text"&#62;Paddy's Blog&#60;/title&#62;
-    &#60;subtitle type="text"&#62;Writing about PC Games since 176 BC.&#60;/subtitle&#62;
-    &#60;updated&#62;2009-12-14T20:28:18+00:00&#60;/updated&#62;
-    &#60;generator uri="http://framework.zend.com" version="1.10.0alpha"&#62;
+        <programlisting language="xml"><![CDATA[
+<?xml version="1.0" encoding="utf-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+    <title type="text">Paddy's Blog</title>
+    <subtitle type="text">Writing about PC Games since 176 BC.</subtitle>
+    <updated>2009-12-14T20:28:18+00:00</updated>
+    <generator uri="http://framework.zend.com" version="1.10.0alpha">
         Zend_Feed_Writer
-    &#60;/generator&#62;
-    &#60;link rel="alternate" type="text/html" href="http://www.example.com"/&#62;
-    &#60;link rel="self" type="application/atom+xml" href="http://www.example.com/atom"/&#62;
-    &#60;id&#62;http://www.example.com&#60;/id&#62;
-    &#60;author&#62;
-        &#60;name&#62;Paddy&#60;/name&#62;
-        &#60;email&#62;paddy@example.com&#60;/email&#62;
-        &#60;uri&#62;http://www.example.com&#60;/uri&#62;
-    &#60;/author&#62;
-    &#60;link rel="hub" href="http://pubsubhubbub.appspot.com/"/&#62;
-    &#60;entry&#62;
-        &#60;title type="html"&#62;&#60;![CDATA[All Your Base Are Belong To Us]]&#62;&#60;/title&#62;
-        &#60;summary type="html"&#62;
-            &#60;![CDATA[Die Schwierigkeiten erklären Spiele ins englische zu portieren.]]&#62;
-        &#60;/summary&#62;
-        &#60;published&#62;2009-12-14T20:28:18+00:00&#60;/published&#62;
-        &#60;updated&#62;2009-12-14T20:28:18+00:00&#60;/updated&#62;
-        &#60;link rel="alternate" type="text/html" href="http://www.example.com/all-your-base-are-belong-to-us"/&#62;
-        &#60;id&#62;http://www.example.com/all-your-base-are-belong-to-us&#60;/id&#62;
-        &#60;author&#62;
-        &#60;name&#62;Paddy&#60;/name&#62;
-        &#60;email&#62;paddy@example.com&#60;/email&#62;
-        &#60;uri&#62;http://www.example.com&#60;/uri&#62;
-        &#60;/author&#62;
-        &#60;content type="html"&#62;
-            &#60;![CDATA[Ich schreibe diesen Artikel nicht. Das Beispiel ist lang genug ;).]]&#62;
-        &#60;/content&#62;
-    &#60;/entry&#62;
-&#60;/feed&#62;
-</programlisting>
+    </generator>
+    <link rel="alternate" type="text/html" href="http://www.example.com"/>
+    <link rel="self" type="application/atom+xml"
+        href="http://www.example.com/atom"/>
+    <id>http://www.example.com</id>
+    <author>
+        <name>Paddy</name>
+        <email>paddy@example.com</email>
+        <uri>http://www.example.com</uri>
+    </author>
+    <link rel="hub" href="http://pubsubhubbub.appspot.com/"/>
+    <entry>
+        <title type="html"><![CDATA[All Your Base Are Belong To Us]]></title>
+        <summary type="html">
+            <![CDATA[Die Schwierigkeiten erklären Spiele ins englische zu
+                     portieren.]]>
+        </summary>
+        <published>2009-12-14T20:28:18+00:00</published>
+        <updated>2009-12-14T20:28:18+00:00</updated>
+        <link rel="alternate" type="text/html"
+            href="http://www.example.com/all-your-base-are-belong-to-us"/>
+        <id>http://www.example.com/all-your-base-are-belong-to-us</id>
+        <author>
+            <name>Paddy</name>
+            <email>paddy@example.com</email>
+            <uri>http://www.example.com</uri>
+        </author>
+        <content type="html">
+            <![CDATA[Ich schreibe diesen Artikel nicht.
+                     Das Beispiel ist lang genug ;).]]>
+        </content>
+    </entry>
+</feed>
+]]></programlisting>
 
         <para>
             Das ist ein perfekt gültiges Beispiel für Atom 1.0. Es sollte erwähnt sein das die
             Unterdrückung von obligatorischen Datenpunkten, wie dem Titel, eine
             <classname>Exception</classname> werfen wenn diese als Atom 1.0 dargestellt werden.
-            Das unterscheidet sich für RSS 2.0 wo ein Titel unterdrückt werden kann solange eine
-            Beschreibung vorhanden ist. Dadurch werden Exceptions geworfen die sich zwischen beiden
-            Standards unterscheiden abhängig vom Renderer der Verwendet wird. Vom Design her wird
-            <classname>Zend_Feed_Writer</classname> einen ungültigen Feed für keinen Standard
-            darstellen solange der End-Benutzer nicht definiert das alle Exceptions ignoriert werden
-            sollen.
+            Das unterscheidet sich für <acronym>RSS</acronym> 2.0 wo ein Titel unterdrückt werden
+            kann solange eine Beschreibung vorhanden ist. Dadurch werden Exceptions geworfen die
+            sich zwischen beiden Standards unterscheiden abhängig vom Renderer der Verwendet wird.
+            Vom Design her wird <classname>Zend_Feed_Writer</classname> einen ungültigen Feed für
+            keinen Standard darstellen solange der End-Benutzer nicht definiert das alle Exceptions
+            ignoriert werden sollen.
         </para>
     </sect2>
 
@@ -204,14 +210,15 @@ $out = $feed->export('atom');
         <para>
             Bevor ein Feed dargestellt werden kann, müssen zuerst die notwendigen Daten, für den
             Feed der dargestellt werden soll, gesetzt werden. Hierbei wird eine einfache Setter
-            artige API verwendet welche auch als initiale Methode für die Prüfung von Daten herhält
-            wenn diese gesetzt werden. Vom Design her entspricht die API stark der von
-            <classname>Zend_Feed_Reader</classname> um Unklarheiten und Unsicherheiten zu vermeiden.
+            artige <acronym>API</acronym> verwendet welche auch als initiale Methode für die Prüfung
+            von Daten herhält wenn diese gesetzt werden. Vom Design her entspricht die
+            <acronym>API</acronym> stark der von <classname>Zend_Feed_Reader</classname> um
+            Unklarheiten und Unsicherheiten zu vermeiden.
         </para>
 
         <para>
-            <classname>Zend_Feed_Writer</classname> bietet diese API über seine Datencontainer
-            Klassen <classname>Zend_Feed_Writer_Feed</classname> und
+            <classname>Zend_Feed_Writer</classname> bietet diese <acronym>API</acronym> über seine
+            Datencontainer Klassen <classname>Zend_Feed_Writer_Feed</classname> und
             <classname>Zend_Feed_Writer_Entry</classname> an. Diese Klassen speichern nahezu alle
             Feed Daten in einer vom Typ unabhängigen Art, was bedeutet das man jeden Datencontainer
             mit jedem Renderer wiederverwenden kann ohne das zusätzliche Arbeit notwendig ist. Beide
@@ -241,9 +248,9 @@ $out = $feed->export('atom');
 
                         <entry>
                             Setzt eine eindeutige ID die mit diesem Feed assoziiert ist. Für Atom
-                            1.0 ist das ein atom:id Element, und für RSS 2.0 wird es als guid
-                            Element hinzugefügt. Diese sind optional solange ein Link hinzugefügt
-                            wird, wenn z.B. der Link als ID gesetzt ist.
+                            1.0 ist das ein atom:id Element, und für <acronym>RSS</acronym> 2.0 wird
+                            es als guid Element hinzugefügt. Diese sind optional solange ein Link
+                            hinzugefügt wird, wenn z.B. der Link als ID gesetzt ist.
                         </entry>
                     </row>
 
@@ -273,16 +280,17 @@ $out = $feed->export('atom');
                         <entry><methodname>setFeedLinks()</methodname></entry>
 
                         <entry>
-                            Fügt einen Link zu einem XML Feed hinzu, entweder der erzeugte Feed oder
-                            eine alternative URI zeigen auf den gleichen Feed, aber in einem
-                            anderen Format. Es ist mindestens notwendig einen Link zum erstellten
-                            Feed zu inkludieren damit dieser eine identifizierbare endgültige URI
-                            hat, welche es dem Client erlaubt Änderungen des Orts mitzubekommen ohne
-                            das dauernde Umleitungen notwendig sind. Dieser Parameter ist ein Array
-                            von Arrays, wobei jedes Unter-Array die Schlüssel "type" und "uri"
-                            enthält. Der Type sollte "atom", "rss" oder "rdf" sein. Wenn ein Typ
-                            unterdrückt wird, ist er standardmäßig mit dem Typ identisch mit dem
-                            der Feed dargestellt wird.
+                            Fügt einen Link zu einem <acronym>XML</acronym> Feed hinzu, entweder der
+                            erzeugte Feed oder eine alternative <acronym>URI</acronym> zeigen auf
+                            den gleichen Feed, aber in einem anderen Format. Es ist mindestens
+                            notwendig einen Link zum erstellten Feed zu inkludieren damit dieser
+                            eine identifizierbare endgültige <acronym>URI</acronym> hat, welche es
+                            dem Client erlaubt Änderungen des Orts mitzubekommen ohne das dauernde
+                            Umleitungen notwendig sind. Dieser Parameter ist ein Array von Arrays,
+                            wobei jedes Unter-Array die Schlüssel "type" und "uri" enthält. Der Type
+                            sollte "atom", "rss" oder "rdf" sein. Wenn ein Typ unterdrückt wird, ist
+                            er standardmäßig mit dem Typ identisch mit dem der Feed dargestellt
+                            wird.
                         </entry>
                     </row>
 
@@ -292,11 +300,12 @@ $out = $feed->export('atom');
                         <entry>
                             Setzt die Daten für Autoren. Der Parameter ist ein Array von Arrays
                             wobei jedes Unter-Array die Schlüssel "name", "email" und "uri"
-                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da RSS
-                            keine möglichkeit enthält Ihn anzuzeigen. Für RSS 2.0 werden bei der
-                            Darstellung zwei Elemente erzeugt - ein Autor Element welches die
-                            Referenz zur Email enthält und dem Namen in Klammern, und ein Dublin
-                            Core Creator Element welches nur den Namen enthält.
+                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da
+                            <acronym>RSS</acronym> keine Möglichkeit enthält Ihn anzuzeigen. Für
+                            <acronym>RSS</acronym> 2.0 werden bei der Darstellung zwei Elemente
+                            erzeugt - ein Autor Element welches die Referenz zur Email enthält und
+                            dem Namen in Klammern, und ein Dublin Core Creator Element welches nur
+                            den Namen enthält.
                         </entry>
                     </row>
 
@@ -316,7 +325,7 @@ $out = $feed->export('atom');
                             Setzt das Datum an dem dieser Feed erstellt wurde. Generell nur
                             für Atom anwendbar wo es das Datum beschreibt zu der die Ressource,
                             die von dem Atom 1.0 Dokument beschrieben wird, erstellt wurde. Der
-                            erwartete Parameter muss ein UNIX Timestamp oder ein
+                            erwartete Parameter muss ein <acronym>UNIX</acronym> Timestamp oder ein
                             <classname>Zend_Date</classname> Objekt sein.
                         </entry>
                     </row>
@@ -326,7 +335,7 @@ $out = $feed->export('atom');
 
                         <entry>
                             Setzt das Datum zu dem dieser Feed das letzte Mal geändert wurde. Der
-                            erwartete Parameter muss ein UNIX Timestamp oder ein
+                            erwartete Parameter muss ein <acronym>UNIX</acronym> Timestamp oder ein
                             <classname>Zend_Date</classname> Objekt sein.
                         </entry>
                     </row>
@@ -348,7 +357,7 @@ $out = $feed->export('atom');
                             sein welche die Schlüssel "name", "version" und "uri" enthält. Wenn er
                             unterdrückt wird, wird ein standardmäßiger Generator hinzugefügt welcher
                             auf <classname>Zend_Feed_Writer</classname>, die aktuelle Version vom
-                            Zend Framework und die URI des Frameworks verweist.
+                            Zend Framework und die <acronym>URI</acronym> des Frameworks verweist.
                         </entry>
                     </row>
 
@@ -377,11 +386,12 @@ $out = $feed->export('atom');
                             Akzepziert ein Array an Kategorien für die Darstellung, wobei jedes
                             Element selbst ein Array ist dessen möglich Schlüssel "term", "label"
                             und "scheme" enthalten. "term" ist typischerweise der Name einer
-                            Kategorie welche für die Aufnahme in einer URI passen. "label" kann
-                            ein menschlich lesbarer Name einer Kategorie sein der spezielle Zeichen
-                            unterstützt (er wird wärend der Darstellung kodiert) und ist ein
-                            benötigter Schlüssel. "scheme" (im RSS auch die Domain genannt) ist
-                            optional muss aber eine gültige URI sein.
+                            Kategorie welche für die Aufnahme in einer <acronym>URI</acronym>
+                            passen. "label" kann ein menschlich lesbarer Name einer Kategorie sein
+                            der spezielle Zeichen unterstützt (er wird wärend der Darstellung
+                            kodiert) und ist ein benötigter Schlüssel. "scheme" (im
+                            <acronym>RSS</acronym> auch die Domain genannt) ist optional muss aber
+                            eine gültige <acronym>URI</acronym> sein.
                         </entry>
                     </row>
                 </tbody>
@@ -393,7 +403,7 @@ $out = $feed->export('atom');
         <title>Setzen der Datenpunkt für Einträge</title>
 
         <para>
-            Hier ist eine Zusammenfassung der Kern <acronym>API</acronym> für Einträge/Elemente.
+            Hier ist eine Zusammenfassung der Kern <acronym>API</acronym> für Einträge und Elemente.
             Man sollte beachten das Sie nicht nur die Standards für <acronym>RSS</acronym> und Atom
             umfasst, sondern auch eine Anzahl von Erweiterungen welche in
             <classname>Zend_Feed_Writer</classname> enthalten sind. Die Benamung dieser Erweiterungs
@@ -412,9 +422,9 @@ $out = $feed->export('atom');
 
                         <entry>
                             Setzt eine eindeutige ID die mit diesem Feed assoziiert ist. Für Atom
-                            1.0 ist das ein atom:id Element, und für RSS 2.0 wird es als guid
-                            Element hinzugefügt. Diese sind optional solange ein Link hinzugefügt
-                            wird, wenn z.B. der Link als ID gesetzt ist.
+                            1.0 ist das ein atom:id Element, und für <acronym>RSS</acronym> 2.0 wird
+                            es als guid Element hinzugefügt. Diese sind optional solange ein Link
+                            hinzugefügt wird, wenn z.B. der Link als ID gesetzt ist.
                         </entry>
                     </row>
 
@@ -444,11 +454,12 @@ $out = $feed->export('atom');
                         <entry><methodname>setFeedLinks()</methodname></entry>
 
                         <entry>
-                            Fügt einen Link zu einem XML Feed hinzu, entweder der erzeugte Feed oder
-                            eine alternative URI zeigen auf den gleichen Feed, aber in einem
-                            anderen Format. Es ist mindestens notwendig einen Link zum erstellten
-                            Feed zu inkludieren damit dieser eine identifizierbare endgültige URI
-                            hat, welche es dem Client erlaubt Änderungen des Orts mitzubekommen ohne
+                            Fügt einen Link zu einem <acronym>XML</acronym> Feed hinzu, entweder der
+                            erzeugte Feed oder eine alternative <acronym>URI</acronym> zeigen auf
+                            den gleichen Feed, aber in einem anderen Format. Es ist mindestens
+                            notwendig einen Link zum erstellten Feed zu inkludieren damit dieser
+                            eine identifizierbare endgültige <acronym>URI</acronym> hat, welche es
+                            dem Client erlaubt Änderungen des Orts mitzubekommen ohne
                             das dauernde Umleitungen notwendig sind. Dieser Parameter ist ein Array
                             von Arrays, wobei jedes Unter-Array die Schlüssel "type" und "uri"
                             enthält. Der Type sollte "atom", "rss" oder "rdf" sein. Wenn ein Typ
@@ -463,11 +474,12 @@ $out = $feed->export('atom');
                         <entry>
                             Setzt die Daten für Autoren. Der Parameter ist ein Array von Arrays
                             wobei jedes Unter-Array die Schlüssel "name", "email" und "uri"
-                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da RSS
-                            keine möglichkeit enthält Ihn anzuzeigen. Für RSS 2.0 werden bei der
-                            Darstellung zwei Elemente erzeugt - ein Autor Element welches die
-                            Referenz zur Email enthält und dem Namen in Klammern, und ein Dublin
-                            Core Creator Element welches nur den Namen enthält.
+                            enthalten kann. Der Wert "uri ist nur für Atom Feeds anwendbar da
+                            <acronym>RSS</acronym> keine Möglichkeit enthält Ihn anzuzeigen. Für
+                            <acronym>RSS</acronym> 2.0 werden bei der Darstellung zwei Elemente
+                            erzeugt - ein Autor Element welches die Referenz zur Email enthält und
+                            dem Namen in Klammern, und ein Dublin Core Creator Element welches nur
+                            den Namen enthält.
                         </entry>
                     </row>
 
@@ -487,7 +499,7 @@ $out = $feed->export('atom');
                             Setzt das Datum an dem dieser Feed erstellt wurde. Generell nur
                             für Atom anwendbar wo es das Datum beschreibt zu der die Ressource,
                             die von dem Atom 1.0 Dokument beschrieben wird, erstellt wurde. Der
-                            erwartete Parameter muss ein UNIX Timestamp oder ein
+                            erwartete Parameter muss ein <acronym>UNIX</acronym> Timestamp oder ein
                             <classname>Zend_Date</classname> Objekt sein.
                         </entry>
                     </row>
@@ -497,7 +509,7 @@ $out = $feed->export('atom');
 
                         <entry>
                             Setzt das Datum zu dem dieser Feed das letzte Mal geändert wurde. Der
-                            erwartete Parameter muss ein UNIX Timestamp oder ein
+                            erwartete Parameter muss ein <acronym>UNIX</acronym> Timestamp oder ein
                             <classname>Zend_Date</classname> Objekt sein.
                         </entry>
                     </row>
@@ -519,7 +531,7 @@ $out = $feed->export('atom');
                             sein welche die Schlüssel "name", "version" und "uri" enthält. Wenn er
                             unterdrückt wird, wird ein standardmäßiger Generator hinzugefügt welcher
                             auf <classname>Zend_Feed_Writer</classname>, die aktuelle Version vom
-                            Zend Framework und die URI des Frameworks verweist.
+                            Zend Framework und die <acronym>URI</acronym> des Frameworks verweist.
                         </entry>
                     </row>
 
@@ -548,11 +560,12 @@ $out = $feed->export('atom');
                             Akzepziert ein Array an Kategorien für die Darstellung, wobei jedes
                             Element selbst ein Array ist dessen möglich Schlüssel "term", "label"
                             und "scheme" enthalten. "term" ist typischerweise der Name einer
-                            Kategorie welche für die Aufnahme in einer URI passen. "label" kann
-                            ein menschlich lesbarer Name einer Kategorie sein der spezielle Zeichen
-                            unterstützt (er wird wärend der Darstellung kodiert) und ist ein
-                            benötigter Schlüssel. "scheme" (im RSS auch die Domain genannt) ist
-                            optional muss aber eine gültige URI sein.
+                            Kategorie welche für die Aufnahme in einer <acronym>URI</acronym>
+                            passen. "label" kann ein menschlich lesbarer Name einer Kategorie sein
+                            der spezielle Zeichen unterstützt (er wird wärend der Darstellung
+                            kodiert) und ist ein benötigter Schlüssel. "scheme" (im
+                            <acronym>RSS</acronym> auch die Domain genannt) ist optional muss aber
+                            eine gültige <acronym>URI</acronym> sein.
                         </entry>
                     </row>
                 </tbody>

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

@@ -1,27 +1,29 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21123 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.decrypt">
     <title>Decrypt</title>
 
     <para>
         Dieser Filter verschlüsselt beliebige Strings mit den angegebenen Einstellungen. Hierfür
-        verwendet er Adapter. Aktuell gibt es Adapter für die <code>Mcrypt</code> und
-        <code>OpenSSL</code> Erweiterungen von php.
+        verwendet er Adapter. Aktuell gibt es Adapter für die <classname>Mcrypt</classname> und
+        <classname>OpenSSL</classname> Erweiterungen von php.
     </para>
 
     <para>
-        Für Details darüber wie man Inhalte verschlüsselt siehe den <code>Encrypt</code> Filter. Da
-        die Grundlegenden Dinge beim <code>Encrypt</code> Filter behandelt werden, beschreiben wir
-        hier nur mehr die zusätzlichen Methoden und Änderungen für die Entschlüsselung.
+        Für Details darüber wie man Inhalte verschlüsselt siehe den <classname>Encrypt</classname>
+        Filter. Da die Grundlegenden Dinge beim <classname>Encrypt</classname> Filter behandelt
+        werden, beschreiben wir hier nur mehr die zusätzlichen Methoden und Änderungen für die
+        Entschlüsselung.
     </para>
 
     <sect3 id="zend.filter.set.decrypt.mcrypt">
         <title>Entschlüsselung mit Mcrypt</title>
 
         <para>
-            Für die Entschlüsselung von Inhalten die vorher mit <code>Mcrypt</code> verschlüsselt
-            wurden muß man die Optionen wissen mit denen die Verschlüsselung aufgerufen wurde.
+            Für die Entschlüsselung von Inhalten die vorher mit <classname>Mcrypt</classname>
+            verschlüsselt wurden muß man die Optionen wissen mit denen die Verschlüsselung
+            aufgerufen wurde.
         </para>
 
         <para>
@@ -57,8 +59,8 @@ print $decrypted;
         <note>
             <para>
                 Man sollte ausserdem beachten das alle Einstellungen geprüft werden wenn man die
-                Instanz erstellt oder wenn man setEncryption() aufruft. Wenn Mcrypt ein Problem mit
-                den Einstellungen erkennt wird eine Ausnahme geworfen.
+                Instanz erstellt oder wenn man <methodname>setEncryption()</methodname> aufruft.
+                Wenn Mcrypt ein Problem mit den Einstellungen erkennt wird eine Ausnahme geworfen.
             </para>
         </note>
     </sect3>
@@ -67,12 +69,12 @@ print $decrypted;
         <title>Entschlüsselung mit OpenSSL</title>
 
         <para>
-            Entschlüsselung mit <code>OpenSSL</code> ist so einfach die Verschlüsseln. Aber man
-            benötigt alle Daten von der Person die den Inhalt verschlüsselt hat.
+            Entschlüsselung mit <classname>OpenSSL</classname> ist so einfach die Verschlüsseln.
+            Aber man benötigt alle Daten von der Person die den Inhalt verschlüsselt hat.
         </para>
 
         <para>
-            Für die Entschlüsselung mit <code>OpenSSL</code> benötigt man:
+            Für die Entschlüsselung mit <classname>OpenSSL</classname> benötigt man:
         </para>
 
         <itemizedlist>
@@ -110,8 +112,8 @@ $filter->setEnvelopeKey(array(
 
         <note>
             <para>
-                Beachte das der <code>OpenSSL</code> Adapter nicht funktionieren wird wenn man keine
-                gültigen Schlüssel angibt.
+                Beachte das der <classname>OpenSSL</classname> Adapter nicht funktionieren wird wenn
+                man keine gültigen Schlüssel angibt.
             </para>
         </note>
 

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21123 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.filter_chains">
     <title>Filter Ketten</title>
@@ -10,8 +10,9 @@
         und alphabetische Zeichen haben sollte. <classname>Zend_Filter</classname> bietet eine
         einfache Methode mit der Filter zusammengekettet werden können. Der folgende Code zeigt wie
         eine Verkettung von zwei Filtern für das übermitteln eines Benutzernamens funktioniert:
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 // Eine Filterkette erstellen und die Filter der Kette hinzufügen
 $filterChain = new Zend_Filter();
 $filterChain->addFilter(new Zend_Filter_Alpha())
@@ -21,6 +22,7 @@ $filterChain->addFilter(new Zend_Filter_Alpha())
 $username = $filterChain->filter($_POST['username']);
 ]]></programlisting>
 
+    <para>
         Filter werden in der Reihenfolge ausgeführt in der Sie <classname>Zend_Filter</classname>
         hinzugefügt werden. Im obigen Beispiel wird dem Benutzernamen zuerst jedes
         nicht-alphabetische Zeichen entfernt und anschließend jeder Großbuchstabe in einen

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20760 -->
+<!-- EN-Revision: 21119 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.serializer.introduction">
     <title>Einführung</title>
@@ -11,9 +11,7 @@
     </para>
 
     <example id="zend.serializer.introduction.example.dynamic">
-        <title>
-            Verwenden des dynamischen Interfaces von <classname>Zend_Serializer</classname>
-        </title>
+        <title>Verwenden des dynamischen Interfaces von Zend_Serializer</title>
 
         <para>
             Um einen Serializer zu instanzieren sollte man die Factory Methode mit dem Namen des
@@ -39,9 +37,9 @@ try {
     </example>
 
     <para>
-        Die Methode <methodname>serialize</methodname> erzeugt einen speicherbaren String. Um diese
-        serialisierten Daten wiederherzustellen kann einfach die Methode
-        <methodname>unserialize</methodname> aufgerufen werden.
+        Die Methode <methodname>serialize()</methodname> erzeugt einen speicherbaren String. Um
+        diese serialisierten Daten wiederherzustellen kann einfach die Methode
+        <methodname>unserialize()</methodname> aufgerufen werden.
     </para>
 
     <para>
@@ -52,8 +50,9 @@ try {
 
     <para>
         Um einen gegebenen Serialisierungs-Adapter zu konfigurieren kann optional ein Array oder
-        eine Instanz von <classname>Zend_Config</classname> an die <methodname>factory</methodname>
-        oder die Methoden <methodname>un-/serialize</methodname> übergeben werden:
+        eine Instanz von <classname>Zend_Config</classname> an die
+        <methodname>factory()</methodname> oder die Methoden <methodname>serialize()</methodname>
+        und <methodname>unserialize()</methodname> übergeben werden:
     </para>
 
     <programlisting language="php"><![CDATA[
@@ -62,7 +61,11 @@ $serializer = Zend_Serializer::factory('Wddx', array(
 ));
 
 try {
-    $serialized = $serializer->serialize($data, array('comment' => 'change comment'));
+    $serialized = $serializer->serialize(
+        $data,
+        array('comment' => 'change comment')
+    );
+
     $unserialized = $serializer->unserialize(
         $serialized,
         array(/* Optionen für die Deserialisierung */)
@@ -73,12 +76,12 @@ try {
 ]]></programlisting>
 
     <para>
-        Optionen welche an <methodname>factory</methodname> übergeben werden sind für das
+        Optionen welche an <methodname>factory()</methodname> übergeben werden sind für das
         instanzierte Objekt gültig. Man kann diese Optionen verändern indem die
         <methodname>setOption(s)</methodname> Methoden verwendet werden. Um ein oder mehrere
         Optionen für einen einzelnen Aufruf zu verändern, können diese als zweites Argument
-        an die Methoden <methodname>serialize</methodname> oder <methodname>unserialize</methodname>
-        übergeben werden.
+        an die Methoden <methodname>serialize()</methodname> oder
+        <methodname>unserialize()</methodname> übergeben werden.
     </para>
 
     <example id="zend.serializer.introduction.example.static.php">

documentation/manual/de/module_specs/Zend_Server.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20818 -->
-<!-- Reviewed: 20818 -->
+<!-- EN-Revision: 21119 -->
+<!-- Reviewed: 21119 -->
 <sect1 id="zend.server.introduction">
     <title>Einführung</title>
 
@@ -9,9 +9,9 @@
         verschiedenen Serverklassen bereit, inklusive <classname>Zend_XmlRpc_Server</classname>,
         <classname>Zend_Rest_Server</classname>, <classname>Zend_Json_Server</classname> und
         <classname>Zend_Soap_Wsdl</classname>. <classname>Zend_Server_Interface</classname> stellt
-        eine Interface bereit, welches <acronym>PHP</acronym> 5's <code>SoapServer</code> Klasse
-        immitiert; alle Server Klassen sollten dieses Interface implementieren, um eine Standard
-        Server <acronym>API</acronym> bereit zu stellen.
+        eine Interface bereit, welches <acronym>PHP</acronym> 5's <classname>SoapServer</classname>
+        Klasse immitiert; alle Server Klassen sollten dieses Interface implementieren, um eine
+        Standard Server <acronym>API</acronym> bereit zu stellen.
     </para>
 
     <para>

documentation/manual/de/module_specs/Zend_Server_Reflection.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20818 -->
-<!-- Reviewed: 20818 -->
+<!-- EN-Revision: 21119 -->
+<!-- Reviewed: 21119 -->
 <sect1 id="zend.server.reflection">
     <title>Zend_Server_Reflection</title>
 
@@ -13,7 +13,7 @@
             basiert auf der <acronym>PHP</acronym> 5 Reflection <acronym>API</acronym> und erweitert
             diese, um Methoden für die Erhaltung von Parameter und Rückgabewerttypen und
             Beschreibung, eine komplette Liste mit Funktion und Methoden Prototypen (d.h.
-            alle möglichen, gültigen Aufrufkombinationen) sowie Funktions- und
+            alle möglichen, gültigen Aufrufkombinationen) sowie Funktions- oder
             Methodenbeschreibungen bereit zu stellen.
         </para>
 
@@ -62,9 +62,10 @@ $reflection->getNamespace();
         <para>
             <methodname>reflectFunction()</methodname> gibt ein
             <classname>Zend_Server_Reflection_Function</classname> Objekt zurück;
-            <code>reflectClass</code> gibt ein <classname>Zend_Server_Reflection_Class</classname>
-            Objekt zurück. Bitte die <acronym>API</acronym> Documentation beachten, um zu erfahren,
-            welche Methoden für beide Klassen verfügbar sind.
+            <methodname>reflectClass()</methodname> gibt ein
+            <classname>Zend_Server_Reflection_Class</classname> Objekt zurück. Bitte die
+            <acronym>API</acronym> Documentation beachten, um zu erfahren, welche Methoden für beide
+            Klassen verfügbar sind.
         </para>
     </sect2>
 </sect1>

documentation/manual/de/module_specs/Zend_Service_WindowsAzure.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20810 -->
+<!-- EN-Revision: 21123 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.windowsazure" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Zend_Service_WindowsAzure</title>
@@ -8,7 +8,7 @@
         <title>Einführung</title>
 
         <para>
-            Windows Azure ist der Name einer Microsoft Software + Service Plattform, einem
+            Windows Azure ist der Name von Microsoft's Software + Service Plattform, einem
             Betriebssystem in einem Cloud anbietenden Services für das Hosten, Managen von
             skalierbaren Speichern mit Unterstützung für einfache Blobs, Tabellen und Queues, sowie
             als Management Infrastruktur für provisionierte und geo-verteilte Cloud-basierte
@@ -27,9 +27,9 @@
             <listitem>
                 <para>
                     Man kann eigene Anwendungen entwickeln indem
-                    <classname>Zend_Service_WindowsAzure</classname> und die Windows Azure SDK
-                    verwendet wird, welche eine lokale Entwicklungsumgebung der von der Windows
-                    Azure Cloud Infrastruktur angebotenen Services anbietet.
+                    <classname>Zend_Service_WindowsAzure</classname> und die Windows Azure
+                    <acronym>SDK</acronym> verwendet wird, welche eine lokale Entwicklungsumgebung
+                    der von der Windows Azure Cloud Infrastruktur angebotenen Services anbietet.
                 </para>
             </listitem>
 
@@ -46,8 +46,8 @@
             Der erste Fall benötigt die Installation der <ulink
                 url="http://www.microsoft.com/downloads/details.aspx?FamilyID=6967ff37-813e-47c7-b987-889124b43abd&amp;displaylang=en">Windows
                 Azure SDK</ulink> auf der Entwicklungsmaschine. Sie ist aktuell nur für Windows
-            Umgebungen vorhanden; es gibt Fortschritte für eine Java-basierende Version der SDK
-            welche auf jeder Plattform ausgeführt werden kann.
+            Umgebungen vorhanden; es gibt Fortschritte für eine Java-basierende Version der
+            <acronym>SDK</acronym> welche auf jeder Plattform ausgeführt werden kann.
         </para>
 
         <para>
@@ -60,9 +60,9 @@
         <title>API Dokumentation</title>
 
         <para>
-            Die Klasse <classname>Zend_Service_WindowsAzure</classname> bietet den PHP Wrapper zum
-            Windows Azure <acronym>REST</acronym> Interface. Man sollte die <ulink
-                url="http://msdn.microsoft.com/en-us/library/dd179355.aspx">REST
+            Die Klasse <classname>Zend_Service_WindowsAzure</classname> bietet den
+            <acronym>PHP</acronym> Wrapper zum Windows Azure <acronym>REST</acronym> Interface. Man
+            sollte die <ulink url="http://msdn.microsoft.com/en-us/library/dd179355.aspx">REST
                 Dokumentation</ulink> für eine detailiertere Beschreibung des Services konsultieren.
             Man sollte mit den grundsätzlichen Konzepten vertraut sein um diesen Service zu
             verwenden.
@@ -79,14 +79,15 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    PHP Klassen für Windows Azure Blobs, Tabellen und Queues (für
+                    <acronym>PHP</acronym> Klassen für Windows Azure Blobs, Tabellen und Queues (für
                     <acronym>CRUD</acronym> Operationen)
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    Helfer Klassen für HTTP Transport, AuthN/AuthZ, REST und Fehlermanagement
+                    Helfer Klassen für <acronym>HTTP</acronym> Transport, AuthN/AuthZ,
+                    <acronym>REST</acronym> und Fehlermanagement
                 </para>
             </listitem>
 
@@ -103,8 +104,9 @@
 
         <para>
             <classname>Zend_Service_WindowsAzure</classname> bietet Zugriff zu Windows Azure's
-            Speicher, Berechnungs und Management Interfaces durch Abstrahierung des REST/XML
-            Interfaces welches Windows Azure bietet in einer einfachen PHP API.
+            Speicher, Berechnungs und Management Interfaces durch Abstrahierung des
+            <acronym>REST</acronym> - <acronym>XML</acronym> Interfaces welches Windows Azure bietet
+            in einer einfachen <acronym>PHP</acronym> <acronym>API</acronym>.
         </para>
 
         <para>