[GENERIC] Manual:

- sync up to r21229

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

documentation/manual/de/module_specs/Zend_Date-Constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20766 -->
+<!-- EN-Revision: 21215 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.date.constants">
     <title>Konstanten für generelle Datums Funktionen</title>
@@ -1262,7 +1262,7 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
 
                     <row>
                         <entry>A</entry>
-                        <entry>Millisekunde</entry>
+                        <entry>Millisekunden des aktuellen Tages</entry>
                         <entry><constant>Zend_Date::MILLISECOND</constant></entry>
                         <entry><emphasis>20563</emphasis></entry>
                     </row>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21123 -->
+<!-- EN-Revision: 21212 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.decrypt">
     <title>Decrypt</title>
@@ -91,7 +91,16 @@ print $decrypted;
                 <para>
                     <emphasis>envelope</emphasis>: Der verschlüsselte Umschlagschlüssel vom Benutzer
                     der den Inhalt verschlüsselt hat. Man kann entweder den Pfad mit dem Dateinamen
-                    zur Schlüsseldatei angeben, oder den Inhalt der Schlüsseldatei selbst.
+                    zur Schlüsseldatei angeben, oder den Inhalt der Schlüsseldatei selbst. Wenn die
+                    <property>package</property> Option gesetzt wurde, kann man diesen Parameter
+                    unterdrücken.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>package</emphasis>: Ob der Umschlagschlüssel mit dem verschlüsselten
+                    Wert gepackt werden soll. Der Standardwert ist <constant>FALSE</constant>.
                 </para>
             </listitem>
         </itemizedlist>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21212 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.encrypt">
     <title>Encrypt</title>
@@ -108,6 +108,15 @@ $filter->setAdapter('openssl');
                     verschlüsselt. Der Standardwert ist <constant>FALSE</constant>.
                 </para>
             </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>compression</emphasis>: Ob der verschlüsselte Wert komprimiert werden
+                    soll. Der Standard ist nicht komprimiert. Für Details sehen Sie unter <link
+                        linkend="zend.filter.set.encrypt.openssl.compressed">Komprimierung für
+                        Openssl</link> nach.
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -195,6 +204,20 @@ print $encrypted;
                     Schlüsseldatei selbst.
                 </para>
             </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>compression</emphasis>: Ob der verschlüsselte Wert komprimiert werden
+                    soll. Standardmäßig wird nicht komprimiert.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>package</emphasis>: Ob der Umschlagschlüssel mit dem verschlüsselten
+                    Wert gepackt werden soll. Der Standardwert ist <constant>FALSE</constant>.
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -288,5 +311,91 @@ print $encrypted;
 
 // Für die Entschlüsselung siehe beim Decrypt Filter
 ]]></programlisting>
+
+        <sect4 id="zend.filter.set.encrypt.openssl.simplified">
+            <title>Vereinfachte Verwendung mit Openssl</title>
+
+            <para>
+                Wie vorher zu sehen war, muss man den Umschlagschlüssel holen um in der Lage zu sein
+                den vorher verschlüsselten Wert wieder zu entschlüsseln. Das kann sehr frustrierend
+                sein wenn man mit mehreren Werten arbeitet.
+            </para>
+
+            <para>
+                Für eine vereinfachte Verwendung kann man die <property>package</property> Option
+                auf <constant>TRUE</constant> setzen. Der Standardwert ist
+                <constant>FALSE</constant>.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Verwende openssl und gib einen privaten Schlüssel an
+$filter = new Zend_Filter_Encrypt(array(
+    'adapter' => 'openssl',
+    'private' => '/path/to/mykey/private.pem',
+    'public'  => '/public/key/path/public.pem',
+    'package' => true
+));
+
+$encrypted = $filter->filter('text_to_be_encoded');
+print $encrypted;
+
+// Für die Entschlüsselung siehe beim Decrypt Filter
+]]></programlisting>
+
+            <para>
+                Jetzt enthält der zurückgegebene Wert sowohl den verschlüsselten Wert als auch den
+                Umschlagschlüssel. Man muss diesen also nicht mehr nach der Verschlüsselung holen.
+                Aber, und das ist der negative Aspekt dieses Features, der verschlüsselte Wert kann
+                jetzt nur mehr entschlüsselt werden indem man
+                <classname>Zend_Filter_Encrypt</classname> verwendet.
+            </para>
+        </sect4>
+
+        <sect4 id="zend.filter.set.encrypt.openssl.compressed">
+            <title>Komprimieren des Inhalts</title>
+
+            <para>
+                Basierend auf dem originalen Wert, kann der verschlüsselte Wert ein sehr langer
+                String sein. Um den Wert zu reduzieren erlaubt
+                <classname>Zend_Filter_Encrypt</classname> die Verwendung von Kompression.
+            </para>
+
+            <para>
+                Die <property>compression</property> Option kann entweder auf den Namen eines
+                Komprimierungsadapters gesetzt werden, oder auf ein Array welches alle gewünschten
+                Optionen für den Komprimierungsadapter setzt.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Verwende nur den grundsätzlichen Komprimierungsadapter
+$filter1 = new Zend_Filter_Encrypt(array(
+    'adapter'     => 'openssl',
+    'private'     => '/path/to/mykey/private.pem',
+    'public'      => '/public/key/path/public.pem',
+    'package'     => true,
+    'compression' => 'bz2'
+));
+
+// Verwende den Basis Komprimierungsadapter
+$filter2 = new Zend_Filter_Encrypt(array(
+    'adapter'     => 'openssl',
+    'private'     => '/path/to/mykey/private.pem',
+    'public'      => '/public/key/path/public.pem',
+    'package'     => true,
+    'compression' => array('adapter' => 'zip', 'target' => '\usr\tmp\tmp.zip')
+));
+]]></programlisting>
+
+            <note>
+                <title>Entschlüsselung mit den selben Werten</title>
+
+                <para>
+                    Wenn man einen Wert entschlüsseln will welcher zusätzlich komprimiert wurde,
+                    dann muss man die selben Komprimierungseinstellungen für die Entschlüsselung
+                    verwenden wie bei der Verschlüsselung. Andernfalls wird die Entschlüsselung
+                    fehlschlagen.
+                </para>
+            </note>
+        </sect4>
     </sect3>
 </sect2>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21217 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.filter.inflector">
     <title>Zend_Filter_Inflector</title>
@@ -445,7 +445,7 @@ $inflector->addRules(array(
             <classname>Zend_Config</classname> kann verwendet werden um Regeln, Filter Präfix Pfade,
             oder andere Objektstati im Beugungsmachanismus zu setzen, entweder durch die Übergabe
             eines <classname>Zend_Config</classname> Objekts zum Konstruktor, oder durch
-            <methodname>setConfig()</methodname>. Die folgenden Einstellungen können spezifiziert
+            <methodname>setOptions()</methodname>. Die folgenden Einstellungen können spezifiziert
             werden:
         </para>
 
@@ -494,9 +494,9 @@ $inflector->addRules(array(
 $config    = new Zend_Config($options);
 $inflector = new Zend_Filter_Inflector($config);
 
-// Oder mit setConfig():
+// Oder mit setOptions():
 $inflector = new Zend_Filter_Inflector();
-$inflector->setConfig($config);
+$inflector->setOptions($config);
 ]]></programlisting>
         </example>
     </sect2>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21194 -->
+<!-- EN-Revision: 21213 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.messages">
     <title>Prüfungsmeldungen</title>
@@ -88,7 +88,7 @@ $translator = new Zend_Translate(
     'array',
     '/resources/languages',
     $language,
-    array('scan' => Zend_Locale::LOCALE_DIRECTORY)
+    array('scan' => Zend_Translate::LOCALE_DIRECTORY)
 );
 Zend_Validate_Abstract::setDefaultTranslator($translator);
 ]]></programlisting>