xdiff sync with EN (#2287)

Author: devnexen

reference/xdiff/functions/xdiff-string-rabdiff.xml

@@ -1,34 +1,38 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 198702020219835de11dc3064b7dc0590361ecab Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
 
 <refentry xml:id="function.xdiff-string-rabdiff" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>xdiff_string_rabdiff</refname>
-  <refpurpose>Crée un diff binaire de 2 chaînes en utilisant l'algorithme polynomial de Rabin des empreintes digitales</refpurpose>
+  <refpurpose>
+   Crée un diff binaire de 2 chaînes en utilisant l'algorithme polynomial de Rabin des empreintes digitales
+  </refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>xdiff_string_bdiff</methodname>
+   <type>string|false</type><methodname>xdiff_string_rabdiff</methodname>
    <methodparam><type>string</type><parameter>old_data</parameter></methodparam>
    <methodparam><type>string</type><parameter>new_data</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Crée un diff binaire de 2 chaînes et retourne le résultat.
-   La différence entre cette fonction et la fonction
-   <function>xdiff_string_bdiff</function> se situe au niveau de l'algorithme
-   utilisé ; cette fonction devrait être plus rapide et produire un diff plus
-   petit. Cette fonction est utilisable aussi bien sur des données textes que
-   binaires. Le patch résultant pourra être appliqué par la suite grâce aux
-   fonctions <function>xdiff_string_bpatch</function> et
-   <function>xdiff_file_bpatch</function>.
+
+   Crée un diff binaire entre deux chaînes en utilisant l’algorithme d’empreinte polynomial de Rabin implémenté par
+   <link xlink:href="&url.xdiff;">libxdiff</link>. Comparé à
+   <function>xdiff_string_bdiff</function>, cet algorithme génère généralement des diffs plus compacts et fonctionne plus rapidement,
+   tout en restant pleinement compatible avec <function>xdiff_string_bpatch</function> et
+   <function>xdiff_file_bpatch</function> pour l’application des patchs.
+  </para>
+  <para>
+   Cette fonction peut être utilisée avec des données texte ou binaires. Les données de diff produites peuvent ensuite être
+   appliquées afin de recréer la nouvelle version à partir de l’ancienne.
   </para>
   <para>
-   Pour plus de détails concernant la différence d'algorithme, reportez-vous
-   au site web de la bibliothèque <link xlink:href="&url.xdiff;">libxdiff</link>.
+   Pour obtenir davantage d’informations sur l’algorithme, consulter la
+   <link xlink:href="https://www.xmailserver.org/xdiff-lib.html">documentation de libxdiff</link>.
   </para>
  </refsect1>
 
@@ -40,15 +44,15 @@
      <term><parameter>old_data</parameter></term>
      <listitem>
       <para>
-       Première chaîne de données binaires. Ce sont les anciennes données.
+       La première chaîne contenant les données binaires « anciennes ».
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>new_data</parameter></term>
      <listitem>
       <para>
-       Seconde chaîne de données binaires. Ce sont les nouvelles données.
+       La seconde chaîne contenant les données binaires « nouvelles ».
       </para>
      </listitem>
     </varlistentry>
@@ -59,22 +63,42 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retourne un diff binaire contenant les différences entre les anciennes et les
-   nouvelles données, ou &false; si une erreur interne survient.
+   Retourne une chaîne binaire contenant les différences entre les données anciennes et nouvelles,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Création d’un diff binaire entre deux chaînes</title>
+    <programlisting role="php">
+     <![CDATA[
+<?php
+$old = file_get_contents('file_v1.txt');
+$new = file_get_contents('file_v2.txt');
+
+$diff = xdiff_string_rabdiff($old, $new);
+file_put_contents('patch.rdiff', $diff);
+?>
+]]>
+    </programlisting>
+   </example>
   </para>
  </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>xdiff_string_bdiff</function></member>
     <member><function>xdiff_string_bpatch</function></member>
+    <member><function>xdiff_file_bpatch</function></member>
    </simplelist>
   </para>
  </refsect1>
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml