diff --git a/docs/index.html b/docs/index.html index 7eeea1662..f236ec0e0 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4263,6 +4263,11 @@ must use a nested <replacetoken> element.

("") is used. No + + propertyFile + valid property file from which properties specified using nested <replacefilter> elements are drawn. + Yes only if property attribute of <replacefilter> is used. + includes comma separated list of patterns of files that must be @@ -4307,7 +4312,7 @@ nested <include>, <exclude> and cross line boundaries, you can use nested elements to specify them.

Examples

-
  
+
 <replace dir="${src}" value="wombat">
   <include name="**/*.html"/>
   <replacetoken><![CDATA[multi line
@@ -4318,7 +4323,7 @@ token]]></replacetoken>
 line\ntoken" with the string "wombat", in all
 HTML files in the directory ${src}.Where \n is
 the platform specific line separator.

-
  
+
 <replace file="${src}/index.html">
   <replacetoken><![CDATA[two line
 token]]></replacetoken>
@@ -4326,6 +4331,51 @@ token]]></replacetoken>
 token]]></replacevalue>
 </replace>
 

+
replacefilter

+
In addition to allowing for multiple replacements, optional nested <replacefilter> elements allow replacement values to be extracted from a property file. The name of this file is specified using the <replace> attribute propertyFile.
+

+
+  
+    
+    
+    
+  
+  
+    
+    
+    
+  
+  
+    
+    
+    
+  
+  
+    
+    
+  
+
AttributeDescriptionRequired
tokenThe string to search for.Yes
valueThe replacement string.Either may be specified, but not both. Both can be omitted, if desired.
propertyName of the property whose value is to serve as the replacement value.

+
If neither value nor property is used, the value provided using the <replace> attribute value and/or the <replacevalue> element is used. If no value was specified using either of these options, the token is replaced with an empty string.
+

+
Examples

+
+<replace 
+    file="configure.sh"
+    value="defaultvalue"
+    propertyFile="source/name.properties" >
+  <replacefilter 
+    token="@token1@" />
+  <replacefilter 
+    token="@token2@" 
+    value="value2"/>
+  <replacefilter 
+    token="@token3@" 
+    property="property.key"/>
+</replace>
+

+
In file configure.sh, replace all instances of "@token1@" with "defaultvalue", all instances of "@token2@" with "value2", and all instances of "@token3@" with the value of the property "property.key", as it appears in property file src/name.properties.

+
Note: It is possible to use either the token/<replacetoken> and value/<replacevalue> attributes/elements, the nested replacefilter elements, or both in the same operation.
+

 

 
Rmic

 
Description