Author: hartmannathan
Date: Tue Nov 26 19:45:10 2024
New Revision: 1922133
URL: http://svn.apache.org/viewvc?rev=1922133&view=rev
Log:
In site/staging: Improve clarity of 1.15 draft release notes
* site/staging/docs/release-notes/1.15.html:
(#wc-upgrade): Multiple versions of Subversion are discussed here, as well as
internal working copy format numbers. Try to put the information users need
first and reduce emphasis on internals.
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=1922133&r1=1922132&r2=1922133&view=diff
==============================================================================
--- subversion/site/staging/docs/release-notes/1.15.html (original)
+++ subversion/site/staging/docs/release-notes/1.15.html Tue Nov 26 19:45:10
2024
@@ -129,22 +129,23 @@ checkout a new working copy.</li>
<li>Subversion 1.15 can read and write existing <b>Subversion 1.8 through
1.14</b>
working copies in-place, <em>without upgrading them</em>. Subversion 1.8
-through 1.15 can be used interchangeably on such working copies. These working
-copies are termed "format 31" working copies.</li>
+through 1.15 can be used interchangeably on such working copies. (Internally,
+these are termed "format 31" working copies.)</li>
<li>Additionally, Subversion 1.15 adds a new working copy format that
-cannot be read by Subversion 1.14 and older. This format is called
-"format 32".</li>
+cannot be read by Subversion 1.14 and older. (Internally, these are termed
+"format 32" working copies.)</li>
</ul>
-<p>Both <tt>svn checkout</tt> and <tt>svn upgrade</tt> will produce
-format-31 working copies unless explicitly instructed otherwise.</p>
+<p>By default, both <tt>svn checkout</tt> and <tt>svn upgrade</tt> will
+produce working copies supported by Subversion 1.8 through 1.15
(format-31).</p>
<p>To instruct Subversion to use a particular working copy format, pass the new
-<tt>--compatible-version=1.15</tt> command-line option to these commands. If
-you use multiple Subversion clients, pass the version number of the
-<em>oldest</em> client that should be able to operate on the working copy.</p>
+<tt>--compatible-version=1.15</tt> command-line option to these commands. This
+will choose the newest format that is compatible with the specified version of
+Subversion. If you use multiple Subversion clients, pass the version number of
+the <em>oldest</em> client that will operate on the working copy.</p>
<p class='todo'>Document what's new in format 32</p>
