Author: julianfoad
Date: Mon Sep 24 09:38:46 2018
New Revision: 1841819
URL: http://svn.apache.org/viewvc?rev=1841819&view=rev
Log:
* publish/docs/release-notes/1.11.html
(viewspec-output): Update; add detail; add 'experimental' warning.
Modified:
subversion/site/publish/docs/release-notes/1.11.html
Modified: subversion/site/publish/docs/release-notes/1.11.html
URL:
http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.11.html?rev=1841819&r1=1841818&r2=1841819&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.11.html (original)
+++ subversion/site/publish/docs/release-notes/1.11.html Mon Sep 24 09:38:46
2018
@@ -368,15 +368,33 @@ moved on source branch" and
<div class="h4" id="viewspec-output">
<h4>Viewspec output command (experimental)
+ (<a href="https://issues.apache.org/jira/browse/SVN-4753";>issue #4753</a>)
<a class="sectionlink" href="#viewspec-output"
title="Link to this section">¶</a>
</h4>
-<p>An experimental '<tt>svn info --viewspec</tt>' command outputs a view
-spec describing the current WC shape, in the format used by the old script
-<a
href="http://svn.apache.org/viewvc/subversion/trunk/tools/client-side/svn-viewspec.py";>tools/client-side/svn-viewspec.py</a>.
-See <a href="https://issues.apache.org/jira/browse/SVN-4753";>issue #4753</a>
-"SVN viewspec feature".</p>
+<p>There is an experimental command to write out a view spec describing the
+current WC shape.</p>
+
+<div class="notice">
+ <p><span style="color: red"><b>WARNING:</b></span> This feature
+ is designated "EXPERIMENTAL" in 1.11. It is being released in an early form
+ while development continues. It is expected to change significantly during
+ and after the 1.11.x series. There is no promise of backward compatibility
+ while it remains experimental.</p>
+</div>
+
+<p>A view spec describes whether each subtree is at a limited depth, excluded,
+switched to a different URL, or updated to a different revision number,
+compared with its parent directory. This information is sometimes referred
+to as the shape or the layout of a WC.</p>
+
+<p>'<tt>svn info --x-viewspec=classic</tt>' writes in the format used by the
old script
+<a
href="http://svn.apache.org/viewvc/subversion/trunk/tools/client-side/svn-viewspec.py";>tools/client-side/svn-viewspec.py</a>.</p>
+
+<p>'<tt>svn info --x-viewspec=svn11</tt>' writes a series of '<tt>svn</tt>'
+command lines. You can create a new WC of the same layout by running these
+commands.</p>
</div> <!-- viewspec-output -->
