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

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>