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">¶</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"
