svn commit: r1797126 - /subversion/site/publish/docs/release-notes/1.10.html

[danielsh]

Author: danielsh
Date: Wed May 31 22:26:19 2017
New Revision: 1797126

URL: http://svn.apache.org/viewvc?rev=1797126&view=rev
Log:
* docs/release-notes/1.10.html
  (#svnadmin-LOCK_PATH-canonical): New section, documents r1797122.

Modified:
    subversion/site/publish/docs/release-notes/1.10.html

Modified: subversion/site/publish/docs/release-notes/1.10.html
URL: 
http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.10.html?rev=1797126&r1=1797125&r2=1797126&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.10.html (original)
+++ subversion/site/publish/docs/release-notes/1.10.html Wed May 31 22:26:19 
2017
@@ -176,6 +176,49 @@ users.  We'll cover those in this sectio
 
 </div>  <!-- next-release-is-1.11 -->
 
+<div class="h4" id="svnadmin-LOCK_PATH-canonical">
+<h4><tt>svnadmin</tt> subcommands print locked paths differently
+  <a class="sectionlink" href="#svnadmin-LOCK_PATH-canonical"
+    title="Link to this section">&para;</a>
+</h4>
+
+<!-- This documents https://svn.apache.org/r1797122 -->
+
+<p>The
+<tt>svnadmin lock</tt>,
+<tt>svnadmin unlock</tt>, and
+<tt>svnadmin rmlocks</tt>
+subcommands print the locked path differently.</p>
+
+<p>In 1.9 and earlier, the path would be printed out in exactly the form it 
was input.
+In 1.10, the path is printed in "canonical" form:
+with dot components (<tt>foo/./bar</tt>) elided and multiple slashes 
(<tt>foo//bar</tt>) compressed to one.
+The path also starts with a slash in the output,
+regardless of whether a leading slash was present in the input.</p>
+
+<p>Example:</p>
+
+<pre>
+$ svnadmin-1.9 lock r //iota jrandom logmsg opaquelocktoken:42
+'//iota' locked by user 'jrandom'.
+$ svnadmin-1.9 unlock r //iota jrandom opaquelocktoken:42
+'//iota' unlocked by user 'jrandom'.
+
+
+$ svnadmin-1.10 lock r //iota jrandom logmsg opaquelocktoken:42
+'/iota' locked by user 'jrandom'.
+$ svnadmin-1.10 unlock r //iota jrandom opaquelocktoken:42
+'/iota' unlocked by user 'jrandom'.
+$
+</pre>
+
+<p>Only the output is changed.
+The set of valid inputs and the behaviour of <tt>svnadmin</tt> on them are 
unchanged.
+<tt>svnadmin</tt> continues to accept paths either with or without multiple 
slashes,
+dot components, and so on as command-line arguments.</p>
+
+</div>  <!-- svnadmin-LOCK_PATH-canonical -->
+
 </div>  <!-- compat-misc -->
 
 </div>  <!-- compatibility -->