[DOCUMENTATION] French: sync manual

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

documentation/manual/fr/module_specs/Zend_Filter-Boolean.xml

@@ -1,21 +1,55 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 21994 -->
+<!-- EN-Revision: 24249 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.boolean">
     <title>Boolean</title>
 
     <para>
-        Ce filtre transforme toute donnée en valeur <constant>BOOLEENNE</constant>. Ce peut être
+        Ce filtre transforme toute donnée en valeur <constant>BOOLEAN</constant>. Ce peut être
         utile en travaillant avec des bases de données ou des formulaires.
     </para>
 
+    <sect3 id="zend.filter.set.boolean.options">
+        <title>Options supportées par Zend_Filter_Boolean</title>
+
+        <para>
+            Les options suivantes sont supportées par
+            <classname>Zend_Filter_Boolean</classname>&#160;:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>casting</property></emphasis>&#160;: quand cette option
+                    est fixée à <constant>TRUE</constant> alors toute entrée sera transtypée en
+                    booléen. Cette option vaut <constant>TRUE</constant> par défaut.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>locale</property></emphasis>&#160;: cette option permet
+                    de spécifier la locale qui sera utilisée pour détecter une entrée localisée.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>type</property></emphasis>&#160;: l'option
+                    <property>type</property> spécifie le type de booléen qui sera utilisé.
+                    Lisez ce qui suit pour plus de détails.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
     <sect3 id="zend.filter.set.boolean.default">
         <title>Comportement par défaut de Zend_Filter_Boolean</title>
 
         <para>
-            Par défaut, ce filtre caste (transtype) sa valeur vers un
+            Par défaut, ce filtre transtype sa valeur vers un
             <constant>BOOLEEN</constant>&#160;; en d'autres termes, il fonctionne comme un appel
-            PHP <command>(boolean) $value</command>.
+            PHP de type <command>(boolean) $value</command>.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -28,7 +62,7 @@ $result = $filter->filter($value);
         <para>
             Ceci signifie que sans paramètre additionnel,
             <classname>Zend_Filter_Boolean</classname> prend toute valeur d'entrée et retourne un
-            <constant>BOOLEEN</constant> comme le cast PHP vers le
+            <constant>BOOLEEN</constant> comme le transtypage PHP vers le
             <constant>BOOLEEN</constant>.
         </para>
     </sect3>
@@ -37,7 +71,7 @@ $result = $filter->filter($value);
         <title>Changer le comportement de Zend_Filter_Boolean</title>
 
         <para>
-            Quelques fois, le cast vers tel que <command>(boolean)</command> peut ne pas suffire.
+            Parfois, le transtypage tel que <command>(boolean)</command> peut ne pas suffire.
             <classname>Zend_Filter_Boolean</classname> permet ainsi de configurer les types d'entrée
             à convertir, et ceux à ignorer.
         </para>
@@ -49,27 +83,27 @@ $result = $filter->filter($value);
         <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis>booléen</emphasis>&#160;: retourne la valeur booléenne telle quelle.
+                    <emphasis>boolean</emphasis>&#160;: retourne la valeur booléenne telle quelle.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>entier</emphasis>&#160;: convertit l'entier <emphasis>0</emphasis>
+                    <emphasis>integer</emphasis>&#160;: convertit l'entier <emphasis>0</emphasis>
                     en <constant>FALSE</constant>.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>flottant</emphasis>&#160;: convertit le flottant
+                    <emphasis>float</emphasis>&#160;: convertit le flottant
                     <emphasis>0.0</emphasis> en <constant>FALSE</constant>.
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis>chaine</emphasis>&#160;: convertit la chaîne vide
+                    <emphasis>string</emphasis>&#160;: convertit la chaîne vide
                     <emphasis>''</emphasis> en <constant>FALSE</constant>.
                 </para>
             </listitem>
@@ -104,7 +138,7 @@ $result = $filter->filter($value);
 
             <listitem>
                 <para>
-                    <emphasis>false_string</emphasis>&#160;: convertit une chaine contenant le mot
+                    <emphasis>false_string</emphasis>&#160;: convertit une chaîne contenant le mot
                     "false" en booléen <constant>FALSE</constant>.
                 </para>
             </listitem>
@@ -118,7 +152,7 @@ $result = $filter->filter($value);
 
             <listitem>
                 <para>
-                    <emphasis>all</emphasis>: Convertit tous les types ci-dessus vers un
+                    <emphasis>all</emphasis>&#160;: convertit tous les types ci-dessus vers un
                     <constant>BOOLEEN</constant>.
                 </para>
             </listitem>
@@ -170,7 +204,7 @@ $filter = new Zend_Filter_Boolean(array(
         <title>Booléens localisés</title>
 
         <para>
-            Comme déja précisé, <classname>Zend_Filter_Boolean</classname> reconnait les chaînes
+            Comme déjà précisé, <classname>Zend_Filter_Boolean</classname> reconnaît les chaînes
             localisées "yes" et "no". Ceci signifie que vous pouvez demander au client au travers
             d'un formulaire "oui" ou "non" dans sa propre langue et
             <classname>Zend_Filter_Boolean</classname> convertira la valeur vers le booléen
@@ -199,10 +233,10 @@ $filter->filter('yes');
     </sect3>
 
     <sect3 id="zend.filter.set.boolean.casting">
-        <title>Désactiver le cast (transtypage)</title>
+        <title>Désactiver le transtypage</title>
 
         <para>
-            Il peut arriver de ne vouloir que reconnaitre <constant>TRUE</constant> ou
+            Il peut arriver de ne vouloir que reconnaître <constant>TRUE</constant> ou
             <constant>FALSE</constant> et donc retourner les autres valeurs telles quelles.
             <classname>Zend_Filter_Boolean</classname> permet un tel comportement via son
             option <property>casting</property> lorsque réglée sur <constant>FALSE</constant>.
@@ -222,9 +256,7 @@ $filter->filter('yes');
                 <thead>
                     <row>
                         <entry>Type</entry>
-
                         <entry>True</entry>
-
                         <entry>False</entry>
                     </row>
                 </thead>
@@ -232,73 +264,55 @@ $filter->filter('yes');
                 <tbody>
                     <row>
                         <entry><constant>Zend_Filter_Boolean::BOOLEAN</constant></entry>
-
                         <entry><constant>TRUE</constant></entry>
-
                         <entry><constant>FALSE</constant></entry>
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::INTEGER</constant></entry>
-
                         <entry>0</entry>
-
                         <entry>1</entry>
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::FLOAT</constant></entry>
-
                         <entry>0.0</entry>
-
                         <entry>1.0</entry>
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::STRING</constant></entry>
-
                         <entry>""</entry>
-
                         <entry />
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::ZERO</constant></entry>
-
                         <entry>"0"</entry>
-
                         <entry>"1"</entry>
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::EMPTY_ARRAY</constant></entry>
-
                         <entry><methodname>array()</methodname></entry>
-
                         <entry />
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::NULL</constant></entry>
-
                         <entry><constant>NULL</constant></entry>
-
                         <entry />
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::FALSE_STRING</constant></entry>
-
                         <entry>"false" (non sensible à la casse)</entry>
-
                         <entry>"true" (non sensible à la casse)</entry>
                     </row>
 
                     <row>
                         <entry><constant>Zend_Filter_Boolean::YES</constant></entry>
-
                         <entry>"oui" localisé (non sensible à la casse)</entry>
-
                         <entry>"non" localisé (non sensible à la casse)</entry>
                     </row>
                 </tbody>

documentation/manual/fr/module_specs/Zend_Filter-Callback.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 24249 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.callback">
     <title>Callback</title>
@@ -9,23 +9,52 @@
         méthode fait déja le travail.
     </para>
 
-    <para>
-        Par exemple un filtre qui inverse une chaine.
-    </para>
+    <sect3 id="zend.filter.set.callback.options">
+        <title>Options supportées par Zend_Filter_Callback</title>
+
+        <para>
+            Les options suivantes sont supportées par
+            <classname>Zend_Filter_Callback</classname>&#160;:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>callback</property></emphasis>&#160;: ceci spécifie
+                    le callback qui sera utilisé.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>options</property></emphasis>&#160;: cette propriété
+                    les options utilisées lorsque le callback est exécuté.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.filter.set.callback.basic">
+        <title>Utilisation de base</title>
+
+        <para>
+            L'utilisation de ce filtre est assez simple. Prenos par exemple un filtre qui inverse
+            une chaine.
+        </para>
 
-    <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $filter = new Zend_Filter_Callback('strrev');
 
 print $filter->filter('Hello!');
 // retourne "!olleH"
 ]]></programlisting>
 
-    <para>
-        C'est très simple de passer une fonction à appliquer comme filtre. Dans le cas de méthodes
-        de classes, passez un tableau comme callback.
-    </para>
+        <para>
+            C'est très simple de passer une fonction à appliquer comme filtre. Dans le cas de
+            méthodes de classes, passez un tableau comme callback.
+        </para>
 
-    <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // Notre classe
 class MyClass
 {
@@ -37,18 +66,31 @@ $filter = new Zend_Filter_Callback(array('MyClass', 'Reverse'));
 print $filter->filter('Hello!');
 ]]></programlisting>
 
-    <para>
-        Pour récupérer la fonction de filtrage actuelle, utilisez
-        <methodname>getCallback()</methodname> et pour en affecter une nouvelle, utilisez
-        <methodname>setCallback()</methodname>.
-    </para>
+        <para>
+            Pour récupérer la fonction de filtrage actuelle, utilisez
+            <methodname>getCallback()</methodname> et pour en affecter une nouvelle, utilisez
+            <methodname>setCallback()</methodname>.
+        </para>
 
-    <para>
-        Il est aussi possible de définir des paramètres par défaut qui sont alors passés à la
-        méthode appelée lorsque le filtre est exécuté.
-    </para>
+        <note>
+            <title>Exception possible</title>
+
+            <para>
+                Notez que passer une fonction qui ne peut être appelée mènera à une exception.
+            </para>
+        </note>
+
+    </sect3>
+
+    <sect3 id="zend.filter.set.callback.parameters">
+        <title>Default parameters within a callback</title>
+
+        <para>
+            Il est aussi possible de définir des paramètres par défaut qui sont alors passés à la
+            méthode appelée lorsque le filtre est exécuté.
+        </para>
 
-    <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $filter = new Zend_Filter_Callback(
     array(
         'callback' => 'MyMethod',
@@ -58,18 +100,12 @@ $filter = new Zend_Filter_Callback(
 $filter->filter(array('value' => 'Hello'));
 ]]></programlisting>
 
-    <para>
-        L'appel manuel à une telle fonction se serait fait comme cela:
-    </para>
-
-    <programlisting language="php"><![CDATA[
-$value = MyMethod('Hello', 'param1', 'param2');
-]]></programlisting>
-
-    <note>
         <para>
-            Notez que passer une fonction qui ne peut être appelée mènera à une exception.
+            L'appel manuel à une telle fonction se serait fait comme cela:
         </para>
-    </note>
 
+        <programlisting language="php"><![CDATA[
+$value = MyMethod('Hello', 'param1', 'param2');
+]]></programlisting>
+    </sect3>
 </sect2>

documentation/manual/fr/module_specs/Zend_Filter-Compress.xml

@@ -1,56 +1,92 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 24249 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.filter.set.compress">
     <title>Compression et décompression</title>
     <para>
-        Ces deux filtres sont capables de compresser et décompresser des chaines, des fichiers ou des
-        dossiers. Ils utilisent des adaptateurs dans ce but et supportent les formats suivants:
+        Ces deux filtres sont capables de compresser et décompresser des chaines, des fichiers ou
+        des dossiers.
     </para>
 
-    <itemizedlist>
-        <listitem>
-            <para>
-                <emphasis>Bz2</emphasis>
-            </para>
-        </listitem>
+    <sect3 id="zend.filter.set.compress.options">
+        <title>Options supportées par Zend_Filter_Compress et Zend_Filter_Decompress</title>
 
-        <listitem>
-            <para>
-                <emphasis>Gz</emphasis>
-            </para>
-        </listitem>
+        <para>
+            Les options suivantes sont supportées par
+            <classname>Zend_Filter_Compress</classname> et
+            <classname>Zend_Filter_Decompress</classname>&#160;:
+        </para>
 
-        <listitem>
-            <para>
-                <emphasis>Lzf</emphasis>
-            </para>
-        </listitem>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>adapter</property></emphasis>&#160;: l'adaptateur de
+                    compression qui doit être utrilisé. Vaut par défaut <property>Gz</property>.
+                </para>
+            </listitem>
 
-        <listitem>
-            <para>
-                <emphasis>Rar</emphasis>
-            </para>
-        </listitem>
+            <listitem>
+                <para>
+                    <emphasis><property>options</property></emphasis>&#160;: options additionnelles
+                    qui sont fournies à l'initialisation de l'adaptateur. Chaque adaptateur
+                    supporte ses propres options.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
 
-        <listitem>
-            <para>
-                <emphasis>Tar</emphasis>
-            </para>
-        </listitem>
+    <sect3 id="zend.filter.set.compress.basic">
+        <title>Adaptateurs de compression supportés</title>
 
-        <listitem>
-            <para>
-                <emphasis>Zip</emphasis>
-            </para>
-        </listitem>
-    </itemizedlist>
+        <para>
+            Les formats de compression suivants sont supportés par leurs adaptateurs
+            respectifs&#160;:
+        </para>
 
-    <para>
-        Chaque format de compression possède des caractéristiques propres et ils s'utilisent
-        tous d'une manière commune. Seules leurs options vont différer ainsi que les types
-        de compressions qu'ils offrent (algorithmes, fichiers, chaines et dossiers)
-    </para>
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Bz2</emphasis>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Gz</emphasis>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Lzf</emphasis>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Rar</emphasis>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Tar</emphasis>
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Zip</emphasis>
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Chaque format de compression possède des caractéristiques propres et ils s'utilisent
+            tous d'une manière commune. Seules leurs options vont différer ainsi que les types
+            de compressions qu'ils offrent (algorithmes, fichiers, chaines et dossiers)
+        </para>
+    </sect3>
 
     <sect3 id="zend.filter.set.compress.generic">
         <title>Les bases</title>
@@ -618,6 +654,3 @@ $compressed = $filter->filter('filename.zip');
         </para>
     </sect3>
 </sect2>
-<!--
-vim:se ts=4 sw=4 et:
--->