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

codesite-noreply at google.com codesite-noreply at google.com
Sat Apr 5 11:51:42 CDT 2008


Author: camponez
Date: Sat Apr  5 09:50:48 2008
New Revision: 84

Modified:
   trunk/book/ch08-embedding-svn.xml

Log:
Parte do issue 62

Modified: trunk/book/ch08-embedding-svn.xml
==============================================================================
--- trunk/book/ch08-embedding-svn.xml	(original)
+++ trunk/book/ch08-embedding-svn.xml	Sat Apr  5 09:50:48 2008
@@ -580,85 +580,86 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <sect1 id="svn.developer.insidewc">
-    <title>Inside the Working Copy Administration Area</title>
+    <title>Por dentro da área de Administração da cópia de trabalho</title>
     
-    <para>As we mentioned earlier, each directory of a Subversion
-      working copy contains a special subdirectory called
-      <filename>.svn</filename> which houses administrative data about
-      that working copy directory.  Subversion uses the information in
-      <filename>.svn</filename> to keep track of things like:</para>
+    <para>Como mencionamos anteriormente, cada diretório do Subversion
+	tem um diretório especial chamado <filename>.svn</filename> que
+	hospeda informações administrativas sobre o diretório da 
+	cópia de trabalho. Subversion usa essa informação do <filename>.svn</filename>
+	para rastrear coisas como:</para>
 
     <itemizedlist>
       <listitem>
-        <para>Which repository location(s) are represented by the
-          files and subdirectories in the working copy
-          directory.</para>
+	  <para>Qual(is) os locais dos repositórios que são representados pelos
+	      arquivos e subdiretórios no diretório da cópia de trabalho</para>
       </listitem>
       <listitem>
-        <para>What revision of each of those files and directories are
-          currently present in the working copy.</para>
+	  <para>Que revisão de cada arquivo e diretório  está
+	      representado no momento na sua cópia de trabalho</para>
       </listitem>
       <listitem>
-        <para>Any user-defined properties that might be attached
-          to those files and directories.</para>
+	  <para>Propriedades definidas pelo usuário que podem estar
+	      ligadas a esses arquivos e diretórios.</para>
       </listitem>
       <listitem>
-        <para>Pristine (un-edited) copies of the working copy
-          files.</para>
+	  <para>--FIXME--Pristine (un-edited) cópias de arquivos 
+	      da cópia de trabalho.</para>
       </listitem>
     </itemizedlist>
 
-    <para>The Subversion working copy administration area's layout and
-      contents are considered implementation details not really
-      intended for human consumption.  Developers are encouraged to
-      use Subversion's public APIs, or the tools that Subversion provides, to access and
-      manipulate the working copy data, instead of directly reading
-      or modifying those files.  The file formats employed by the working
-      copy library for its administrative data do change from time to
-      time—a fact that the public APIs do a great job of
-      hiding from the average user.  In this section, we
-      expose some of these implementation details sheerly to appease
-      your overwhelming curiosity.</para>
+    <para>A área de administração da cópia de trabalho do Subversion e
+	o seu conteúdo são consideradas implementações detalhadas e não
+	tem intenção de serem para consumo humano. Desenvolvedores
+	são encorajados a suar APÌs públicas do Subversion, ou as 
+	ferramentas que o Subversion provê, para acessar e 
+	manipular as informações da cópia local de trabalho, ao
+	invés de ler ou modificar diretamente esses arquivos.
+	Os formatos de arquivos empregados pela biblioteca
+	de cópia local para administração realmente muda de tempos
+	em tempos—um fato é que as APIs públicas fazem um
+	bom trabalho ao se esconder do usuário comum. Nessa seção,
+	vamos expor algumas desses detalhes de implementação para
+	satisfazer sua grande curiosidade.</para>
 
     <!-- =============================================================== -->
     <sect2 id="svn.developer.insidewc.entries">
-      <title>The Entries File</title>
+      <title>Os arquivos de Entrada</title>
 
-      <para>Perhaps the single most important file in the
-        <filename>.svn</filename> directory is the
-        <filename>entries</filename> file.  It
-        contains the bulk of the administrative
-        information about the versioned items in a working copy
-        directory.  It is this one file which tracks the repository
-        URLs, pristine revision, file checksums, pristine text and
-        property timestamps, scheduling and conflict state
-        information, last-known commit information (author, revision,
-        timestamp), local copy history—practically everything
-        that a Subversion client is interested in knowing about a
-        versioned (or to-be-versioned) resource!</para>
-
-      <para>Folks familiar with CVS's administrative directories will
-        have recognized at this point that Subversion's
-        <filename>.svn/entries</filename> file serves the purposes of,
-        among other things, CVS's <filename>CVS/Entries</filename>,
-        <filename>CVS/Root</filename>, and
-        <filename>CVS/Repository</filename> files combined.</para>
-
-      <para>The format of the <filename>.svn/entries</filename> file
-        has changed over time.  Originally an XML file, it now uses a
-        custom—though still human-readable—file format.
-        While XML was a great choice for early developers of
-        Subversion who were frequently debugging the file's contents
-        (and Subversion's behavior in light of them), the need for
-        easy developer debugging has diminished as Subversion has
-        matured, and has been replaced by the user's need for snappier
-        performance.  Be aware that Subversion's working copy library
-        automatically upgrades working copies from one format to
-        another—it reads the old formats, and writes the
-        new—which saves you the hassle of checking out a new
-        working copy, but can also complicate situations where
-        different versions of Subversion might be trying to use the
-        same working copy.</para>
+      <para>Talvez o arquivo único de maior importância no
+	  diretório <filenam>.svn</filename> é o arquivo 
+	  <filename>entries</filename>. Nele está contido
+	  uma quantidade de informações administrativas sobre
+	 os ítens versionados no diretório da cópia de trabalho.
+	 É esse arquivo que rastreia as URLs do repositório, arquivos
+	 intocados, arquivos de checksum, textos intocados, 
+	 timestamps de propriedades, agendamento e informações de 
+	 conflitos, última informações conhecida de commit (autor, 
+	 revisão, timestamp), cópia local do histórico—praticamente
+	 tudo que um cliente Subversion tem interesse em saber sobre
+	 dados versionados ou que serão versionados!</para>
+
+     <para>Pessoas familiares com diretórios de administração do CVS
+	 vão reconhecer nesse ponto que o arquivo <filename>.svn/entries</filename>
+	 serve ao propósito de, além de outras coisas, uma combinação dos 
+	 arquivos <filename>CVS/Entries</filename>,
+	 <filename>CVS/Root</filename>, and 
+	 <filename>CVS/Repository</filename>.</para>
+
+     <para>O formato do aquivo <filename>.snv/entries</filename> 
+	 tem mudado ao longo do tempo. Originalmente como um arquivo
+	 XML, usa um formato customizado—mas ainda legível a humanos—.
+	 Enquanto o XML foi uma boa escolha para o início do desenvolvimento
+	 do Subversion que era frequentemente debugado o conteúdo do arquivos
+	 (e o comportamento do Subversion na visão deles), a necessidade
+	 de um debug fácil no desenvolvimento foi se reduzindo com 
+	 a maturidade do Subversion, e vem sendo substituido pela
+	 impaciencia do usuário em ter performace. Fique atento
+	 que a biblioteca de cópia de trabalho do Subversion
+	 atualiza automaticamente cópias de trabalho de um formato para
+	 outro—ele lé formatos velhos, e escreve no novo—o que
+	 o salva do problema de checkar uma nova cópia de trabalho, 
+	 mas pode complicar em situações onde diferentes versões do 
+	 Subversion estão tentando usar a mesma cópia de trabablho.</para> 
 
     </sect2>
 




More information about the svn-pt_br mailing list