[svnbook] r3564 commited - * src/en/book/ch03-advanced-topics.xml...

[codesite-noreply at google.com]

Revision: 3564
Author: cmpilato at gmail.com
Date: Fri Jul 24 11:29:59 2009
Log: * src/en/book/ch03-advanced-topics.xml
   Add a note (a warning, really, but not so harsh) about not presuming the
   existence of any revision properties.

http://code.google.com/p/svnbook/source/detail?r=3564

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

=======================================
--- /trunk/src/en/book/ch03-advanced-topics.xml	Fri Jul 24 08:36:59 2009
+++ /trunk/src/en/book/ch03-advanced-topics.xml	Fri Jul 24 11:29:59 2009
@@ -344,6 +344,21 @@
        related.  For an exhaustive list of Subversion's predefined
        properties, see <xref linkend="svn.ref.properties" />.</para>

+    <note>
+      <para>While Subversion automatically attaches properties
+        (<literal>svn:date</literal>, <literal>svn:author</literal>,
+        <literal>svn:log</literal>, and so on) to revisions, it does
+        <emphasis>not</emphasis> presume thereafter the existence of
+        those properties, and neither should you or the tools you use to
+        interact with your repository.  Revision properties can be
+        deleted programmatically or via the client (if allowed by the
+        repository hooks) without damaging Subversion's ability to
+        function.  So, when writing scripts which operate on your
+        Subversion repository data, do not make the mistake of
+        assuming that any particular revision property exists on a
+        revision.</para>
+    </note>
+
      <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