From 753a6c60f47f3ac4f270005b65e9d6481de8eb68 Mon Sep 17 00:00:00 2001 From: Ashlee Young Date: Fri, 23 Oct 2015 10:00:02 -0700 Subject: Adding maven and ant source trees Change-Id: I0a39b9add833a31b9c3f98d193983ae2f3a5a445 Signed-off-by: Ashlee Young --- .../manual/Tasks/echoproperties.html | 146 +++++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html (limited to 'framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html') diff --git a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html new file mode 100644 index 00000000..ec1e4b44 --- /dev/null +++ b/framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html @@ -0,0 +1,146 @@ + + + + + + +Echoproperties Task + + + + +

echoproperties

+

Description

+ +

Displays all the current properties (or a subset of them specified +by a nested <propertyset>) in the project. The +output can be sent to a file if desired. This task can be used as a +somewhat contrived means of returning data from an +<ant> invocation, but is really for debugging build +files.

+ +

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
AttributeDescriptionRequired
destfileIf specified, the value indicates the name of the + file to send the output of the statement to. The generated output file + is compatible for loading by any Java application as a property file. + If not specified, then the output will go to the Apache Ant log.No
prefix + a prefix which is used to filter the properties + only those properties starting with this prefix will be echoed. +

+

No
regex + a regular expression which is used to filter the + properties + only those properties whose names match it will be echoed. + No
failonerrorBy default, the "failonerror" attribute is enabled. + If an error occurs while writing the properties to a file, and this + attribute is enabled, then a BuildException will be thrown, causing the + build to fail. If disabled, then IO errors will be reported as a log + statement, and the build will continue without failure from this task.No
formatOne of text or xml. + Determines the output format. Defaults to text.No
+ +

Parameters specified as nested elements

+ +

propertyset

+ +

You can specify subsets of properties to be echoed with propertysets. Using +propertysets gives more control on which properties will be +picked up. The attributes prefix and regex are just +shortcuts that use propertysets internally. +

+ +

since Ant 1.6.

+ +

Examples

+
+  <echoproperties/>
+
+

Report the current properties to the log.

+
+  <echoproperties destfile="my.properties"/>
+
+

Report the current properties to the file "my.properties", and will +fail the build if the file could not be created or written to.

+
+  <echoproperties destfile="my.properties" failonerror="false"/>
+
+

Report the current properties to the file "my.properties", and will +log a message if the file could not be created or written to, but will still +allow the build to continue.

+
+  <echoproperties prefix="java."/>
+
+

List all properties beginning with "java."

+
+  <echoproperties>
+    <propertyset>
+      <propertyref prefix="java."/>
+    </propertyset>
+  </echoproperties>
+
+

This again lists all properties beginning with "java." using a nested +</propertyset> which is an equivalent but longer way.

+
+  <echoproperties regex=".*ant.*"/>
+
+

Lists all properties that contain "ant" in their names. +The equivalent snippet with </propertyset> is:

+
+  <echoproperties>
+    <propertyset>
+      <propertyref regex=".*ant.*"/>
+    </propertyset>
+  </echoproperties>
+
+ + + + + + -- cgit 1.2.3-korg