Echoproperties Task

From b9421dc80af485591a9c50cc8921f912e0def11e Mon Sep 17 00:00:00 2001 From: Ashlee Young Date: Fri, 23 Oct 2015 10:05:40 -0700 Subject: Removing sources to replace with download links instead. Change-Id: Ie28789a725051aec0d1b04dd291b7690a7898668 Signed-off-by: Ashlee Young --- .../manual/Tasks/echoproperties.html | 146 --------------------- 1 file changed, 146 deletions(-) delete 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 deleted file mode 100644 index ec1e4b44..00000000 --- a/framework/src/ant/apache-ant-1.9.6/manual/Tasks/echoproperties.html +++ /dev/null @@ -1,146 +0,0 @@ - - - - - - -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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Attribute	Description	Required
destfile	If 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
failonerror	By 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
format	One 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