Exits the current build (just throwing a BuildException), optionally printing additional information.
The message of the Exception can be set via the message attribute or character data nested into the element.
| Attribute | Description | Required |
| message | A message giving further information on why the build exited | No |
| if | Only fail if a property of the given name exists in the current project | No |
| unless | Only fail if a property of the given name doesn't exist in the current project | No |
<fail/>
will exit the current build with no further information given.
BUILD FAILED build.xml:4: No message
<fail message="Something wrong here."/>
will exit the current build and print something like the following to wherever your output goes:
BUILD FAILED build.xml:4: Something wrong here.
<fail>Something wrong here.</fail>
will give the same result as above.
Copyright © 2000-2001,2004 The Apache Software Foundation. All rights Reserved.