[svnbook commit] r3182 - trunk/src/en/book

[cmpilato]

Author: cmpilato
Date: Mon Jun 30 12:27:22 2008
New Revision: 3182

Log:
Add a blurb about not going crazy with large properties or property sets.

Suggested by: Karl Heinz Marbaise

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

Modified: trunk/src/en/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch03-advanced-topics.xml	(original)
+++ trunk/src/en/book/ch03-advanced-topics.xml	Mon Jun 30 12:27:22 2008
@@ -396,6 +396,17 @@
         information that your site needs to display without having to
         read an index file or play path manipulation games.</para>
 
+      <note>
+        <para>While Subversion places few restrictions on the names
+          and values you use for properties, it has not been designed
+          to optimally carry large property values or large sets of
+          properties on a given file or directory.  Subversion
+          commonly holds all the property names and values associated
+          with a single item in memory at the same time, which can
+          cause detrimental performance or failed operations when
+          extremely large property sets are used.</para>
+      </note>
+
       <para>Custom revision properties are also frequently used.  One
         common such use is a property whose value contains an issue
         tracker ID with which the revision is associated, perhaps