svn commit: r1922326 - /subversion/site/staging/docs/release-notes/1.15.html

Author: hartmannathan
Date: Thu Dec  5 17:11:17 2024
New Revision: 1922326

URL: http://svn.apache.org/viewvc?rev=1922326&view=rev
Log:
In site/staging: Document Multi-WC in 1.15 draft release notes

* site/staging/docs/release-notes/1.15.html:
  (#news): Add link to new section in TOC.
  (#multi-wc-format): New section.

Modified:
    subversion/site/staging/docs/release-notes/1.15.html

Modified: subversion/site/staging/docs/release-notes/1.15.html
URL: http://svn.apache.org/viewvc/subversion/site/staging/docs/release-notes/1.15.html?rev=1922326&r1=1922325&r2=1922326&view=diff
==============================================================================
--- subversion/site/staging/docs/release-notes/1.15.html (original)
+++ subversion/site/staging/docs/release-notes/1.15.html Thu Dec  5 17:11:17 2024
@@ -41,6 +41,8 @@
   -->
   <li><a href="#pristines-on-demand"
       >Pristines On Demand</a></li>
+  <li><a href="#multi-wc-format"
+      >Multi-WC: Multiple Working Copy Format Support</a></li>
   <li><a href="#streamy-checkouts"
       >Streamy Checkouts</a></li>
   <li><a href="#enhancements"
@@ -361,6 +363,61 @@ allowing the <tt>--store-pristine</tt> s
 
 </div> <!-- pristines-on-demand -->
 
+<div class="h3" id="multi-wc-format">
+<h3>Multi-WC: Multiple Working Copy Format Support
+  <a class="sectionlink" href="#multi-wc-format"
+     title="Link to this section">&para;</a>
+</h3>
+
+<p>Subversion 1.15 introduces a new working copy format (internally called
+Format 32) to support Pristines On Demand. Subversion 1.15 or newer is
+required to operate on working copies in this new format.</p>
+
+<p>For user convenience, Subversion 1.15 avoids the need to upgrade working
+copies unless the new features are used. This is accomplished in two ways:
+</p>
+
+<ul>
+  <li>Multi-WC: Subversion 1.15 introduces support for operating on multiple
+    working copy formats. Currently, two formats are supported. These are:
+    <ul>
+      <li><b>Format 32:</b> Compatible with Subversion 1.15 and newer.
+        Supports Pristines On Demand.
+      </li>
+
+      <li><b>Format 31:</b> Compatible with Subversion 1.8 and newer.
+        Maximizes compatiblity in case older Subversion clients are used.
+      </li>
+    </ul>
+  </li>
+
+  <li>Using Format 31 by default, unless the user selects Format 32 explicitly
+    or opts in to Pristines On Demand.
+  </li>
+</ul>
+
+<p>For example, a user who does not need Pristines On Demand may use a 1.15
+<tt>svn</tt> command line client interchangeably with a third party GUI client
+or other software package that incorporates 1.14 or older Subversion
+libraries.</p>
+
+<p>However, if using Pristines On Demand, or if Format 32 was selected
+explicitly, a 1.15 or newer client is required. Attempting to operate on such
+a working copy with an older client will result in an error, such as:</p>
+
+<pre>
+svn: E155021: This client is too old to work with the working copy at
+'/path/to/working/copy' (format 32).
+You need to get a newer Subversion client. For more details, see
+  http://subversion.apache.org/faq.html#working-copy-format-change
+</pre>
+
+<p>Currently, Pristines On Demand is the only feature that requires a newer
+working copy format, but newer features and working copy formats to support
+them may be added in future Subversion release lines.</p>
+
+</div> <!-- multi-wc-format -->
+
 <div class="h3" id="streamy-checkouts">
 <h3>Streamy Checkouts
   <a class="sectionlink" href="#streamy-checkouts"