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

codesite-noreply at google.com codesite-noreply at google.com
Thu Sep 25 17:01:45 CDT 2008


Author: mfandrade
Date: Thu Sep 25 15:01:20 2008
New Revision: 192

Modified:
    trunk/book/ch03-advanced-topics.xml

Log:
Tradução do capítulo 3 "Tópicos avançados", subseção "Propriedades".

Modified: trunk/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/book/ch03-advanced-topics.xml	(original)
+++ trunk/book/ch03-advanced-topics.xml	Thu Sep 25 15:01:20 2008
@@ -287,79 +287,89 @@
    <!-- =================================================================  
-->
    <!-- =================================================================  
-->
    <sect1 id="svn.advanced.props">
-    <title>Properties</title>
+    <title>Propriedades</title>
      <indexterm>
-      <primary>properties</primary>
+      <primary>propriedades</primary>
      </indexterm>

-    <para>We've already covered in detail how Subversion stores and
-      retrieves various versions of files and directories in its
-      repository.  Whole chapters have been devoted to this most
-      fundamental piece of functionality provided by the tool.  And
-      if the versioning support stopped there, Subversion would still
-      be complete from a version control perspective.</para>
-
-    <para>But it doesn't stop there.</para>
-
-    <para>In addition to versioning your directories and files,
-      Subversion provides interfaces for adding, modifying, and
-      removing versioned metadata on each of your versioned
-      directories and files.  We refer to this metadata as
-      <firstterm>properties</firstterm>, and they can be thought of as
-      two-column tables that map property names to arbitrary values
-      attached to each item in your working copy.  Generally speaking,
-      the names and values of the properties can be whatever you want
-      them to be, with the constraint that the names must be
-      human-readable text.  And the best part about these properties
-      is that they, too, are versioned, just like the textual contents
-      of your files.  You can modify, commit, and revert property
-      changes as easily as you can file content changes.  And the
-      sending and receiving of property changes occurs as part of your
-      typical commit and update operations—you don't have to
-      change your basic processes to accommodate them.</para>
+    <para>Nós já abordamos em detalhes como o Subversion armazena e
+      recupera várias versões de arquivos e diretórios em seu
+      repositório.  Capítulos inteiros têm sido focados nesta parte mais
+      fundamental das funcionalidades providas pela ferramenta.  E se o
+      suporte a versionamento parar por aí, o Subversion ainda seria
+      completo do ponto de vista do controle de versão.</para>
+
+    <para>Mas não pára por aí.</para>
+
+    <para>Adicionalmente ao versionamento de seus arquivos e diretórios,
+      o Subversion permite interfaces para adição, modificação e remoção
+      de metadados versionados em cada um de seus arquivos e diretórios
+      sob controle de versão.  Chamamos estes metadados de
+      <firstterm>propriedades</firstterm>, e eles podem ser entendidos
+      como tabelas de duas colunas que mapeiam nomes de propriedades a
+      valores arbitrários anexados a cada item em sua cópia de trabalho.
+      Falando de uma forma geral, os nomes e valores das propriedades
+      podem ser quaisquer coisas que você queira, com a restrição de que
+      os nomes devem ser texto legível por humanos.  E a melhor parte
+      sobre estas propriedades é que elas, também, são versionadas, tal
+      como o conteúdo textual de seus arquivos.  Você pode modificar,
+      submeter, e reverter alterações em propriedades tão facilmente
+      como em qualquer alteração no conteúdo de arquivos.  E o envio e
+      recebimento das modificações em propriedades ocorrem como parte de
+      suas operações de submissão
+      (<foreignphrase>commit</foreignphrase>) e atualização
+      (<foreignphrase>update</foreignphrase>)—você não tem que
+      mudar seus procedimentos básicos para utilizá-los.</para>

      <note>
-      <para>Subversion has reserved the set of properties whose names
-        begin with <literal>svn:</literal> as its own.  While there
-        are only a handful of such properties in use today, you should
-        avoid creating custom properties for your own needs whose names
-        begin with this prefix.  Otherwise, you run the risk that a
-        future release of Subversion will grow support for a feature
-        or behavior driven by a property of the same name but with
-        perhaps an entirely different interpretation.</para>
+      <para>O Subversion reservou um conjunto de propriedades cujos
+        nomes começam com <literal>svn:</literal> para si próprio.
+        Ainda que haja apenas um conjunto útil de tais propriedades em
+        uso hoje em dia, você deve evitar criar suas propriedades
+        específicas com nomes que comecem com este prefixo.  Do
+        contrário, você corre o risco de que uma versão futura do
+        Subversion aumente seu suporte a recursos ou comportamentos a
+        partir de uma propriedade de mesmo nome, mas talvez com um
+        significado completamente diferente.</para>
      </note>

-    <para>Properties show up elsewhere in Subversion, too.  Just as
-      files and directories may have arbitrary property names and
-      values attached to them, each revision as a whole may have
-      arbitrary properties attached to it.  The same constraints
-      apply—human-readable names and anything-you-want binary
-      values.  The main difference is that revision properties are not
-      versioned.  In other words, if you change the value of, or
-      delete, a revision property, there's no way within the scope of
-      Subversion's functionality to recover the previous value.</para>
-
-    <para>Subversion has no particular policy regarding the use of
-      properties.  It asks only that you not use property names that
-      begin with the prefix <literal>svn:</literal>.  That's the
-      namespace that it sets aside for its own use.  And Subversion
-      does, in fact, use properties, both the versioned and
-      unversioned variety.  Certain versioned properties have special
-      meaning or effects when found on files and directories, or house
-      a particular bit of information about the revisions on which
-      they are found.  Certain revision properties are automatically
-      attached to revisions by Subversion's commit process, and carry
-      information about the revision.  Most of these properties are
-      mentioned elsewhere in this or other chapters as part of the
-      more general topics to which they are related.  For an
-      exhaustive list of Subversion's pre-defined properties, see
-      <xref linkend="svn.ref.properties"/>.</para>
-
-    <para>In this section, we will examine the utility—both to
-      users of Subversion, and to Subversion itself—of property
-      support.  You'll learn about the property-related
-      <command>svn</command> subcommands, and how property
-      modifications affect your normal Subversion workflow.</para>
+    <para>Propriedades aparecem em qualquer parte no Subversion, também.
+      Da mesma maneira que arquivos e diretórios podem ter nomes de
+      propriedades arbitrários e valores anexados a eles, cada revisão
+      como um todo pode ter propriedades arbitrárias anexadas a si
+      própria.  As mesmas restrições se aplicam;mdash;nomes que sejam
+      legíveis por humanos e valores com qualquer coisa que você queira,
+      inclusive dados binários.  A principal diferença é que as
+      propriedades de uma revisão não são versionadas.  Em outras
+      palavras, se você modificar o valor de, ou excluir uma propriedade
+      de uma revisão, não há uma forma de recuperar seu valor anterior
+      no Subversion.</para>
+
+    <para>O Subversion não tem nenhuma política em particular em relação
+      ao uso de propriedades.  Ele apenas solicita que você não use
+      nomes de propriedades que comecem com o prefixo
+      <literal>svn:</literal>.  Este é o espaço de nomes
+      (<foreignphrase>namespace</foreignphrase>) que ele reserva para
+      uso próprio.  E o Subversion, de fato, faz uso de propriedades,
+      tanto do tipo versionadas quando das não-versionadas.  Certas
+      propriedades versionadas têm um significado especial ou certos
+      efeitos quando encontradas em arquivos e diretórios, ou carregam
+      alguma pequena informação sobre a revisão na qual estes se
+      encontram.  Certas propriedades de revisão são automaticamente
+      anexadas às revisões pelo processo de submissão de alterações do
+      Subversion, e obtém informação sobre a revisão.  Muitas dessas
+      propriedades são mencionadas em algum lugar neste ou em outros
+      capítulos como parte de tópicos mais gerais aos quais estão
+      relacionadas.  Para uma lista exaustiva das propriedades
+      pré-definidas do Subversion, veja <xref
+      linkend="svn.ref.properties"/>.</para>
+
+    <para>Nesta seção, vamos examinar a utilidade—tanto para os
+      usuários quanto para o próprio Subversion—do suporte a
+      propriedades.  Você vai aprender sobre os subcomandos de
+      <command>svn</command> que lidam com propriedaes, e como
+      alterações nas propriedades afetam seu fluxo de trabalho normal no
+      Subversion.</para>

      <!-- ===============================================================  
-->
      <sect2 id="svn.advanced.props.why">


More information about the svn-pt_br mailing list