sync with en rev

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

@@ -1,29 +1,34 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
-<!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
+<!-- EN-Revision: 198702020219835de11dc3064b7dc0590361ecab Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
 <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>Faz a diferença binária de duas strings usando o algoritmo de impressão digital polinomial de Rabin</refpurpose>
+  <refpurpose>
+   Gera a diferença binária de duas strings usando o algoritmo de impressão digital polinomial de Rabin
+  </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>
-   Cria uma comparação binária de duas strings e retorna o resultado.
-   A diferença entre esta função e <function>xdiff_string_bdiff</function> é o algoritmo
-   diferente utilizado, que deve resultar em uma execução mais rápida e em uma comparação menor.
-   Esta função funciona tanto com texto quanto com dados binários. O patch resultante
-   pode ser aplicado posteriormente usando <function>xdiff_string_bpatch</function>/<function>xdiff_file_bpatch</function>.
+   Cria uma comparação binária de duas strings usando o algoritmo de impressão digital polinomial de Rabin implementado pela
+   <link xlink:href="&url.xdiff;">libxdiff</link>. Comparada à
+   <function>xdiff_string_bdiff</function>, este algoritmo geralmente produz diferenças menores, é mais rápido
+   e mantém compatibilidade totol com <function>xdiff_string_bpatch</function> e
+   <function>xdiff_file_bpatch</function> para aplicação das diferenças.
   </para>
   <para>
-   Para mais detalhes sobre as diferenças entre os algoritmos utilizados, consulte o site
-   <link xlink:href="&url.xdiff;">libxdiff</link>.
+   Esta função pode ser usada com texto ou com dados binários. Os dados de diferença resultantes podem ser
+   aplicados posteriormente para recriar a nova versão a partir da antiga.
+  </para>
+  <para>
+   Para mais informação sobre o algoritmo, consulte a
+   <link xlink:href="https://www.xmailserver.org/xdiff-lib.html">documentação da libxdiff</link>.
   </para>
  </refsect1>
 
@@ -35,7 +40,7 @@
      <term><parameter>old_data</parameter></term>
      <listitem>
       <para>
-       Primeira sequência com dados binários. Atua como dados "antigos".
+       A primeira string contendo os dados binários "antigos".
       </para>
      </listitem>
     </varlistentry>
@@ -43,7 +48,7 @@
      <term><parameter>new_data</parameter></term>
      <listitem>
       <para>
-       Segunda sequência com dados binários. Atua como dados "novos".
+       A segunda string contendo os "novos" dados binários.
       </para>
      </listitem>
     </varlistentry>
@@ -54,8 +59,27 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna uma string com diferença binária entre os dados "antigos" e "novos"
-   ou &false; se ocorrer um erro interno.
+   Retorna uma string com diferença binária entre os dados antigos e novos,&return.falseforfailure;.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Criação de diferença binária entre duas strings</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>
 
@@ -63,13 +87,14 @@
   &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