Author: cmpilato
Date: Tue Jun 22 15:40:00 2010
New Revision: 956921

URL: http://svn.apache.org/viewvc?rev=956921&view=rev
Log:
Correct the FSFS structure documentation for lock storage, which
doesn't appear to match the implementation.

If a repository has a locked file /A/D/G/rho, there will be a
serialized hash file for that path (as an MD5 digest,
".../db/2d9/2d9ce8aaac06331d75dae9dad43473bd", in this example), and
that digest file will be directly referenced from the digest files for
/A/D/G, /A/D, /A and /.  The documentation implies that the digest
file for /A/D/G/rho will only be referenced by a digest file for
/A/D/G (which is then referenced by the digest file for /A/D, which
itself is referenced by the digest for /A, etc.)

* subversion/libsvn_fs_fs/structure
  (Locks layout): Correct the lock discovery algorithm description.

Modified:
    subversion/trunk/subversion/libsvn_fs_fs/structure

Modified: subversion/trunk/subversion/libsvn_fs_fs/structure
URL: 
http://svn.apache.org/viewvc/subversion/trunk/subversion/libsvn_fs_fs/structure?rev=956921&r1=956920&r2=956921&view=diff
==============================================================================
--- subversion/trunk/subversion/libsvn_fs_fs/structure (original)
+++ subversion/trunk/subversion/libsvn_fs_fs/structure Tue Jun 22 15:40:00 2010
@@ -500,7 +500,8 @@ names are the first 3 characters of the 
 
 Also stored in the digest file for a given FS path are pointers to
 other digest files which contain information associated with other FS
-paths that are our path's immediate children.
+paths that are beneath our path (an immediate child thereof, or a
+grandchild, or a great-grandchild, ...).
 
 To answer the question, "Does path FOO have a lock associated with
 it?", one need only generate the MD5 digest of FOO's
@@ -515,4 +516,4 @@ To inquire about locks on children of th
 reference the same path as above, but look for a list of children in
 that file (instead of lock information).  Children are listed as MD5
 digests, too, so you would simply iterate over those digests and
-consult the files they reference, and so on, recursively.
+consult the files they reference for lock information.


Reply via email to