svn commit: r1693673 - /subversion/site/publish/docs/release-notes/1.9.html

[da...@apache.org]

Author: danielsh
Date: Fri Jul 31 23:51:02 2015
New Revision: 1693673

URL: http://svn.apache.org/r1693673
Log:
* docs/release-notes/1.9.html
  (#svn-info-item): Initial content.

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

Modified: subversion/site/publish/docs/release-notes/1.9.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.9.html?rev=1693673&r1=1693672&r2=1693673&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.9.html (original)
+++ subversion/site/publish/docs/release-notes/1.9.html Fri Jul 31 23:51:02 2015
@@ -754,8 +754,49 @@ support reading or writing FSX repositor
      title="Link to this section">&para;</a>
 </h4>
 
-<p>### TODO
-</p>
+<p>The <tt>svn info</tt> command can now display the value of one of the fields
+and nothing else, for easier consumption by scripts.</p>
+
+<p>Subversion 1.8 and earlier had two output modes: the default, human-oriented
+output, mode and the XML mode for scripted use.  Subversion 1.9 adds a third
+output mode, whereby exactly one attribute will be displayed:</p>
+
+<pre>
+## Display the youngest revision of a repository:
+% svn info --show-item=revision https://svn.apache.org/repos/asf/subversion/trunk
+1693514
+
+## Find the root directory of a working copy:
+% svn info --show-item=wc-root
+/home/jrandom/src/svn/trunk
+</pre>
+
+<p>Incidentally, Subversion will also attempt to offer the correct selector name
+if the argument was misspelled:</p>
+
+<pre>
+% svn info --show-item=wcroot
+svn: E205000: Try 'svn help info' for more information
+svn: E205000: 'wcroot' is not a valid value for --show-item; did you mean 'wc-root'?
+</pre>
+
+<p>The list of valid arguments to <tt>--show-item</tt> may be found in its help
+message, <tt>svn help info</tt>.  As of 1.9, the valid values are
+<tt>kind</tt>,
+<tt>url</tt>,
+<tt>relative-url</tt>,
+<tt>repos-root-url</tt>,
+<tt>repos-uuid</tt>,
+<tt>revision</tt>,
+<tt>last-changed-revision</tt>,
+<tt>last-changed-date</tt>,
+<tt>last-changed-author</tt>,
+and
+<tt>wc-root</tt>.</p>
+
+<p>The <tt>--no-newline</tt> argument instructs <tt>svn</tt>
+not to emit a cosmetic newline (<tt>\n</tt>) after the value.</p>
+
 </div> <!-- svn-info-item -->
 
 <div class="h4" id="svn-propget-no-newline">