DOCUMENTATION French: sync and clean manual

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

documentation/manual/fr/module_specs/Zend_File_Transfer-Filters.xml

@@ -1,84 +1,118 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 13977 -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15207 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.file.transfer.filters">
     <title>Filtres pour Zend_File_Transfer</title>
 
-    <para><classname>Zend_File_Transfer</classname> est fourni avec de multiples filtres qui peuvent être utilisés pour réaliser
-    différentes tâches qui doivent être réalisées souvent sur les fichier. Notez que tout filtre est appliqué après la
-    validation. De plus les filtres de fichiers se comportent légèrement différemment des autres filtres. Ils
-    retourneront toujours le nom de fichier et non le contenu modifié (ce qui serait une mauvaise idée en travaillant
-    avec un fichier d'1Go par exemple). Tous les filtres fournis avec <classname>Zend_File_Transfer</classname> peuvent être
-    trouvés dans le composant <classname>Zend_Filter</classname> et sont nommés <classname>Zend_Filter_File_*</classname>. Les filtres
-    suivants sont actuellement disponibles :</para>
+    <para>
+        <classname>Zend_File_Transfer</classname> est fourni avec de multiples filtres qui
+        peuvent être utilisés pour réaliser différentes tâches qui doivent être réalisées souvent
+        sur les fichier. Notez que tout filtre est appliqué après la validation. De plus les filtres
+        de fichiers se comportent légèrement différemment des autres filtres. Ils retourneront
+        toujours le nom de fichier et non le contenu modifié (ce qui serait une mauvaise idée en
+        travaillant avec un fichier d'1Go par exemple). Tous les filtres fournis avec
+        <classname>Zend_File_Transfer</classname> peuvent être trouvés dans le composant
+        <classname>Zend_Filter</classname> et sont nommés <classname>Zend_Filter_File_*</classname>.
+        Les filtres suivants sont actuellement disponibles&#160;:
+    </para>
 
     <itemizedlist>
         <listitem>
-            <para><code>Decrypt</code> : ce filtre peut décrypter un fichier.</para>
+            <para><code>Decrypt</code>&#160;: ce filtre peut décrypter un fichier.</para>
         </listitem>
 
         <listitem>
-            <para><code>Encrypt</code> : ce filtre peut crypter un fichier.</para>
+            <para><code>Encrypt</code>&#160;: ce filtre peut crypter un fichier.</para>
         </listitem>
 
         <listitem>
-            <para><code>LowerCase </code>: ce filtre peut mettre en minuscule le contenu d'un fichier texte.</para>
+            <para>
+                <code>LowerCase </code>&#160;: ce filtre peut mettre en minuscule le contenu d'un
+                fichier texte.
+            </para>
         </listitem>
 
         <listitem>
-            <para><code>Rename</code> : ce filtre peut renommer les fichiers, changer leur localisation et même forcer
-            l'écrasement de fichiers existants.</para>
+            <para>
+                <code>Rename</code>&#160;: ce filtre peut renommer les fichiers, changer leur
+                localisation et même forcer l'écrasement de fichiers existants.
+            </para>
         </listitem>
 
         <listitem>
-            <para><code>UpperCase </code>: ce filtre peut mettre en majuscule le contenu d'un fichier texte.</para>
+            <para>
+                <code>UpperCase </code>&#160;: ce filtre peut mettre en majuscule le contenu d'un
+                fichier texte.
+            </para>
         </listitem>
     </itemizedlist>
 
     <sect2 id="zend.file.transfer.filters.usage">
-        <title>Utiliser les filtres avec <classname>Zend_File_Transfer</classname></title>
+        <title>Utiliser les filtres avec Zend_File_Transfer</title>
 
-        <para>L'utilisation des filtres est assez simple. Il existe de multiples méthodes pour ajouter et manipuler les
-        filtres.</para>
+        <para>
+            L'utilisation des filtres est assez simple. Il existe de multiples méthodes pour
+            ajouter et manipuler les filtres.
+        </para>
 
         <itemizedlist>
             <listitem>
-                <para><code>addFilter($filter, $options = null, $files = null)</code> : ajoute le filtre à la pile des
-                filtres (optionnellement seul le(s) fichier(s) spécifié(s)). <code>$filter</code> peut être soit une
-                instance d'un filtre réel, ou un nom court spécifiant le filtre (par exemple, "Rename").</para>
+                <para>
+                    <code>addFilter($filter, $options = null, $files = null)</code>&#160;: ajoute
+                    le filtre à la pile des filtres (optionnellement seul le(s) fichier(s)
+                    spécifié(s)). <code>$filter</code> peut être soit une instance d'un filtre réel,
+                    ou un nom court spécifiant le filtre (par exemple, "Rename").
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>addFilters(array $filters, $files = null)</code> : ajoute les filtres à la pile des filtres.
-                Chaque entrée peut être soit une paire type/options, ou un tableau avec la clé "filtre" spécifiant le
-                filtre (tous les autres options seront considérées comme des options du filtre au moment de
-                l'instanciation).</para>
+                <para>
+                    <code>addFilters(array $filters, $files = null)</code>&#160;: ajoute les
+                    filtres à la pile des filtres. Chaque entrée peut être soit une paire
+                    type/options, ou un tableau avec la clé "filtre" spécifiant le filtre (tous les
+                    autres options seront considérées comme des options du filtre au moment de
+                    l'instanciation).
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>setFilters(array $filters, $files = null)</code> : surcharge les filtres existants avec les
-                filtres spécifiés. Les filtres doivent respecter la même syntaxe <code>addFilters()</code>.</para>
+                <para>
+                    <code>setFilters(array $filters, $files = null)</code>&#160;: surcharge les
+                    filtres existants avec les filtres spécifiés. Les filtres doivent respecter la
+                    même syntaxe <code>addFilters()</code>.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>hasFilter($name)</code> : indique si le filtre est enregistré.</para>
+                <para>
+                    <code>hasFilter($name)</code>&#160;: indique si le filtre est enregistré.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getFilter($name)</code> : retourne un filtre préalablement enregistré.</para>
+                <para>
+                    <code>getFilter($name)</code>&#160;: retourne un filtre préalablement
+                    enregistré.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getFilters($files = null)</code>: retourne les filtres enregistrés ; si <code>$files</code>
-                est fourni, retourne les filtres pour ce fichier en particulier ou pour tous les fichiers.</para>
+                <para>
+                    <code>getFilters($files = null)</code>&#160;: retourne les filtres
+                    enregistrés&#160;; si <code>$files</code> est fourni, retourne les filtres pour
+                    ce fichier en particulier ou pour tous les fichiers.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>removeFilter($name)</code>: enlève le filtre préalablement enregistré.</para>
+                <para>
+                    <code>removeFilter($name)</code>&#160;: enlève le filtre préalablement
+                    enregistré.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>clearFilters()</code>: efface tous les filtres.</para>
+                <para><code>clearFilters()</code>&#160;: efface tous les filtres.</para>
             </listitem>
         </itemizedlist>
 
@@ -100,9 +134,12 @@ $upload->addFilter('Rename', array('target' => 'C:\picture\uploads', 'overwrite'
         <example id="zend.file.transfer.filters.usage.exampletwo">
             <title>Limiter les filtres à des fichiers uniques</title>
 
-            <para><code>addFilter()</code>, <code>addFilters()</code>, and <code>setFilters()</code> accepte chacun un
-            argument final <code>$files</code>. Cet argument peut être utilisé pour spécifier un fichier en particulier
-            ou un tableau de fichiers sur lequel appliqué le filtre donné.</para>
+            <para>
+                <code>addFilter()</code>, <code>addFilters()</code>, and
+                <code>setFilters()</code> accepte chacun un argument final <code>$files</code>. Cet
+                argument peut être utilisé pour spécifier un fichier en particulier ou un tableau de
+                fichiers sur lequel appliqué le filtre donné.
+            </para>
 
             <programlisting role="php"><![CDATA[
 $upload = new Zend_File_Transfer();
@@ -113,15 +150,20 @@ $upload->addFilter('Rename', 'C:\image\uploads', 'file2');
 ]]></programlisting>
         </example>
 
-        <para>Généralement vous devriez simplement utiliser la méthode <code>addFilters()</code>, qui peut être appelée
-        plusieurs fois.</para>
+        <para>
+            Généralement vous devriez simplement utiliser la méthode
+            <code>addFilters()</code>, qui peut être appelée plusieurs fois.
+        </para>
 
         <example id="zend.file.transfer.filters.usage.examplemultiple">
             <title>Ajouter des filtres multiples</title>
 
-            <para>Souvent il est plus simple d'appeler plusieurs fois <code>addFilter()</code> : un appel pour chaque
-            filtre. Ceci améliore aussi la lisibilité et rend votre code plus maintenable. Comme toutes les méthodes
-            fournissent un interface fluide, vous pouvez enchaîner les appels comme montré ci-dessous :</para>
+            <para>
+                Souvent il est plus simple d'appeler plusieurs fois <code>addFilter()</code> :
+                un appel pour chaque filtre. Ceci améliore aussi la lisibilité et rend votre code
+                plus maintenable. Comme toutes les méthodes fournissent un interface fluide, vous
+                pouvez enchaîner les appels comme montré ci-dessous :
+            </para>
 
             <programlisting role="php"><![CDATA[
 $upload = new Zend_File_Transfer();
@@ -133,24 +175,33 @@ $upload->addFilter('Rename', 'file1', 'C:\picture\newjpg')
         </example>
 
         <note>
-            <para>Notez que même si l'ajout du même filtre plusieurs fois est autorisé, faire ceci peut entraîner des
-            problèmes si vous utilisez différentes options pour le même filtre.</para>
+            <para>
+                Notez que même si l'ajout du même filtre plusieurs fois est autorisé, faire
+                ceci peut entraîner des problèmes si vous utilisez différentes options pour le même
+                filtre.
+            </para>
         </note>
     </sect2>
 
     <sect2 id="zend.file.transfer.filters.decrypt">
-        <title>Filtre <emphasis>Decrypt</emphasis></title>
+        <title>Filtre Decrypt</title>
 
         <para>Le filtre <code>Decrypt</code> permet de décrypter un fichier crypté.</para>
 
-        <para>Ce filtre se sert de <classname>Zend_Filter_Decrypt</classname>. Il supporte les extensions PHP <code>Mcrypt</code>
-        et <code>OpenSSL</code>. Reportez vous à la section associée pour voir les détails des possibilités d'options
-        pour le décryptage et connaître les options supportées.</para>
-
-        <para>Ce filtre supporte une option additionnelle qui peut être utilisée pour sauvegarder le fichier décrypté
-        avec un autre nom de fichier. Spécifiez l'option <code>filename</code> pour changer le nom de fichier dans
-        lequel le fichier décrypté sera stocké. Si vous supprimez cette option le fichier décrypté écrasera le fichier
-        chiffré original.</para>
+        <para>
+            Ce filtre se sert de <classname>Zend_Filter_Decrypt</classname>. Il supporte les
+            extensions PHP <code>Mcrypt</code> et <code>OpenSSL</code>. Reportez vous à la section
+            associée pour voir les détails des possibilités d'options pour le décryptage et
+            connaître les options supportées.
+        </para>
+
+        <para>
+            Ce filtre supporte une option additionnelle qui peut être utilisée pour
+            sauvegarder le fichier décrypté avec un autre nom de fichier. Spécifiez l'option
+            <code>filename</code> pour changer le nom de fichier dans lequel le fichier décrypté
+            sera stocké. Si vous supprimez cette option le fichier décrypté écrasera le fichier
+            chiffré original.
+        </para>
 
         <example id="zend.file.transfer.filters.decrypt.example1">
             <title>Utiliser le filtre Decrypt avec Mcrypt</title>
@@ -182,18 +233,24 @@ $upload->addFilter('Decrypt',
     </sect2>
 
     <sect2 id="zend.file.transfer.filters.encrypt">
-        <title>Filtre <emphasis>Encrypt</emphasis></title>
+        <title>Filtre Encrypt</title>
 
         <para>Le filtre <code>Encrypt</code> permet de crypter un fichier.</para>
 
-        <para>Ce filtre se sert de <classname>Zend_Filter_Encrypt</classname>. Il supporte les extensions PHP <code>Mcrypt</code>
-        et <code>OpenSSL</code>. Reportez vous à la section associée pour voir les détails des possibilités d'options
-        pour le chiffrement et connaître les options supportées.</para>
-
-        <para>Ce filtre supporte une option additionnelle qui peut être utilisée pour sauvegarder le fichier chiffré
-        avec un autre nom de fichier. Spécifiez l'option <code>filename</code> pour changer le nom de fichier dans
-        lequel le fichier chiffré sera stocké. Si vous supprimez cette option le fichier chiffré écrasera le fichier
-        original.</para>
+        <para>
+            Ce filtre se sert de <classname>Zend_Filter_Encrypt</classname>. Il supporte les
+            extensions PHP <code>Mcrypt</code> et <code>OpenSSL</code>. Reportez vous à la section
+            associée pour voir les détails des possibilités d'options pour le chiffrement et
+            connaître les options supportées.
+        </para>
+
+        <para>
+            Ce filtre supporte une option additionnelle qui peut être utilisée pour
+            sauvegarder le fichier chiffré avec un autre nom de fichier. Spécifiez l'option
+            <code>filename</code> pour changer le nom de fichier dans lequel le fichier chiffré sera
+            stocké. Si vous supprimez cette option le fichier chiffré écrasera le fichier
+            original.
+        </para>
 
         <example id="zend.file.transfer.filters.encrypt.example1">
             <title>Utiliser le filtre Encrypt avec Mcrypt</title>
@@ -224,13 +281,18 @@ $upload->addFilter('Encrypt',
     </sect2>
 
     <sect2 id="zend.file.transfer.filters.lowercase">
-        <title>Filtre <emphasis>LowerCase</emphasis></title>
+        <title>Filtre LowerCase</title>
 
-        <para>Le filtre <code>LowerCase</code> vous permet de mettre en minuscule le contenu d'un fichier. Vous devriez
-        utiliser ce filtre seulement sur les fichiers texte.</para>
+        <para>
+            Le filtre <code>LowerCase</code> vous permet de mettre en minuscule le contenu
+            d'un fichier. Vous devriez utiliser ce filtre seulement sur les fichiers texte.
+        </para>
 
-        <para>Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant qu'encodage. Ou vous pouvez
-        utiliser la méthode <code>setEncoding()</code> pour le paramétrer plus tard.</para>
+        <para>
+            Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant
+            qu'encodage. Ou vous pouvez utiliser la méthode <code>setEncoding()</code> pour le
+            paramétrer plus tard.
+        </para>
 
         <example id="zend.file.transfer.filters.lowercase.example">
             <title>Utiliser le filtre LowerCase</title>
@@ -251,20 +313,29 @@ $upload->addFilter('LowerCase', 'ISO-8859-1');
         </example>
 
         <note>
-            <para>Notez que les options du filtre LowerCase sont optionnelles, vous devez fournir un <code>null</code>
-            en second paramètre quand vous souhaitez limiter le filtre à un fichier unique.</para>
+            <para>
+                Notez que les options du filtre LowerCase sont optionnelles, vous devez
+                fournir un <code>null</code> en second paramètre quand vous souhaitez limiter le
+                filtre à un fichier unique.
+            </para>
         </note>
     </sect2>
 
     <sect2 id="zend.file.transfer.filters.rename">
-        <title>Filtre <emphasis>Rename</emphasis></title>
+        <title>Filtre Rename</title>
 
-        <para>Le filtre <code>Rename</code> vous permet de changer le dossier de destination du fichier uploadé, de
-        changer le nom de fichier et aussi d'écraser des fichiers existants. Il supporte les options suivantes :</para>
+        <para>
+            Le filtre <code>Rename</code> vous permet de changer le dossier de destination du
+            fichier uploadé, de changer le nom de fichier et aussi d'écraser des fichiers existants.
+            Il supporte les options suivantes :
+        </para>
 
         <itemizedlist>
             <listitem>
-                <para><code>source</code> : le nom et le dossier de l'ancien fichier qui doit être renommé.</para>
+                <para>
+                    <code>source</code> : le nom et le dossier de l'ancien fichier qui doit
+                    être renommé.
+                </para>
             </listitem>
 
             <listitem>
@@ -272,16 +343,21 @@ $upload->addFilter('LowerCase', 'ISO-8859-1');
             </listitem>
 
             <listitem>
-                <para><code>overwrite</code> : paramètre si l'ancien fichier écrase le nouveau fichier s'il existe déjà.
-                La valeur par défaut est <code>false</code>.</para>
+                <para>
+                    <code>overwrite</code> : paramètre si l'ancien fichier écrase le nouveau
+                    fichier s'il existe déjà. La valeur par défaut est <code>false</code>.
+                </para>
             </listitem>
         </itemizedlist>
 
-        <para>De plus vous pouvez utiliser la méthode <code>setFile()</code> pour paramétrer des fichiers, ce qui
-        effacera ceux précédemment paramétrés, <code>addFile()</code> pour ajouter un nouveau fichier à ceux déjà
-        présent, et <code>getFile()</code> pour récupérer les fichiers actuellement paramétrés. Pour simplifier les
-        choses, ce filtre accepte de multiples notations et ces méthodes et constructeur comprennent les mêmes
-        notations.</para>
+        <para>
+            De plus vous pouvez utiliser la méthode <code>setFile()</code> pour paramétrer des
+            fichiers, ce qui effacera ceux précédemment paramétrés, <code>addFile()</code> pour
+            ajouter un nouveau fichier à ceux déjà présent, et <code>getFile()</code> pour récupérer
+            les fichiers actuellement paramétrés. Pour simplifier les choses, ce filtre accepte de
+            multiples notations et ces méthodes et constructeur comprennent les mêmes
+            notations.
+        </para>
 
         <example id="zend.file.transfer.filters.rename.example">
             <title>Utiliser le filtre Rename</title>
@@ -297,9 +373,12 @@ $upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');
 ]]></programlisting>
         </example>
 
-        <para>Vous pouvez utiliser différentes notations. Ci-dessous vous trouverez une table fournissant la description
-        et le but des notations supportées. Notez que quand vous utilisez l'"Adapter" ou le "Form Element", vous ne
-        pourrez pas utiliser toutes les notations décrites.</para>
+        <para>
+            Vous pouvez utiliser différentes notations. Ci-dessous vous trouverez une table
+            fournissant la description et le but des notations supportées. Notez que quand vous
+            utilisez l'"Adapter" ou le "Form Element", vous ne pourrez pas utiliser toutes les
+            notations décrites.
+        </para>
 
         <table id="zend.file.transfer.filters.rename.notations">
             <title>Notations différentes du filtre "Rename" et leurs significations</title>
@@ -308,7 +387,6 @@ $upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');
                 <thead>
                     <row>
                         <entry>notation</entry>
-
                         <entry>description</entry>
                     </row>
                 </thead>
@@ -316,42 +394,42 @@ $upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');
                 <tbody>
                     <row>
                         <entry>addFile('C:\uploads')</entry>
-
-                        <entry>Spécifie un nouveau dossier pour tous les fichiers quand la chaîne est un dossier. Notez
-                        que vous aurez une exception si le fichier existe déjà, voir le paramètre d'écrasement.</entry>
+                        <entry>Spécifie un nouveau dossier pour tous les fichiers quand la
+                        chaîne est un dossier. Notez que vous aurez une exception si le fichier
+                        existe déjà, voir le paramètre d'écrasement.</entry>
                     </row>
 
                     <row>
                         <entry>addFile('C:\uploads\file.ext')</entry>
-
-                        <entry>Spécifie un nouveau dossier et un nom de fichier pour tous les fichiers quand la chaîne
-                        n'est pas un dossier. Notez que vous aurez une exception si le fichier existe déjà, voir le
-                        paramètre d'écrasement.</entry>
+                        <entry>Spécifie un nouveau dossier et un nom de fichier pour tous les
+                        fichiers quand la chaîne n'est pas un dossier. Notez que vous aurez une
+                        exception si le fichier existe déjà, voir le paramètre
+                        d'écrasement.</entry>
                     </row>
 
                     <row>
                         <entry>addFile('C:\uploads\file.ext', 'overwrite' =&gt; true)</entry>
-
-                        <entry>Spécifie un nouveau dossier et un nom de fichier pour tous les fichiers quand la chaîne
-                        n'est pas un dossier et écrase le fichier existant si celui-ci existe. Notez que vous aurez pas
-                        de notification en cas d'écrasement.</entry>
+                        <entry>Spécifie un nouveau dossier et un nom de fichier pour tous les
+                        fichiers quand la chaîne n'est pas un dossier et écrase le fichier
+                        existant si celui-ci existe. Notez que vous aurez pas de notification en
+                        cas d'écrasement.</entry>
                     </row>
 
                     <row>
-                        <entry>addFile(array('source' =&gt; 'C:\temp\uploads', 'target' =&gt; 'C:\uploads'))</entry>
-
-                        <entry>Spécifie un nouveau dossier pour tous les fichiers qui sont présent dans l'ancien dossier
-                        quand la chaîne est un dossier. Notez que vous aurez une exception si le fichier existe déjà,
-                        voir le paramètre d'écrasement.</entry>
+                        <entry>addFile(array('source' =&gt; 'C:\temp\uploads', 'target' =&gt;
+                        'C:\uploads'))</entry>
+                        <entry>Spécifie un nouveau dossier pour tous les fichiers qui sont
+                        présent dans l'ancien dossier quand la chaîne est un dossier. Notez que
+                        vous aurez une exception si le fichier existe déjà, voir le paramètre
+                        d'écrasement.</entry>
                     </row>
 
                     <row>
-                        <entry>addFile(array('source' =&gt; 'C:\temp\uploads', 'target' =&gt; 'C:\uploads', 'overwrite'
-                        =&gt; true))</entry>
-
-                        <entry>Spécifie un nouveau dossier pour tous les fichiers qui sont présent dans l'ancien dossier
-                        quand la chaîne est un dossier. Notez que vous aurez pas de notification en cas
-                        d'écrasement.</entry>
+                        <entry>addFile(array('source' =&gt; 'C:\temp\uploads', 'target' =&gt;
+                        'C:\uploads', 'overwrite' =&gt; true))</entry>
+                        <entry>Spécifie un nouveau dossier pour tous les fichiers qui sont
+                        présent dans l'ancien dossier quand la chaîne est un dossier. Notez que
+                        vous aurez pas de notification en cas d'écrasement.</entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -359,13 +437,18 @@ $upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');
     </sect2>
 
     <sect2 id="zend.file.transfer.filters.uppercase">
-        <title>Filtre <emphasis>UpperCase</emphasis></title>
+        <title>Filtre UpperCase</title>
 
-        <para>Le filtre <code>UpperCase</code> vous permet de mettre en minuscule le contenu d'un fichier. Vous devriez
-        utiliser ce filtre seulement sur les fichiers texte.</para>
+        <para>
+            Le filtre <code>UpperCase</code> vous permet de mettre en minuscule le contenu
+            d'un fichier. Vous devriez utiliser ce filtre seulement sur les fichiers texte.
+        </para>
 
-        <para>Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant qu'encodage. Ou vous pouvez
-        utiliser la méthode <code>setEncoding()</code> pour le paramétrer plus tard.</para>
+        <para>
+            Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant
+            qu'encodage. Ou vous pouvez utiliser la méthode <code>setEncoding()</code> pour le
+            paramétrer plus tard.
+        </para>
 
         <example id="zend.file.transfer.filters.uppercase.example">
             <title>Utiliser le filtre UpperCase</title>
@@ -386,8 +469,11 @@ $upload->addFilter('UpperCase', 'ISO-8859-1');
         </example>
 
         <note>
-            <para>Notez que les options du filtre UpperCase sont optionnelles, vous devez fournir un <code>null</code>
-            en second paramètre quand vous souhaitez limiter le filtre à un fichier unique.</para>
+            <para>
+                Notez que les options du filtre UpperCase sont optionnelles, vous devez
+                fournir un <code>null</code> en second paramètre quand vous souhaitez limiter le
+                filtre à un fichier unique.
+            </para>
         </note>
     </sect2>
 </sect1>

documentation/manual/fr/module_specs/Zend_File_Transfer-Migration.xml

@@ -1,12 +1,15 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 12789 -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15207 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.file.transfer.migration">
     <title>Migrer à partir des versions précédentes</title>
 
-    <para>L'API de <classname>Zend_File_Transfer</classname> a changé au cours du temps. Si vous avez commencé à utiliser
-    <classname>Zend_File_Transfer</classname> et ses sous-composants avec les versions précédentes, suivez les lignes directrices
-    ci-dessous pour migrer vos scripts et ainsi utiliser la nouvelle API.</para>
+    <para>
+        L'API de <classname>Zend_File_Transfer</classname> a changé au cours du temps. Si vous
+        avez commencé à utiliser <classname>Zend_File_Transfer</classname> et ses sous-composants
+        avec les versions précédentes, suivez les lignes directrices ci-dessous pour migrer vos
+        scripts et ainsi utiliser la nouvelle API.
+    </para>
 
     <sect2 id="zend.file.transfer.migration.fromonesixtooneseven">
         <title>Migrer de la version 1.6 vers 1.7 ou plus récent</title>
@@ -14,30 +17,46 @@
         <sect3 id="zend.file.transfer.migration.fromonesixtooneseven.validators">
             <title>Changements quand vous utilisez des filtres ou des validateurs</title>
 
-            <para>Certaines remarques des utilisateurs indiquaient que les validateurs de
-            <classname>Zend_File_Transfer</classname> ne fonctionnaient pas correctement avec <classname>Zend_Config</classname> dû au fait
-            qu'ils n'utilisait pas de tableaux nommés.</para>
-
-            <para>De plus, tous les filtres et validateurs de <classname>Zend_File_Transfer</classname> ont été réécrits. Même si
-            les anciennes signatures continuent à fonctionner, elles ont été marqués comme dépréciées et émettent une
-            notice PHP vous informant de faire le changement.</para>
-
-            <para>La liste suivante vous montre les changements à réaliser pour une utilisation appropriée des
-            paramètres.</para>
+            <para>
+                Certaines remarques des utilisateurs indiquaient que les validateurs de
+                <classname>Zend_File_Transfer</classname> ne fonctionnaient pas correctement avec
+                <classname>Zend_Config</classname> dû au fait qu'ils n'utilisait pas de tableaux
+                nommés.
+            </para>
+
+            <para>
+                De plus, tous les filtres et validateurs de
+                <classname>Zend_File_Transfer</classname> ont été réécrits. Même si les anciennes
+                signatures continuent à fonctionner, elles ont été marqués comme dépréciées et
+                émettent une notice PHP vous informant de faire le changement.
+            </para>
+
+            <para>
+                La liste suivante vous montre les changements à réaliser pour une utilisation
+                appropriée des paramètres.
+            </para>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.rename">
-                <title>Filtre <emphasis>Rename</emphasis></title>
+                <title>Filtre Rename</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Filter_File_Rename($oldfile,
+                            $newfile, $overwrite)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Filter_File_Rename($options)</classname> où <code>$options</code>
-                        accepte un tableau avec les clés suivantes : <emphasis>source</emphasis> est équivalent à
-                        <code>$oldfile</code>, <emphasis>target</emphasis> est équivalent à <code>$newfile</code>,
-                        <emphasis>overwrite</emphasis> est équivalent à <code>$overwrite.</code></para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Filter_File_Rename($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes :
+                            <emphasis>source</emphasis> est équivalent à <code>$oldfile</code>,
+                            <emphasis>target</emphasis> est équivalent à <code>$newfile</code>,
+                            <emphasis>overwrite</emphasis> est équivalent à
+                            <code>$overwrite.</code>
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -61,17 +80,24 @@ $upload->addFilter('Rename',
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.count">
-                <title>Validateur <emphasis>Count</emphasis></title>
+                <title>Validateur Count</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_Count($min, $max)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_Count($min,
+                            $max)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_Count($options)</classname> où <code>$options</code>
-                        accepte un tableau avec les clés suivantes : <emphasis>min</emphasis> est équivalent à
-                        <code>$min</code>, <emphasis>max</emphasis> est équivalent à <code>$max</code>.</para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_Count($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes :
+                            <emphasis>min</emphasis> est équivalent à <code>$min</code>,
+                            <emphasis>max</emphasis> est équivalent à <code>$max</code>.
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -95,18 +121,25 @@ $upload->addValidator('Count',
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.extension">
-                <title>Validateur <emphasis>Extension</emphasis></title>
+                <title>Validateur Extension</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_Extension($extension, $case)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_Extension($extension,
+                            $case)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_Extension($options)</classname> où
-                        <code>$options</code> accepte un tableau avec les clés suivantes : <emphasis>*</emphasis> est
-                        équivalent à <code>$extension</code> et peut avoir tout autre clé, <emphasis>case</emphasis> est
-                        équivalent à <code>$case</code>.</para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_Extension($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes :
+                            <emphasis>*</emphasis> est équivalent à <code>$extension</code> et peut
+                            avoir tout autre clé, <emphasis>case</emphasis> est équivalent à
+                            <code>$case</code>.
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -130,25 +163,36 @@ $upload->addValidator('Extension',
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.filessize">
-                <title>Validateur <emphasis>FilesSize</emphasis></title>
+                <title>Validateur FilesSize</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_FilesSize($min, $max, $bytestring)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_FilesSize($min, $max,
+                            $bytestring)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_FilesSize($options)</classname> où
-                        <code>$options</code> accepte un tableau avec les clés suivantes : <emphasis>min</emphasis> est
-                        équivalent à <code>$min</code>, <emphasis>max</emphasis> est équivalent à <code>$max</code>,
-                        <emphasis>bytestring</emphasis> est équivalent à <code>$bytestring</code>.</para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_FilesSize($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes :
+                            <emphasis>min</emphasis> est équivalent à <code>$min</code>,
+                            <emphasis>max</emphasis> est équivalent à <code>$max</code>,
+                            <emphasis>bytestring</emphasis> est équivalent à
+                            <code>$bytestring</code>.
+                        </para>
                     </listitem>
                 </itemizedlist>
 
-                <para>De plus la signature de la méthode <code>useByteString()</code> a changé. Elle peut être seulement
-                utilisée pour tester si le validateur prévoie d'utiliser les chaînes lisibles ou la valeur brute dans
-                les messages générées. Pour paramétrer la valeur de cette option, utilisez la méthode
-                <code>setUseByteString()</code>.</para>
+                <para>
+                    De plus la signature de la méthode <code>useByteString()</code> a changé.
+                    Elle peut être seulement utilisée pour tester si le validateur prévoie
+                    d'utiliser les chaînes lisibles ou la valeur brute dans les messages générées.
+                    Pour paramétrer la valeur de cette option, utilisez la méthode
+                    <code>setUseByteString()</code>.
+                </para>
 
                 <example id="zend.file.transfer.migration.fromonesixonetooneseven.validators.filessize.example">
                     <title>Changer le validateur filessize entre 1.6 et 1.7</title>
@@ -177,18 +221,25 @@ $upload->setUseByteSting(true); // set flag
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.hash">
-                <title>Validateur <emphasis>Hash</emphasis></title>
+                <title>Validateur Hash</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_Hash($hash, $algorithm)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_Hash($hash,
+                            $algorithm)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_Hash($options)</classname> où <code>$options</code>
-                        accepte un tableau avec les clés suivantes : <emphasis>*</emphasis> est équivalent à
-                        <code>$hash</code> et peut avoir tout autre clé, <emphasis>algorithm</emphasis> est équivalent à
-                        <code>$algorithm</code>.</para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_Hash($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes :
+                            <emphasis>*</emphasis> est équivalent à <code>$hash</code> et peut avoir
+                            tout autre clé, <emphasis>algorithm</emphasis> est équivalent à
+                            <code>$algorithm</code>.
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -212,20 +263,27 @@ $upload->addValidator('Hash',
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.imagesize">
-                <title>Validateur <emphasis>ImageSize</emphasis></title>
+                <title>Validateur ImageSize</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth,
-                        $maxheight)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_ImageSize($minwidth,
+                            $minheight, $maxwidth, $maxheight)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_FilesSize($options)</classname> où
-                        <code>$options</code> accepte un tableau avec les clés suivantes : <emphasis>minwidth</emphasis>
-                        est équivalent à <code>$minwidth</code>, <emphasis>maxwidth</emphasis> est équivalent à
-                        <code>$maxwidth</code>, <emphasis>minheight</emphasis> est équivalent à <code>$minheight</code>,
-                        <emphasis>maxheight</emphasis> est équivalent à <code>$maxheight</code>.</para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_FilesSize($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes&#160;:
+                            <emphasis>minwidth</emphasis> est équivalent à <code>$minwidth</code>,
+                            <emphasis>maxwidth</emphasis> est équivalent à <code>$maxwidth</code>,
+                            <emphasis>minheight</emphasis> est équivalent à <code>$minheight</code>,
+                            <emphasis>maxheight</emphasis> est équivalent à
+                            <code>$maxheight</code>.
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -251,18 +309,26 @@ $upload->addValidator('ImageSize',
             </sect4>
 
             <sect4 id="zend.file.transfer.migration.fromonesixtooneseven.validators.size">
-                <title>Validateur <emphasis>Size</emphasis></title>
+                <title>Validateur Size</title>
 
                 <itemizedlist>
                     <listitem>
-                        <para>Ancienne API : <classname>Zend_Validate_File_Size($min, $max, $bytestring)</classname></para>
+                        <para>
+                            Ancienne API&#160;: <classname>Zend_Validate_File_Size($min, $max,
+                            $bytestring)</classname>
+                        </para>
                     </listitem>
 
                     <listitem>
-                        <para>Nouvelle API : <classname>Zend_Validate_File_Size($options)</classname> où <code>$options</code>
-                        accepte un tableau avec les clés suivantes : <emphasis>min</emphasis> est équivalent à
-                        <code>$min</code>, <emphasis>max</emphasis> est équivalent à <code>$max</code>,
-                        <emphasis>bytestring</emphasis> est équivalent à <code>$bytestring</code></para>
+                        <para>
+                            Nouvelle API&#160;:
+                            <classname>Zend_Validate_File_Size($options)</classname> où
+                            <code>$options</code> accepte un tableau avec les clés suivantes&#160;:
+                            <emphasis>min</emphasis> est équivalent à <code>$min</code>,
+                            <emphasis>max</emphasis> est équivalent à <code>$max</code>,
+                            <emphasis>bytestring</emphasis> est équivalent à
+                            <code>$bytestring</code>
+                        </para>
                     </listitem>
                 </itemizedlist>
 
@@ -294,28 +360,40 @@ $upload->addValidator('Size',
         <sect3 id="zend.file.transfer.migration.fromonesixonetoonesixtwo.validators">
             <title>Changements quand vous utilisez des validateurs</title>
 
-            <para>Certaines remarques des utilisateurs indiquaient que les validateurs de
-            <classname>Zend_File_Transfer</classname> ne fonctionnaient pas comme ceux par défaut fournis avec
-            <classname>Zend_Form</classname>. <classname>Zend_Form</classname> permet par exemple l'utilisation du paramètre
-            <code>breakChainOnFailure</code> qui stoppe la validation de tous les validateurs suivants dès qu'une erreur
-            de validation apparaît.</para>
+            <para>
+                Certaines remarques des utilisateurs indiquaient que les validateurs de
+                <classname>Zend_File_Transfer</classname> ne fonctionnaient pas comme ceux par
+                défaut fournis avec <classname>Zend_Form</classname>.
+                <classname>Zend_Form</classname> permet par exemple l'utilisation du paramètre
+                <code>breakChainOnFailure</code> qui stoppe la validation de tous les validateurs
+                suivants dès qu'une erreur de validation apparaît.
+            </para>
 
-            <para>Nous avons donc ajouter ce paramètre à tous les validateurs existants pour
-            <classname>Zend_File_Transfer</classname>.</para>
+            <para>
+                Nous avons donc ajouter ce paramètre à tous les validateurs existants pour
+                <classname>Zend_File_Transfer</classname>.
+            </para>
 
             <itemizedlist>
                 <listitem>
-                    <para>Ancienne API : <code>addValidator($validator, $options, $files)</code>.</para>
+                    <para>
+                        Ancienne API&#160;: <code>addValidator($validator, $options,
+                        $files)</code>.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para>Nouvelle API : <code>addValidator($validator, $breakChainOnFailure, $options,
-                    $files)</code>.</para>
+                    <para>
+                        Nouvelle API&#160;: <code>addValidator($validator, $breakChainOnFailure,
+                        $options, $files)</code>.
+                    </para>
                 </listitem>
             </itemizedlist>
 
-            <para>Pour migrer vos scripts vers la nouvelle API, ajoutez simplement un a <code>false</code> après voir
-            défini le validateur souhaité.</para>
+            <para>
+                Pour migrer vos scripts vers la nouvelle API, ajoutez simplement un a
+                <code>false</code> après voir défini le validateur souhaité.
+            </para>
 
             <example id="zend.file.transfer.migration.fromonesixonetoonesixtwo.example">
                 <title>Changer les validateurs de fichiers de 1.6.1 vers 1.6.2</title>