svn commit: r1538046 - in /ant/site/ant/production/manual: ./ Types/filterchain.html

[bo...@apache.org]

Author: bodewig
Date: Fri Nov  1 20:05:07 2013
New Revision: 1538046

URL: http://svn.apache.org/r1538046
Log:
merge documentation patch for issue 42702

Modified:
    ant/site/ant/production/manual/   (props changed)
    ant/site/ant/production/manual/Types/filterchain.html

Propchange: ant/site/ant/production/manual/
------------------------------------------------------------------------------
  Merged /ant/core/trunk/manual:r1538045

Modified: ant/site/ant/production/manual/Types/filterchain.html
URL: http://svn.apache.org/viewvc/ant/site/ant/production/manual/Types/filterchain.html?rev=1538046&r1=1538045&r2=1538046&view=diff
==============================================================================
--- ant/site/ant/production/manual/Types/filterchain.html (original)
+++ ant/site/ant/production/manual/Types/filterchain.html Fri Nov  1 20:05:07 2013
@@ -575,6 +575,15 @@ user defined values.
     <td vAlign=top align="center">No</td>
   </tr>
   <tr>
+    <td vAlign=top>Not applicable.</td>
+    <td vAlign=top>propertiesResource</td>
+    <td vAlign=top>Properties resource to take tokens from.
+      Note this only works is you use the
+      "convenience" <code>&lt;replacetokens&gt;</code> syntax.
+      <em>since Ant 1.8.0</em></td>
+    <td vAlign=top align="center">No</td>
+  </tr>
+  <tr>
     <td vAlign=top>User defined String.</td>
     <td vAlign=top>value</td>
     <td vAlign=top>Replace-value for the token</td>
@@ -626,7 +635,19 @@ This will treat each properties file ent
     &lt;/filterreader&gt;
   &lt;/filterchain&gt;
 &lt;/loadfile&gt;
-&lt;/filterchain&gt;
+</pre></blockquote>
+
+This reads the properties from an Ant resource referenced by its id:
+<blockquote><pre>
+&lt;string id=&quot;embedded-properties&quot;&gt;
+foo=bar
+baz=xyzzy
+&lt;/string&gt;
+&lt;loadfile srcfile=&quot;${src.file}&quot; property=&quot;${src.file.replaced}&quot;&gt;
+  &lt;filterchain&gt;
+    &lt;replacetokens propertiesResource=&quot;${ant.refid:embedded-properties}&quot;/&gt;
+  &lt;/filterchain&gt;
+&lt;/loadfile&gt;
 </pre></blockquote>
 
 <h3><a name="stripjavacomments">StripJavaComments</a></h3>