[MANUAL] German:

- sync to r19550

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

documentation/manual/de/manual.xml.in

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19349 -->
+<!-- EN-Revision: 19550 -->
 <!-- Reviewed: no -->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     "@DOCBOOK_DTD@"
@@ -308,6 +308,7 @@
         <xi:include href="module_specs/Zend_Log-Writers.xml" parse="xml" />
         <xi:include href="module_specs/Zend_Log-Formatters.xml" />
         <xi:include href="module_specs/Zend_Log-Filters.xml" />
+        <xi:include href="module_specs/Zend_Log-Factory.xml" />
     </chapter>
 
     <chapter id="zend.mail">

documentation/manual/de/module_specs/Zend_Log-Factory.xml

@@ -0,0 +1,424 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19550 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.log.factory">
+    <title>Die Factory verwenden um ein Log zu erstellen</title>
+
+    <para>
+        Zusätzlich zur direkten Instanzierung kann man auch die statische
+        <methodname>factory()</methodname> Methode verwenden um eine Log Instanz zu initiieren,
+        und auch um angehängte Writer und deren Filter zu konfigurieren. Bei Verwendung der
+        Factory kann man keine oder mehrere Writer anhängen. Die Konfiguration kann entweder als
+        Array oder Instanz von <classname>Zend_Config</classname> übergeben werden.
+    </para>
+
+    <para>
+        Als Beispiel:
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$logger = Zend_Log::factory(array(
+    array(
+        'writerName'   => 'Stream',
+        'writerParams' => array(
+            'stream'   => '/tmp/zend.log',
+        ),
+        'filterName'   => 'Priority',
+        'filterParams' => array(
+            'priority' => Zend_Log::WARN,
+        ),
+    ),
+    array(
+        'writerName'   => 'Firebug',
+        'filterName'   => 'Priority',
+        'filterParams' => array(
+            'priority' => Zend_Log::INFO,
+        ),
+    ),
+));
+]]></programlisting>
+
+    <para>
+        Das obige instanziert einen Logger mit zwei Writern, einen für das schreiben einer lokalen
+        Daten, und einen anderen für das Senden der Daten zu Firebug. Jeder hat einen angehängten
+        Filter für Prioritäten, mit unterschiedlichen maximalen Prioritäten.
+    </para>
+
+    <para>
+        Jeder Writer kann mit den folgenden Schlüsseln definiert werden:
+    </para>
+
+    <variablelist>
+        <varlistentry>
+            <term>writerName (required)</term>
+
+            <listitem>
+                <para>
+                    Der "kurze" Name eines Log Writers; der Name des Log Writers ohne den führenden
+                    Klassenpräfix/Namespace. Siehe auch den "writerNamespace" Eintrag weiter unten
+                    für weitere Details. Beispiele: "Mock", "Stream", "Firebug".
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term>writerParams (optional)</term>
+
+            <listitem>
+                <para>
+                    Ein assoziatives Array von Parametern das verwendet wird wenn der Log Writer
+                    instanziert wird. Jede <methodname>factory()</methodname> Methode eines Log
+                    Writers führt diese mit den Argumenten des Contructors zusammen, wie anbei
+                    erwähnt.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term>writerNamespace (optional)</term>
+
+            <listitem>
+                <para>
+                    Der Klassenpräfix/Namespace der verwendet wird wenn der endgültige Klassenname
+                    des Log Writers erstellt wird. Wird er nicht angegeben, dann wird standardmäßig
+                    "Zend_Log_Writer" angenommen; trotzdem kann man einen eigenen Namespace
+                    übergeben, wenn man einen eigenen Log Writer verwendet.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term>filterName (optional)</term>
+
+            <listitem>
+                <para>
+                    Der "kurze" Name des Filters der mit dem angegebenen Log Writer verwendet werden
+                    soll; der Name des Filters ohne den führenden Klassenpräfix/Namespace. Siehe
+                    auch den "filterNamespace" Eintrag weiter unter für weitere Details. Beispiele:
+                    "Message", "Priority".
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term>filterParams (optional)</term>
+
+            <listitem>
+                <para>
+                    An associative array of parameters to use when instantiating the log filter.
+                    Each log filter's <methodname>factory()</methodname> method will map these to
+                    constructor arguments, as noted below.
+                </para>
+            </listitem>
+        </varlistentry>
+
+        <varlistentry>
+            <term>filterNamespace (optional)</term>
+
+            <listitem>
+                <para>
+                    The class prefix/namespace to use when constructing the final log filter
+                    classname. By default, if this is not provided, "Zend_Log_Filter" is assumed;
+                    however, you can pass your own namespace if you are using a custom log filter.
+                </para>
+            </listitem>
+        </varlistentry>
+    </variablelist>
+
+    <para>
+        Each writer and each filter has specific options.
+    </para>
+
+    <sect2 id="zend.log.factory.writer-options">
+        <title>Writer Options</title>
+
+        <sect3 id="zend.log.factory.writer-options.db">
+            <title>Zend_Log_Writer_Db Options</title>
+
+            <variablelist>
+                <varlistentry>
+                    <term>db</term>
+
+                    <listitem>
+                        <para>
+                            A <classname>Zend_Db_Adapter</classname> instance.
+                        </para>
+                    </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                    <term>table</term>
+
+                    <listitem>
+                        <para>
+                            The name of the table in the RDBMS that will contain log entries.
+                        </para>
+                    </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                    <term>columnMap</term>
+
+                    <listitem>
+                        <para>
+                            An associative array mapping database table column names to log event
+                            fields.
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.firebug">
+            <title>Zend_Log_Writer_Firebug Options</title>
+
+            <para>
+                This log writer takes no options; any provided will be ignored.
+            </para>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.mail">
+            <title>Zend_Log_Writer_Mail Options</title>
+
+            <para>
+                <classname>Zend_Log_Writer_Mail</classname> currently (as of 1.10) does not
+                implement a factory, and will raise an exception if you attempt to instantiate it
+                via <methodname>Zend_Log::factory()</methodname>.
+            </para>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.mock">
+            <title>Zend_Log_Writer_Mock Options</title>
+
+            <para>
+                This log writer takes no options; any provided will be ignored.
+            </para>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.null">
+            <title>Zend_Log_Writer_Null Options</title>
+
+            <para>
+                This log writer takes no options; any provided will be ignored.
+            </para>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.stream">
+            <title>Zend_Log_Writer_Stream Options</title>
+
+            <variablelist>
+                <varlistentry>
+                    <term>stream|url</term>
+
+                    <listitem>
+                        <para>
+                            A valid PHP stream identifier to which to log.
+                        </para>
+                    </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                    <term>mode</term>
+
+                    <listitem>
+                        <para>
+                            The I/O mode with which to log; defaults to "a", for "append".
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.syslog">
+            <title>Zend_Log_Writer_Syslog Options</title>
+
+            <variablelist>
+                <varlistentry>
+                    <term>application</term>
+
+                    <listitem>
+                        <para>
+                            Application name used by the syslog writer.
+                        </para>
+                    </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                    <term>facility</term>
+
+                    <listitem>
+                        <para>
+                            Facility used by the syslog writer.
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </sect3>
+
+        <sect3 id="zend.log.factory.writer-options.zendmonitor">
+            <title>Zend_Log_Writer_ZendMonitor Options</title>
+
+            <para>
+                This log writer takes no options; any provided will be ignored.
+            </para>
+        </sect3>
+    </sect2>
+
+    <sect2 id="zend.log.factory.filter-options">
+        <title>Filter Options</title>
+
+        <sect3 id="zend.log.factory.filter-options.message">
+            <title>Zend_Log_Filter_Message Options</title>
+
+            <variablelist>
+                <varlistentry>
+                    <term>regexp</term>
+
+                    <listitem>
+                        <para>
+                            Regular expression that must be matched in order to log a message.
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </sect3>
+
+        <sect3 id="zend.log.factory.filter-options.priority">
+            <title>Zend_Log_Filter_Priority Options</title>
+
+            <variablelist>
+                <varlistentry>
+                    <term>priority</term>
+
+                    <listitem>
+                        <para>
+                            The maximum priority level by which messages will be logged.
+                        </para>
+                    </listitem>
+                </varlistentry>
+
+                <varlistentry>
+                    <term>operator</term>
+
+                    <listitem>
+                        <para>
+                            The comparison operator by which to do priority comparisons; defaults to
+                            "&lt;=".
+                        </para>
+                    </listitem>
+                </varlistentry>
+            </variablelist>
+        </sect3>
+
+        <sect3 id="zend.log.factory.filter-options.suppress">
+            <title>Zend_Log_Writer_Suppress Options</title>
+
+            <para>
+                This log filter takes no options; any provided will be ignored.
+            </para>
+        </sect3>
+    </sect2>
+
+    <sect2 id="zend.log.factory.custom">
+        <title>Creating Configurable Writers and Filters</title>
+
+        <para>
+            If you find yourself needing to write your own log writers and/or filters, you can make
+            them compatible with <methodname>Zend_Log::factory()</methodname> very easily.
+        </para>
+
+        <para>
+            At the minimum, you need to implement
+            <interfacename>Zend_Log_FactoryInterface</interfacename>, which expects a static
+            <methodname>factory()</methodname> method that accepts a single argument,
+            <varname>$config</varname>, which may be either an array or
+            <classname>Zend_Config</classname> object. If your log writer extends
+            <classname>Zend_Log_Writer_Abstract</classname>, or your log filter extends
+            <classname>Zend_Log_Filter_Abstract</classname>, you will pick this up for free.
+        </para>
+
+        <para>
+            Then, simply define mappings between the accepted configuration and any constructor
+            arguments. As an example:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class My_Log_Writer_Foo extends Zend_Log_Writer_Abstract
+{
+    public function __construct($bar, $baz)
+    {
+        // ...
+    }
+
+    public static function factory($config)
+    {
+        if ($config instanceof Zend_Config) {
+            $config = $config->toArray();
+        }
+        if (!is_array($config)) {
+            throw new Exception(
+                'factory expects an array or Zend_Config instance'
+            );
+        }
+
+        $default = array(
+            'bar' => null,
+            'baz' => null,
+        );
+        $config = array_merge($default, $config);
+
+        return new self(
+            $config['bar'],
+            $config['baz']
+        );
+    }
+}
+]]></programlisting>
+
+        <para>
+            Alternately, you could call appropriate setters after instantiation, but prior to
+            returning the instance:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class My_Log_Writer_Foo extends Zend_Log_Writer_Abstract
+{
+    public function __construct($bar = null, $baz = null)
+    {
+        // ...
+    }
+
+    public function setBar($value)
+    {
+        // ...
+    }
+
+    public function setBaz($value)
+    {
+        // ...
+    }
+
+    public static function factory($config)
+    {
+        if ($config instanceof Zend_Config) {
+            $config = $config->toArray();
+        }
+        if (!is_array($config)) {
+            throw new Exception(
+                'factory expects an array or Zend_Config instance'
+            );
+        }
+
+        $writer = new self();
+        if (isset($config['bar'])) {
+            $writer->setBar($config['bar']);
+        }
+        if (isset($config['baz'])) {
+            $writer->setBaz($config['baz']);
+        }
+        return $writer;
+    }
+}
+]]></programlisting>
+    </sect2>
+</sect1>

documentation/manual/de/module_specs/Zend_Service_LiveDocx.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19452 -->
+<!-- EN-Revision: 19522 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.service.livedocx">
     <title>Zend_Service_LiveDocx</title>
@@ -293,21 +293,17 @@
                 Oder durch das folgende Diagramm ausgedrückt werden:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.generation-diabasic.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.generation-diabasic.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Daten werden in ein Template eingefügt um ein Dokument zu erstellen (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.generation-diabasic_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Daten werden in ein Template eingefügt um ein Dokument zu erstellen (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.generation-diabasic_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Ein Template das in einer Word Bearbeitungsanwendung, wie Microsoft Word, erstellt
@@ -325,21 +321,17 @@
                 Er sieht wie folgt aus:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.templates-msworddialog.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.templates-msworddialog.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Dialogbox Felder in Microsoft Word 2007 (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.templates-msworddialog_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Dialogbox Felder in Microsoft Word 2007 (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.templates-msworddialog_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Durch Verwendung dieses Dialogs kann man die benötigten Merge-Felder in das eigene
@@ -347,21 +339,17 @@
                 Word 2007. Die Merge Felder sind als <code>{ MERGEFIELD FieldName }</code> markiert:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatefull.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatefull.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Das Template in Microsoft Word 2007 (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatefull_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Das Template in Microsoft Word 2007 (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatefull_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Jetzt muss das Template als <emphasis>template.docx</emphasis> gespeichert werden.
@@ -372,21 +360,17 @@
                 PHP.
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatecropped.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatecropped.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Unterteiltes Template in Microsoft Word 2007 (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatecropped_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Unterteiltes Template in Microsoft Word 2007 (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.templates-mswordtemplatecropped_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Um die Merge Felder, im vorher unterteilten Screenshot des <ulink
@@ -421,22 +405,18 @@ file_put_contents('document.pdf', $document);
                 gezeigt:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.templates-msworddocument.png"
-                        format="PNG"></imagedata>
-                </imageobject>
-
-                <caption>
-                    <para>
-                        Resultierendes Dokument als <acronym>PDF</acronym> im Document Viewer 2.26.1
-                        (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.templates-msworddocument_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.templates-msworddocument.png"
+                    format="PNG" />
+            </para>
+
+            <para>
+                Resultierendes Dokument als <acronym>PDF</acronym> im Document Viewer 2.26.1
+                (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.templates-msworddocument_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
         </sect3>
 
         <sect3 id="zend.service.livedocx.mailmerge.advanced">
@@ -471,21 +451,17 @@ file_put_contents('document.pdf', $document);
                 Namen. Der folgende Screenshot zeigt diese Ziele und deren Namen in Rot:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.advanced-mergefieldblockformat.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.advanced-mergefieldblockformat.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.advanced-mergefieldblockformat_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.advanced-mergefieldblockformat_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Das Format eines Blocks ist wie folgt:
@@ -514,21 +490,17 @@ blockEnd_block1
                 verwendet werden:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.advanced-mswordblockstemplate.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.advanced-mswordblockstemplate.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Template, welches Blöcke in Microsoft Word 2007 zeigt (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.advanced-mswordblockstemplate_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Template, welches Blöcke in Microsoft Word 2007 zeigt (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.advanced-mswordblockstemplate_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Der folgende Code füllt das obige Template mit Daten.
@@ -590,22 +562,18 @@ file_put_contents('document.pdf', $document);
                 gezeigt:
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.advanced-mswordblocksdocument.png"
-                        format="PNG"></imagedata>
-                </imageobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.advanced-mswordblocksdocument.png"
+                    format="PNG" />
+            </para>
 
-                <caption>
-                    <para>
-                        Das resultierende Dokument als <acronym>PDF</acronym> im Document Viewer
-                        2.26.1 (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.advanced-mswordblocksdocument_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                Das resultierende Dokument als <acronym>PDF</acronym> im Document Viewer
+                2.26.1 (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.advanced-mswordblocksdocument_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
 
             <para>
                 Man kann die <acronym>DOC</acronym> <ulink
@@ -688,37 +656,29 @@ foreach ($bitmaps as $pageNumber => $bitmapData) {
                 in das gleiche Verzeichnis wie die ausführbare PHP Datei.
             </para>
 
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage1.png"
-                        format="PNG"></imagedata>
-                </imageobject>
-
-                <caption>
-                    <para>
-                        documentPage1.png (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage1_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
-
-            <mediaobject>
-                <imageobject>
-                    <imagedata
-                        fileref="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage2.png"
-                        format="PNG"></imagedata>
-                </imageobject>
-
-                <caption>
-                    <para>
-                        documentPage2.png (<ulink
-                            url="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage2_zoom.png">größer
-                            darstellen</ulink>).
-                    </para>
-                </caption>
-            </mediaobject>
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage1.png"
+                    format="PNG" />
+            </para>
+
+            <para>
+                documentPage1.png (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage1_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
+
+            <para>
+                <inlinegraphic
+                    fileref="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage2.png"
+                    format="PNG" />
+            </para>
+
+            <para>
+                documentPage2.png (<ulink
+                    url="figures/zend.service.livedocx.mailmerge.bitmaps-documentpage2_zoom.png">größer
+                    darstellen</ulink>).
+            </para>
         </sect3>
 
         <sect3 id="zend.service.livedocx.mailmerge.templates-types">

documentation/manual/de/ref/migration-17.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18833 -->
+<!-- EN-Revision: 19523 -->
 <!-- Reviewed: no -->
 <sect1 id="migration.17">
     <title>Zend Framework 1.7</title>
@@ -68,13 +68,13 @@
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Filter_File_Rename($oldfile, $newfile,
-                            $overwrite)</command>
+                        <methodname>Zend_Filter_File_Rename($oldfile, $newfile,
+                            $overwrite)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Filter_File_Rename($options)</command> wobei
+                        <methodname>Zend_Filter_File_Rename($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>source</emphasis> identisch mit
                         <varname>$oldfile</varname>, <emphasis>target</emphasis> identisch mit
@@ -108,12 +108,12 @@ $upload->addFilter('Rename',
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Count($min, $max)</command>
+                        <methodname>Zend_Validate_File_Count($min, $max)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Count($options)</command> wobei
+                        <methodname>Zend_Validate_File_Count($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>min</emphasis> identisch mit <varname>$min</varname>,
                         <emphasis>max</emphasis> identisch mit <varname>$max</varname>
@@ -145,12 +145,12 @@ $upload->addValidator('Count',
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Extension($extension, $case)</command>
+                        <methodname>Zend_Validate_File_Extension($extension, $case)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Extension($options)</command> wobei
+                        <methodname>Zend_Validate_File_Extension($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>*</emphasis> identisch mit
                         <varname>$extension</varname> und kann jeden anderen Schlüssel haben
@@ -183,12 +183,13 @@ $upload->addValidator('Extension',
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_FilesSize($min, $max, $bytestring)</command>
+                        <methodname>Zend_Validate_File_FilesSize($min, $max,
+                            $bytestring)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_FilesSize($options)</command> wobei
+                        <methodname>Zend_Validate_File_FilesSize($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>min</emphasis> identisch mit <varname>$min</varname>,
                         <emphasis>max</emphasis> identisch mit <varname>$max</varname>,
@@ -236,12 +237,12 @@ $upload->setUseByteSting(true); // Flag setzen
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Hash($hash, $algorithm)</command>
+                        <methodname>Zend_Validate_File_Hash($hash, $algorithm)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Hash($options)</command> wobei
+                        <methodname>Zend_Validate_File_Hash($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>*</emphasis> identisch mit <varname>$hash</varname>
                         und kann jeden anderen Schlüssel haben <emphasis>algorithm</emphasis>
@@ -274,13 +275,13 @@ $upload->addValidator('Hash',
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth,
-                            $maxheight)</command>
+                        <methodname>Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth,
+                            $maxheight)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_FilesSize($options)</command> wobei
+                        <methodname>Zend_Validate_File_FilesSize($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>minwidth</emphasis> identisch mit
                         <varname>$minwidth</varname>, <emphasis>maxwidth</emphasis> identisch mit
@@ -317,12 +318,12 @@ $upload->addValidator('ImageSize',
                 <itemizedlist>
                     <listitem><para>
                         Alte <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Size($min, $max, $bytestring)</command>
+                        <methodname>Zend_Validate_File_Size($min, $max, $bytestring)</methodname>
                     </para></listitem>
 
                     <listitem><para>
                         Neue <acronym>API</acronym> der Methode:
-                        <command>Zend_Validate_File_Size($options)</command> wobei
+                        <methodname>Zend_Validate_File_Size($options)</methodname> wobei
                         <varname>$options</varname> die folgenden Schlüssel für das Array
                         akzeptiert: <emphasis>min</emphasis> identisch mit <varname>$min</varname>,
                         <emphasis>max</emphasis> identisch mit <varname>$max</varname>,
@@ -366,7 +367,7 @@ $upload->addValidator('Size',
                 zurückgegeben wird, zu verwenden, aber das triggert auch eine User Warning die
                 darauf hinweist das man auf das neue Verhalten wechseln sollte. Das Rerouting
                 welches das alte Verhalten von <methodname>isLocale()</methodname> durchgeführt
-                hätte ist nicht länger notwendig, da alle I18N Komponenten jetzt das Rerouting
+                hätte ist nicht länger notwendig, da alle I18n Komponenten jetzt das Rerouting
                 selbst durchführen.
             </para>
 

documentation/manual/de/ref/migration-19.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19425 -->
+<!-- EN-Revision: 19523 -->
 <!-- Reviewed: no -->
 <sect1 id="migration.19">
     <title>Zend Framework 1.9</title>
@@ -147,8 +147,8 @@ $client->setFileUpload('file2.txt',
                 Beginnend mit Version 1.9, wird die geschützte Methode
                 <methodname>_getParametersRecursive()</methodname> nicht mehr von
                 <classname>Zend_Http_Client</classname> verwendet und ist abgelehnt (deprecated).
-                Ihre Verwendung führt zu einer E_NOTICE Nachricht die von <acronym>PHP</acronym>
-                kommt.
+                Ihre Verwendung führt zu einer <constant>E_NOTICE</constant> Nachricht die von
+                <acronym>PHP</acronym> kommt.
             </para>
 
             <para>
@@ -158,8 +158,8 @@ $client->setFileUpload('file2.txt',
             </para>
 
             <para>
-                Nochmals, da <classname>_getParametersRecursive</classname> eine geschützte Methode
-                ist, sind nur Benutzer betroffen die <classname>Zend_Http_Client</classname>
+                Nochmals, da <methodname>_getParametersRecursive()</methodname> eine geschützte
+                Methode ist, sind nur Benutzer betroffen die <classname>Zend_Http_Client</classname>
                 erweitert haben.
             </para>
         </sect3>
@@ -192,36 +192,84 @@ $client->setFileUpload('file2.txt',
                     </thead>
                     <tbody>
                         <row>
-                            <entry>getLanguageTranslationList($locale)</entry>
-                            <entry>getTranslationList('language', $locale)</entry>
+                            <entry>
+                                <methodname>getLanguageTranslationList($locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslationList('language', $locale)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getScriptTranslationList($locale)</entry>
-                            <entry>getTranslationList('script', $locale)</entry>
+                            <entry>
+                                <methodname>getScriptTranslationList($locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslationList('script', $locale)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getCountryTranslationList($locale)</entry>
-                            <entry>getTranslationList('territory', $locale, 2)</entry>
+                            <entry>
+                                <methodname>getCountryTranslationList($locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslationList('territory', $locale, 2)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getTerritoryTranslationList($locale)</entry>
-                            <entry>getTranslationList('territory', $locale, 1)</entry>
+                            <entry>
+                                <methodname>getTerritoryTranslationList($locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslationList('territory', $locale, 1)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getLanguageTranslation($value, $locale)</entry>
-                            <entry>getTranslation($value, 'language', $locale)</entry>
+                            <entry>
+                                <methodname>getLanguageTranslation($value, $locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslation($value, 'language', $locale)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getScriptTranslation($value, $locale)</entry>
-                            <entry>getTranslation($value, 'script', $locale)</entry>
+                            <entry>
+                                <methodname>getScriptTranslation($value, $locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslation($value, 'script', $locale)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getCountryTranslation($value, $locale)</entry>
-                            <entry>getTranslation($value, 'country', $locale)</entry>
+                            <entry>
+                                <methodname>getCountryTranslation($value, $locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslation($value, 'country', $locale)</methodname>
+                            </entry>
                         </row>
+
                         <row>
-                            <entry>getTerritoryTranslation($value, $locale)</entry>
-                            <entry>getTranslation($value, 'territory', $locale)</entry>
+                            <entry>
+                                <methodname>getTerritoryTranslation($value, $locale)</methodname>
+                            </entry>
+
+                            <entry>
+                                <methodname>getTranslation($value, 'territory',
+                                    $locale)</methodname>
+                            </entry>
                         </row>
                     </tbody>
                 </tgroup>
@@ -235,14 +283,14 @@ $client->setFileUpload('file2.txt',
         <para>
             Vor dem Release 1.9 hat der Menü Helfer
             (<classname>Zend_View_Helper_Navigation_Menu</classname>) Untermenüs nicht richtig
-            dargestellt. Wenn <code>onlyActiveBranch</code> <constant>TRUE</constant> war und die
-            Option <code>renderParents</code> <constant>FALSE</constant> wurde nichts dargestellt
-            wenn die tiefste aktive Seite auf einer geringeren Tiele als die <code>minDepth</code>
-            Option war.
+            dargestellt. Wenn <property>onlyActiveBranch</property> <constant>TRUE</constant> war
+            und die Option <property>renderParents</property> <constant>FALSE</constant> wurde
+            nichts dargestellt wenn die tiefste aktive Seite auf einer geringeren Tiele als die
+            <property>minDepth</property> Option war.
         </para>
 
         <para>
-            In einfacheren Worten; Wenn <code>minDepth</code> auf <code>1</code> gesetzt war und
+            In einfacheren Worten; Wenn <property>minDepth</property> auf '1' gesetzt war und
             die aktive Seite eine der Seiten am Anfangs-Level, wurde nichts dargestellt wie das
             folgende Beispiel zeigt.
         </para>
@@ -299,7 +347,7 @@ $container = new Zend_Navigation(array(
         <para>
             Seit dem Release 1.9 akzeptiert die <methodname>_renderDeepestMenu()</methodname>
             Methode in <classname>Zend_View_Helper_Navigation_Menu</classname> aktive Seiten die ein
-            Level unter <code>minDepth</code> sind, solange diese Seite Kinder hat.
+            Level unter <property>minDepth</property> sind, solange diese Seite Kinder hat.
         </para>
 
         <para>