svn commit: r1853392 - /subversion/trunk/notes/shelving/shelf-structure.txt

[ju...@apache.org]

Author: julianfoad
Date: Mon Feb 11 16:58:16 2019
New Revision: 1853392

URL: http://svn.apache.org/viewvc?rev=1853392&view=rev
Log:
* notes/shelving/shelf-structure.txt: Update for shelving v2 in svn 1.11.

Modified:
    subversion/trunk/notes/shelving/shelf-structure.txt

Modified: subversion/trunk/notes/shelving/shelf-structure.txt
URL: http://svn.apache.org/viewvc/subversion/trunk/notes/shelving/shelf-structure.txt?rev=1853392&r1=1853391&r2=1853392&view=diff
==============================================================================
--- subversion/trunk/notes/shelving/shelf-structure.txt (original)
+++ subversion/trunk/notes/shelving/shelf-structure.txt Mon Feb 11 16:58:16 2019
@@ -1,28 +1,34 @@
 == Storage Structure for Shelving ==
 
 
-=== Shelving (trunk) ===
+=== Shelving v2 ===
 
-In development in trunk (1.11-dev), marked "experimental".
+Released in Subversion 1.11.0, marked "experimental".
 
 Each shelf has zero or more versions of the change, and exactly one set of
 'revision' properties.
 
-* .svn/shelves
+* .svn/experimental/shelves/v2
   This subdirectory holds all shelving metadata and data.
   It is created on demand, and never deleted.
 
-* .svn/shelves/<encoded-name>.current
+* .svn/experimental/shelves/v2/<encoded-name>.current
   Holds an ASCII-decimal number stating the latest shelf-version of the
-  shelf <encoded-name>.
+  shelf <encoded-name>, followed by a newline character (LF).
 
-* .svn/shelves/<encoded-name>.log
+* .svn/experimental/shelves/v2/<encoded-name>.log
   Holds the 'revision' properties of the shelf, in svn_hash_write2() format
   terminated with "PROPS-END". Created when any revprop is set; need not
   exist.
 
-* .svn/shelves/<encoded-name>-<version>.patch
-  The patch file representing version <version>.
+* .svn/experimental/shelves/v2/<encoded-name>-<version>.d
+  Directory holding the metadata and {base,working}{text,props} files for a
+  shelf-version. For each shelved WC-relpath <P>:
+  - <P>.meta : metadata, serialized in a shelf-v2-specific format
+  - <P>.base : the base text (absent for a directory)
+  - <P>.work : the working text (absent for a directory)
+  - <P>.base-props : the base properties
+  - <P>.work-props : the working properties
 
 <encoded-name>: the shelf name as UTF-8, encoded byte-by-byte into
   two-hex-digit pairs, e.g. shelf name 'Az' is encoded as '417f'.