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

[stsp]

Author: stsp
Date: Fri Apr 12 14:43:33 2013
New Revision: 1467289

URL: http://svn.apache.org/r1467289
Log:
* site/publish/docs/release-notes/1.8.html: Document keyword expansion
   enhancements (server-side keywords and custom keywords).

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=1467289&r1=1467288&r2=1467289&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.8.html (original)
+++ subversion/site/publish/docs/release-notes/1.8.html Fri Apr 12 14:43:33 2013
@@ -1674,6 +1674,93 @@ author <tt>james</tt> in September 2012:
 
 </div>  <!-- cmdline -->
 
+<div class="h3" id="keywords">
+<h3>Keyword-expansion improvements
+  <a class="sectionlink" href="#keywords"
+    title="Link to this section">&para;</a>
+</h3>
+
+<div class="h4" id="server-side-keywords">
+<h4>Server-side keyword expansion
+  <a class="sectionlink" href="#server-side-keywords"
+    title="Link to this section">&para;</a>
+</h4>
+
+<p><tt>mod_dav_svn</tt> can now expand keywords in files obtained from
+the server with a GET request. To enable keyword expansion, append
+&quot;?kw=1&quot; to the file's URL, like this:
+<a href="http://svn.apache.org/repos/asf/subversion/trunk/README?kw=1";
+>http://svn.apache.org/repos/asf/subversion/trunk/README?kw=1</a>
+</p>
+
+</div> <!-- server-side-keywords -->
+
+<div class="h4" id="custom-keywords">
+<h4>Custom keyword definitions
+  <a class="sectionlink" href="#custom-keywords"
+    title="Link to this section">&para;</a>
+</h4>
+
+<p>Subversion now supports the definition of custom keywords, which can be
+defined using a special syntax within the <tt>svn:keywords</tt> property.</p>
+
+<p>For example, <tt>MyKeyword=%r%_%a%_%P</tt> defines a keyword called
+&quot;MyKeyword&quot; which contains the number of the last-changed
+revision, the author of that revision, and the file's path in the
+repository, each separated by one space character.
+Once a custom keyword has been defined it can be used within the
+file like any other keyword: <tt>$MyKeyword$</tt>.</p>
+
+<p>The <tt>svn help propset</tt> command lists the known format codes
+which can be used in custom keyword definitions, which are also shown
+in the table below.</p>
+
+<table border="1">
+<tr>
+  <td>%a</td><td>The author of the revision given by %r.</td>
+</tr>
+<tr>
+  <td>%b</td><td>The basename of the URL of the file.</td>
+</tr>
+<tr>
+  <td>%d</td><td>Short format of the date of the revision given by %r.</td>
+</tr>
+<tr>
+  <td>%D</td><td>Long format of the date of the revision given by %r.</td>
+</tr>
+<tr>
+  <td>%P</td><td>The file's path, relative to the repository root.</td>
+</tr>
+<tr>
+  <td>%r</td><td>The number of the revision which last changed the file.</td>
+</tr>
+<tr>
+  <td>%R</td><td>The URL to the root of the repository.</td>
+</tr>
+<tr>
+  <td>%u</td><td>The URL of the file.</td>
+</tr>
+<tr>
+  <td>%_</td><td>A space (keyword definitions cannot contain a literal 
space).</td>
+</tr>
+<tr>
+  <td>%%</td><td>A literal '%'.</td>
+</tr>
+<tr>
+  <td>%H</td><td>Equivalent to %P%_%r%_%d%_%a.</td>
+</tr>
+<tr>
+  <td>%I</td><td>Equivalent to %b%_%r%_%d%_%a.</td>
+</tr>
+</table>
+
+<p>Note that keywords are not expanded if they exceed 255 bytes in length,
+either in expanded or unexpanded form.</p>
+
+</div> <!-- custom-keywords -->
+
+</div> <!-- keywords -->
+
 <div class="h3" id="apis">
 <h3>API changes, improvements and language bindings
     (<em>client and server</em>)