From af19716815d8b49360ae553422ae502e13cbb73d Mon Sep 17 00:00:00 2001 From: "Jesse N. Glick" Date: Tue, 24 May 2011 18:41:18 +0000 Subject: [PATCH] PR 51213: anchors. git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@1127211 13f79535-47bb-0310-9956-ffa450edef68 --- manual/Tasks/conditions.html | 72 +++++++++++++++++++----------------- 1 file changed, 38 insertions(+), 34 deletions(-) diff --git a/manual/Tasks/conditions.html b/manual/Tasks/conditions.html index 8d6b2a9c8..1c9be84c7 100644 --- a/manual/Tasks/conditions.html +++ b/manual/Tasks/conditions.html @@ -40,13 +40,13 @@ <condition> and <waitfor> tasks.

-

not

+

not

The <not> element expects exactly one other condition to be nested into this element, negating the result of the condition. It doesn't have any attributes and accepts all nested elements of the condition task as nested elements as well.

-

and

+

and

The <and> element doesn't have any attributes and accepts an arbitrary number of conditions as nested elements - all nested elements of the condition task are supported. This condition @@ -56,7 +56,7 @@ evaluated in the order they have been specified in the build file.

semantics as the Java && operator, as soon as one of the nested conditions is false, no other condition will be evaluated.

-

or

+

or

The <or> element doesn't have any attributes and accepts an arbitrary number of conditions as nested elements - all nested elements of the condition task are supported. This condition @@ -66,7 +66,7 @@ file.

The <or> condition has the same shortcut semantics as the Java || operator, as soon as one of the nested conditions is true, no other condition will be evaluated.

-

xor

+

xor

The <xor> element performs an exclusive or on all nested elements, similar to the ^ operator in Java. It only evaluates to true if an odd number of nested conditions @@ -75,19 +75,19 @@ and <or> tests. It doesn't have any attributes and accepts all nested elements of the condition task as nested elements as well.

-

available

+

available

This condition is identical to the Available task, all attributes and nested elements of that task are supported, the property and value attributes are redundant and will be ignored.

-

uptodate

+

uptodate

This condition is identical to the Uptodate task, all attributes and nested elements of that task are supported, the property and value attributes are redundant and will be ignored.

-

os

 +

os

Test whether the current operating system is of a given type. Each defined attribute is tested and the result is true only if all the tests succeed. @@ -137,7 +137,7 @@ the tests succeed.

  • openvms for OpenVMS
    • -

    equals

    +

    equals

    Tests whether the two given values are equal.

    @@ -176,7 +176,7 @@ the tests succeed.
    -

    isset

    +

    isset

    Test whether a given property has been set in this project.

    @@ -191,13 +191,13 @@ the tests succeed.
    -

    checksum

    +

    checksum

    This condition is identical to the Checksum task, all attributes and nested elements of that task are supported, the property and overwrite attributes are redundant and will be ignored.

    -

    http

    +

    http

    The http condition checks for a valid response from a web server of the specified url. By default, HTTP responses errors of 400 or greater are viewed as invalid.

    @@ -231,7 +231,7 @@ of 400 or greater are viewed as invalid.

    -

    socket

    +

    socket

    The socket condition checks for the existence of a TCP/IP listener at the specified host and port.

    @@ -252,7 +252,7 @@ TCP/IP listener at the specified host and port.

    -

    filesmatch

    +

    filesmatch

    Test two files for matching. Nonexistence of one file results in "false", although if neither exists they are considered equal in terms of content. This test does a byte for byte comparision, so test time scales with @@ -286,7 +286,7 @@ or the filenames match the answer is so obvious the detailed test is omitted. -

    contains

    +

    contains

    Tests whether a string contains another one.

    @@ -312,7 +312,7 @@ or the filenames match the answer is so obvious the detailed test is omitted.
    -

    istrue

    +

    istrue

    Tests whether a string equals any of the ant definitions of true, that is "true","yes", or "on"

    @@ -332,7 +332,7 @@ that is "true","yes", or "on"

    <istrue value="false"/> -

    isfalse

    +

    isfalse

    Tests whether a string is not true, the negation of <istrue>

    @@ -352,7 +352,7 @@ that is "true","yes", or "on"

    <isfalse value="false"/> -

    isreference

    +

    isreference

    Test whether a given reference has been defined in this project and - optionally - is of an expected type.

    @@ -377,7 +377,8 @@ that is "true","yes", or "on"

    No
    -

    issigned

    + +

    issigned

    Test whether a jarfile is signed. If the name of the @@ -409,7 +410,8 @@ that is "true","yes", or "on"

    No -

    isfileselected

    + +

    isfileselected

    Test whether a file passes an embedded selector. @@ -445,7 +447,8 @@ that is "true","yes", or "on"

    <date datetime="06/28/2000 2:02 pm" when="equal"/> </isfileselected> -

    typefound

    + +

    typefound

    Test whether a given type is defined, and that its implementation class can be loaded. Types include @@ -481,7 +484,7 @@ tasks, datatypes, scriptdefs, macrodefs and presetdefs.

    <typefound uri="antlib:org.apache.maven.artifact.ant" name="artifact"/> -

    scriptcondition

    +

    scriptcondition

    Evaluate a condition based on a script in any Apache BSF @@ -573,7 +576,7 @@ Example: Sets the default value of the condition to true, then in the script, sets the value to false. This condition always evaluates to "false" -

    parsersupports

    +

    parsersupports

    Tests whether Ant's XML parser supports a given feature or property, as per the SAX/JAXP specifications, by @@ -627,7 +630,7 @@ Check for XML Schema support. Check for Xerces-specific definition of the location of the no namespace schema. -

    isreachable

    +

    isreachable

    Uses Java1.5+ networking APIs to probe for a (remote) system being reachable. Exactly what probe mechanisms are used is an implementation @@ -700,7 +703,7 @@ Probe for the maven repository being reachable. Probe for the maven repository being reachable using the hostname, ten second timeout..

    -

    length

    +

    length

    This condition is a facet of the Length task. It is used to test the length of a string or one or more files. Since Ant 1.6.3 @@ -716,7 +719,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti

    Verify that file foo is not empty.

    -

    isfailure

    +

    isfailure

    Test the return code of an executable (see the Exec task) for failure. Since Ant 1.7

    @@ -734,7 +737,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti -

    resourcecount

    +

    resourcecount

    This condition is a facet of the ResourceCount task. It is used to test the size of a @@ -747,7 +750,7 @@ Probe for the maven repository being reachable using the hostname, ten second ti

    Verify that a resource collection is not empty.

    -

    resourcesmatch

    +

    resourcesmatch

    Test resources for matching. Nonexistence of one or more resources results in "false", although if none exists they are considered equal in terms of content. By default this test does a byte for byte comparision, so test time scales with @@ -774,7 +777,7 @@ must match. Since Ant 1.7 -

    resourcecontains

    +

    resourcecontains

    Tests whether a resource contains a given (sub)string.

    The resources to check are specified via references or - in the case of file resources via the resource attribute. Since Ant 1.7.1 @@ -808,7 +811,7 @@ must match. Since Ant 1.7 -

    hasmethod

    +

    hasmethod

    Tests for a class having a method or field. If the class is not found or fails to load, the build fails. @@ -865,7 +868,7 @@ must match. Since Ant 1.7

    Looks for the method trimToSize in the ArrayList class.

    -

    matches

    +

    matches

    Test if the specified string matches the specified regular @@ -970,13 +973,14 @@ must match. Since Ant 1.7 singleline="false"/> </au:assertFalse> -

    antversion

    + +

    antversion

    This condition is identical to the Antversion task, all attributes are supported, the property attribute is redundant and will be ignored.

    -

    hasfreespace

    +

    hasfreespace

    Tests a partition to see if there is enough space. @@ -1015,7 +1019,7 @@ is redundant and will be ignored.

    <hasfreespace partition="c:" needed="100M"/> -

    islastmodified

    +

    islastmodified

    Tests the last modified date of a resource. Since Ant 1.8.0

    @@ -1065,7 +1069,7 @@ is redundant and will be ignored.

    </islastmodified> -

    resourceexists

    +

    resourceexists

    Tests a resource for existance. since Ant 1.8.0