From 5e36d6068b788f5b15d1cebe6909295620541255 Mon Sep 17 00:00:00 2001
From: Stefan Bodewig <bodewig@apache.org>
Date: Fri, 1 Nov 2013 20:02:08 +0000
Subject: [PATCH] PR 42702 - document replacetoken's support for resources,
 which was added in 1.8.0

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@1538045 13f79535-47bb-0310-9956-ffa450edef68
---
 manual/Types/filterchain.html | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/manual/Types/filterchain.html b/manual/Types/filterchain.html
index 3f62286d0..b7c95a189 100644
--- a/manual/Types/filterchain.html
+++ b/manual/Types/filterchain.html
@@ -574,6 +574,15 @@ user defined values.
     <td vAlign=top>Properties file to take tokens from.</td>
     <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>
@@ -626,7 +635,19 @@ This will treat each properties file entry in sample.properties as a token/key p
     &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>