[svnbook-pt-br commit] r275 - trunk/book

codesite-noreply at google.com codesite-noreply at google.com
Sat Nov 22 14:07:43 CST 2008


Author: mfandrade
Date: Sat Nov 22 12:07:14 2008
New Revision: 275

Modified:
    trunk/book/ch07-customizing-svn.xml

Log:
Tradução do arquivo "Customizando sua Experiência com Subversion",
conclusão da seção "Usando Ferramentas Externas de Diferenciação",
subseções "Ferramentas diff Externas" e "Ferramentas diff3 Externas".


Modified: trunk/book/ch07-customizing-svn.xml
==============================================================================
--- trunk/book/ch07-customizing-svn.xml	(original)
+++ trunk/book/ch07-customizing-svn.xml	Sat Nov 22 12:07:14 2008
@@ -968,54 +968,59 @@

      <!-- ===============================================================  
-->
      <sect2 id="svn.advanced.externaldifftools.diff">
-      <title>External diff</title>
+      <title>Ferramentas diff Externas</title>

-      <para>Subversion calls external diff programs with parameters
-        suitable for the GNU diff utility, and expects only that the
-        external program return with a successful error code.  For
-        most alternative diff programs, only the sixth and seventh
-        arguments—the paths of the files which represent the left and
-        right sides of the diff, respectively—are of interest.  Note
-        that Subversion runs the diff program once per modified file
-        covered by the Subversion operation, so if your program runs
-        in an asynchronous fashion (or <quote>backgrounded</quote>),
-        you might have several instances of it all running
-        simultaneously.  Finally, Subversion expects that your program
-        return an error code of 1 if your program detected differences,
-        or 0 if it did not—any other error code is considered a
-        fatal error.
+      <para>O Subversion chama programas de diferenciação externos com
+        os parâmetros que são adequados para o utilitário GNU diff, e
+        espera apenas que o programa externo retorne para o sistema com
+        um código indicando sucesso.  Para a maioria dos programas diff
+        alternativos, apenas o sexto e sétimo argumentos—os
+        caminhos dos arquivos que representam os lados esquerdo e
+        direito do diff, respectivamente—são relevantes.  Note que
+        o Subversion executa o programa diff uma vez para os arquivos
+        modificados abordados por uma operação do Subversion, então se
+        seu programa executa de maneira assíncrona (ou em <quote>segundo
+        plano</quote>), você pode ter diversas instâncias todas
+        executando simultaneamente.  E finalmente, o Subversion espera
+        que seu programa retorne um código de erro igual a 1 se seu
+        programa tiver encontrado quaisuqer diferenças, ou 0 em caso
+        contrário—qualquer outro código resultante é considerado
+        como um erro fatal.
          <footnote>
-          <para>The GNU diff manual page puts it this way: <quote>An
-            exit status of 0 means no differences were found, 1 means some
-            differences were found, and 2 means trouble.</quote></para>
+          <para>A página de manual do GNU diff descreve isso da seguinte
+            forma: <quote>Uma saída de status de 0 significa que não
+            foram encontradas diferenças, 1 significa que algumas
+            diferenças foram encontradas, e 2 significa
+            problemas.</quote></para>
          </footnote>
        </para>

        <para><xref linkend="svn.advanced.externaldifftools.diff.ex-1"/>
-        and <xref linkend="svn.advanced.externaldifftools.diff.ex-2"/>
-        are templates for external diff tool wrappers in the Bourne
-        shell and Windows batch scripting languages,
-        respectively.</para>
+        e <xref linkend="svn.advanced.externaldifftools.diff.ex-2"/> são
+        modelos para scripts encapsuladores para ferramentas diff
+        externas, em formato de arquivos shell Bourne e batch do
+        Windows, respectivamente.</para>

        <example id="svn.advanced.externaldifftools.diff.ex-1">
          <title>diffwrap.sh</title>
          <programlisting>
  #!/bin/sh

-# Configure your favorite diff program here.
+# Configura seu programa diff preferido aqui.
  DIFF="/usr/local/bin/my-diff-tool"

-# Subversion provides the paths we need as the sixth and seventh
-# parameters.
+# O Subversion dispõe dos caminhos que precisamos como o sexto e
+# sétimo parâmetros.
  LEFT=${6}
  RIGHT=${7}

-# Call the diff command (change the following line to make sense for
-# your merge program).
+# Chama o comando diff (modifique a linha a seguir de acordo com seu
+# programa).
  $DIFF --left $LEFT --right $RIGHT

-# Return an errorcode of 0 if no differences were detected, 1 if some were.
-# Any other errorcode will be treated as fatal.
+# Retorna um código de erro de 0 se nenhumas diferenças forem
+# encontradas, ou 1 em caso contrário.  Qualquer outro código de erro
+# será considerado como fatal.
  </programlisting>
        </example>

@@ -1024,73 +1029,79 @@
          <programlisting>
  @ECHO OFF

-REM Configure your favorite diff program here.
+REM Configura seu programa diff preferido aqui.
  SET DIFF="C:\Program Files\Funky Stuff\My Diff Tool.exe"

-REM Subversion provides the paths we need as the sixth and seventh
-REM parameters.
+REM O Subversion dispõe dos caminhos que precisamos como o sexto e
+REM sétimo parâmetros.
  SET LEFT=%6
  SET RIGHT=%7

-REM Call the diff command (change the following line to make sense for
-REM your merge program).
+REM Chama o comando diff (modifique a linha a seguir de acordo com seu
+REM programa).
  %DIFF% --left %LEFT% --right %RIGHT%

-REM Return an errorcode of 0 if no differences were detected, 1 if some  
were.
-REM Any other errorcode will be treated as fatal.
+REM Retorna um código de erro de 0 se nenhumas diferenças forem
+REM encontradas, ou 1 em caso contrário.  Qualquer outro código de erro
+REM será considerado como fatal.
  </programlisting>
        </example>
      </sect2>

      <!-- ===============================================================  
-->
      <sect2 id="svn.advanced.externaldifftools.diff3">
-      <title>External diff3</title>
+      <title>Ferramentas diff3 Externas</title>

-      <para>Subversion calls external merge programs with parameters
-        suitable for the GNU diff3 utility, expecting that the
-        external program return with a successful error code and that
-        the full file contents which result from the completed merge
-        operation are printed on the standard output stream (so that
-        Subversion can redirect them into the appropriate version
-        controlled file).  For most alternative merge programs, only
-        the ninth, tenth, and eleventh arguments, the paths of the
-        files which represent the <quote>mine</quote>,
-        <quote>older</quote>, and <quote>yours</quote> inputs,
-        respectively, are of interest.  Note that because Subversion
-        depends on the output of your merge program, you wrapper
-        script must not exit before that output has been delivered to
-        Subversion.  When it finally does exit, it should return an
-        error code of 0 if the merge was successful, or 1 if unresolved
-        conflicts remain in the output—any other error code is
-        considered a fatal error.</para>
+      <para>O Subversion chama programas externos de fusão de texto com
+        parâmetros adequados para o utilitário GNU diff3, esperando que
+        o programa externo retorne com para o sistema com um código
+        indicando sucesso e que o conteúdo completo do arquivo
+        resultante da fusão de texto seja exibido na saída padrão (para
+        que então o Subversion possa redirecioná-la adequadamente para
+        o arquivo sob controle de versão).  Para a maioria dos programas
+        de fusão alternativos, apenas o nono, décimo e décimo primeiro
+        argumentos—os caminhos dos arquivos que representam a
+        <quote>minha</quote> versão do arquivo, a <quote>mais
+        antiga</quote> e a <quote>sua</quote> versão do arquivo,
+        respectivamente—são relevantes.  Note que como o
+        Subversion depende da saída de seu programa de fusão de texto,
+        seu script de encapsulamento não deve encerrar antes que a saída
+        tenha sido repassada ao Subversion.  Quando o script finalmente
+        terminar, ele deveria retornar um código de status de 0 se a
+        fusão foi executada com sucesso, ou 1 se conflitos ainda
+        permanecerem na saída—qualquer outro código de erro é
+        considerado como erro fatal.</para>

        <para><xref linkend="svn.advanced.externaldifftools.diff3.ex-1"/>
-        and <xref linkend="svn.advanced.externaldifftools.diff3.ex-2"/> are
-        templates for external merge tool wrappers in the Bourne shell
-        and Windows batch scripting languages, respectively.</para>
+        e <xref linkend="svn.advanced.externaldifftools.diff3.ex-2"/>
+        são modelos para scripts encapsuladores para ferramentas de
+        fusão de texto externas, em formato de arquivos shell Bourne e
+        batche do Windows, respectivamente.</para>

        <example id="svn.advanced.externaldifftools.diff3.ex-1">
          <title>diff3wrap.sh</title>
          <programlisting>
  #!/bin/sh

-# Configure your favorite diff3/merge program here.
+# Configura seu programa diff3 preferido aqui.
  DIFF3="/usr/local/bin/my-merge-tool"

-# Subversion provides the paths we need as the ninth, tenth, and eleventh
-# parameters.
+# O Subversion dispõe dos caminhos que precisamos como o nono, décimo e
+# décimo primeiro parâmetros.
  MINE=${9}
  OLDER=${10}
  YOURS=${11}

-# Call the merge command (change the following line to make sense for
-# your merge program).
+# Chama o comando de fusão de texto (modifique a linha a seguir de
+# acordo com seu programa).
  $DIFF3 --older $OLDER --mine $MINE --yours $YOURS

-# After performing the merge, this script needs to print the contents
-# of the merged file to stdout.  Do that in whatever way you see fit.
-# Return an errorcode of 0 on successful merge, 1 if unresolved conflicts
-# remain in the result.  Any other errorcode will be treated as fatal.
+# Depois de executar a fusão de texto, este script precisa imprimir o
+# conteúdo do arquivo resultante para stdout.  Você pode fazer isso da
+# forma que achar melhor.  Retorna um código de erro de 0 no caso de uma
+# fusão de sucesso, 1 se conflitos não resolvidos ainda permanecerem no
+# arquivo resultante.  Qualquer outro código de erro será tratado como
+# fatal.
  </programlisting>
        </example>

@@ -1099,26 +1110,29 @@
          <programlisting>
  @ECHO OFF

-REM Configure your favorite diff3/merge program here.
+REM Configura seu programa diff3 preferido aqui.
  SET DIFF3="C:\Program Files\Funky Stuff\My Merge Tool.exe"

-REM Subversion provides the paths we need as the ninth, tenth, and eleventh
-REM parameters.  But we only have access to nine parameters at a time, so  
we
-REM shift our nine-parameter window twice to let us get to what we need.
+REM O Subversion dispõe dos caminhos que precisamos como o nono, décimo e
+REM décimo primeiro parâmetros.  Mas só temos acesso a nove parâmetros de
+REM cada vez, então deslocamos nosso nove parâmetros duas vezes para que
+REM possamos obter os valores que precisamos.
  SHIFT
  SHIFT
  SET MINE=%7
  SET OLDER=%8
  SET YOURS=%9

-REM Call the merge command (change the following line to make sense for
-REM your merge program).
+REM Chama o comando de fusão de texto (modifique a linha a seguir de
+REM acordo com seu programa).
  %DIFF3% --older %OLDER% --mine %MINE% --yours %YOURS%

-REM After performing the merge, this script needs to print the contents
-REM of the merged file to stdout.  Do that in whatever way you see fit.
-REM Return an errorcode of 0 on successful merge, 1 if unresolved conflicts
-REM remain in the result.  Any other errorcode will be treated as fatal.
+REM Depois de executar a fusão de texto, este script precisa imprimir o
+REM conteúdo do arquivo resultante para stdout.  Você pode fazer isso da
+REM forma que achar melhor.  Retorna um código de erro de 0 no caso de uma
+REM fusão de sucesso, 1 se conflitos não resolvidos ainda permanecerem no
+REM arquivo resultante.  Qualquer outro código de erro será tratado como
+REM fatal.
  </programlisting>
        </example>



More information about the svn-pt_br mailing list