svn commit: r1466066 - /subversion/site/publish/docs/release-notes/1.8.html

[cm...@apache.org]

Author: cmpilato
Date: Tue Apr  9 15:03:03 2013
New Revision: 1466066

URL: http://svn.apache.org/r1466066
Log:
* site/publish/docs/release-notes/1.8.html
  (#davkeywordexpansion): New section, documenting the new ?kw=1 CGI
    parameter for mod_dav_svn's GET handing.

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

Modified: subversion/site/publish/docs/release-notes/1.8.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.8.html?rev=1466066&r1=1466065&r2=1466066&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.8.html (original)
+++ subversion/site/publish/docs/release-notes/1.8.html Tue Apr  9 15:03:03 2013
@@ -2071,6 +2071,50 @@ SVNMasterVersion 1.7.7
 
 </div>  <!-- svnmasterversion -->
 
+<div class="h3" id="davkeywordexpansion">
+<h3>Keyword expansion via DAV repsitory browser
+  <a class="sectionlink" href="#davkeywordexpansion"
+    title="Link to this section">&para;</a>
+</h3>
+
+<p>One of the earliest features of the mod_dav_svn Subversion server
+was the ability for users to browse their repositories directly with a
+web browser.  <tt>GET</tt> requests issued by browser and aimed at
+Subversion directory URLs return a directory listing; those aimed at
+file URLs return the file's current contents.</p>
+
+<p>In Subversion 1.6, we expanded that feature to allow browsing of
+historical artifacts in your repository via
+new <a href="/docs/release-notes/1.6.html#historical-uris"
+><tt>p=<em>PEGREV</em></tt> and <tt>r=<em>REV</em></tt> CGI
+parameters</a>.</p>
+
+<p>Now in Subversion 1.8, we've added still another CGI
+parameter: <tt>kw=1</tt>.</p>
+
+    <pre>http://host/repos/path?kw=1</pre>
+
+<p>Users who include <tt>kw=1</tt> in the query string portion
+of <tt>GET</tt> requests aimed at a versioned file will now be
+delivered that file's contents with any Subversion keywords expanded
+therein.  Because keyword substitution is typically performed by the
+Subversion client as part of its working copy administration and
+management, this is handy way to get the server to deliver a
+keyword-expanded form of your versioned file without the use of a
+working copy.  Omitting the <tt>kw</tt> parameter or using something
+other than "1" for its value will cause Subversion to use its default
+behavior, which is to deliver the file's contents without any keywords
+expanded.  (NOTE: We reserve the right to recognize new meaningful
+values for the <tt>kw</tt> flag in the future, so please avoid
+specifying any value other than "1" when using the parameter at
+all.)</p>
+
+<p>As with client-side keyword expansion, only those keywords which
+are explicitly designated for expansion via the <tt>svn:keywords</tt>
+property set on the file itself will be expanded.</p>
+
+</div>  <!-- davkeywordexpansion -->
+
 <div class="h3" id="exclusivelocking">
 <h3>Exclusive SQLite locking of working copies
   <a class="sectionlink" href="#exclusivelocking"