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

[ha...@apache.org]

Author: hartmannathan
Date: Fri Feb 18 00:15:18 2022
New Revision: 1898164

URL: http://svn.apache.org/viewvc?rev=1898164&view=rev
Log:
* site/staging/1.15.html:
  (#bare-working-copies): New subsection; start documenting work-in-progress
   "pristines-on-demand" a.k.a. "bare-working-copy".

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=1898164&r1=1898163&r2=1898164&view=diff
==============================================================================
--- subversion/site/staging/docs/release-notes/1.15.html (original)
+++ subversion/site/staging/docs/release-notes/1.15.html Fri Feb 18 00:15:18 2022
@@ -162,6 +162,95 @@ users.  We'll cover those in this sectio
     title="Link to this section">&para;</a>
 </h2>
 
+<div class="h3" id="bare-working-copies">
+<h3>Bare Working Copies
+  <a class="sectionlink" href="#bare-working-copies"
+     title="Link to this section">&para;</a>
+</h3>
+
+<div class="notice">
+<p><b>The term "Bare Working Copy" is a placeholder for the eventual name of
+  this feature.</b></p>
+</div>
+
+<p>All Subversion working copies require extra storage space in addition to
+the size of the checked out files.</p>
+
+<p>By default, the total storage space required is slightly more than double
+the size of the checked out files. Subversion uses most of that extra space to
+cache each file's BASE revision so that many operations can work faster and
+offline.</p>
+
+<p>Starting in 1.15, users can check out a bare working copy to cut the
+storage requirement by up to 50%. Instead of caching the BASE revision of all
+files all the time, Subversion will only fetch and cache those of individual
+files when needed, and will eliminate them when no longer needed. The space
+savings come at a tradeoff of requiring a connection to the repository for
+more operations as compared to a normal working copy and may, depending on
+network speeds and file sizes, introduce a perceptible delay when a BASE file
+is downloaded.</p>
+
+<p>This feature is motivated by use cases involving very large versioned files
+that change infrequently, where keeping the cached BASE copy wastes space and
+provides little or no benefit. This feature may also be useful in other
+scenarios, such as where a very fast connection to the server is available,
+the repository is local, available storage space is very limited, etc.</p>
+
+<p>To check out a bare working copy:</p>
+
+$ svn checkout --foo --bar $REPO $WC
+
+<p>The command to check out a normal working copy is unchanged.</p>
+
+<p>The following table lists all Subversion commands and whether they need to
+access the repository:</p>
+
+<table border="1">
+  <tr>
+    <th></th>
+    <th colspan="2">Working Copy Type</th>
+  </tr>
+  <tr>
+    <th>Command</th>
+    <th>Normal</th>
+    <th>Bare</th>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td></td>
+  </tr>
+</table>
+
+<p>Legend:</p>
+
+<ul>
+  <li><b>Never:</b> This operation never contacts the repository.</li>
+
+  <li><b>Remote URL:</b> This operation contacts the repository only if given
+    a repository path. It does not contact the repository when operating on a
+    local path.</li>
+
+  <li><b>When Modified:</b> This operation contacts the repository when the
+    path in question is locally modified ('svn status' shows 'M' in the 1st
+    column) or is provided with a repository URL.</li>
+
+  <li><b>Always:</b> This operation always contacts the repository.</li>
+</ul>
+
+<p>Additional Details:</p>
+
+<p>When operating on a bare working copy, the Subversion client will
+download the BASE revision of a file when it detects that the file is
+locally modified and an operation involving that file requires the
+BASE revision.</p>
+
+<p>Once downloaded, the BASE revision will remain locally cached until a
+further operation either restores the file to an unmodified state or
+detects that the file is no longer modified.</p>
+
+</div> <!-- bare-working-copies -->
+
 </div>  <!-- new-features -->
 
 <div class="h2" id="enhancements">