mirror of
https://github.com/overcuriousity/autopsy-flatpak.git
synced 2025-07-08 22:29:33 +00:00
142 lines
4.6 KiB
HTML
142 lines
4.6 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>Ant-contrib Tasks: Relentless</title>
|
|
</head>
|
|
|
|
<body>
|
|
<h1>Relentless</h1>
|
|
|
|
<p>The <relentless> task will execute all of the
|
|
nested tasks, regardless of whether one or more of the
|
|
nested tasks fails. When <relentless> has completed
|
|
executing the nested tasks, it will either
|
|
<ul>
|
|
<li>fail, if any one or more of the nested tasks failed; or
|
|
<li>succeed, if all of the nested tasks succeeded.
|
|
</ul>
|
|
An appropriate message will be written to the log.
|
|
</p>
|
|
<P>
|
|
Tasks are executed in the order that they appear within the
|
|
<relentless> task. It is up to the user to ensure that
|
|
relentless execution of the
|
|
nested tasks is safe.
|
|
</p>
|
|
<p><em>
|
|
This task only works for ant version greater than or equal
|
|
to ant 1.6.0.
|
|
</em>
|
|
</p>
|
|
|
|
<h2>Parameters</h2>
|
|
<table border="1" cellpadding="2" cellspacing="0">
|
|
<tr>
|
|
<th>Attribute</th>
|
|
<th>Description</th>
|
|
<th>Required</th>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">description</td>
|
|
<td valign="top">A string that will be included in the log output. This
|
|
can be useful for helping to identify sections of large Ant builds.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">terse</td>
|
|
<td valign="top">Setting this to <code>true</code> will eliminate some of the progress
|
|
output generated by <relentless>. This can reduce clutter in some
|
|
cases. The default value is <code>false</code>.</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<h2>Nested elements</h2>
|
|
|
|
<h3>task list</h3>
|
|
|
|
<p>
|
|
The only nested element supported by <relentless> is a list of tasks
|
|
to be executed. At least one task must be specified.
|
|
</p>
|
|
<P>
|
|
It is important to note that <relentless> only proceeds relentlessly
|
|
from one task to the next - it does <b>not</b> apply recursively to any tasks
|
|
that might be invoked by these
|
|
nested tasks. If a nested task invokes some other list of tasks (perhaps
|
|
by <antcall> for example), and one of those other tasks fails, then the
|
|
nested task will stop at that point.
|
|
</p>
|
|
|
|
<h3>Example</h3>
|
|
<p>
|
|
A relentless task to print out the first five canonical variable names:
|
|
<blockquote>
|
|
<pre><relentless description="The first five canonical variable names.">
|
|
<echo>foo</echo>
|
|
<echo>bar</echo>
|
|
<echo>baz</echo>
|
|
<echo>bat</echo>
|
|
<echo>blah</echo>
|
|
</relentless></pre>
|
|
</blockquote>
|
|
which should produce output looking more or less like
|
|
<blockquote>
|
|
<pre>[relentless] Relentlessly executing: The first five canonical variable names.
|
|
[relentless] Executing: task 1
|
|
[echo] foo
|
|
[relentless] Executing: task 2
|
|
[echo] bar
|
|
[relentless] Executing: task 3
|
|
[echo] baz
|
|
[relentless] Executing: task 4
|
|
[echo] bat
|
|
[relentless] Executing: task 5
|
|
[echo] blah
|
|
[relentless] All tasks completed successfully.</pre>
|
|
</blockquote>
|
|
</p>
|
|
If you change the first line to set the <code>terse</code> parameter,
|
|
<pre> <relentless terse="true" description="The first five canonical variable names."/></pre>the
|
|
output will look more like this:
|
|
<blockquote>
|
|
<pre>[relentless] Relentlessly executing: The first five canonical variable names.
|
|
[echo] foo
|
|
[echo] bar
|
|
[echo] baz
|
|
[echo] bat
|
|
[echo] blah
|
|
[relentless] All tasks completed successfully.</pre>
|
|
</blockquote>
|
|
</p>
|
|
<p>
|
|
If we change the third task to deliberately fail
|
|
<blockquote>
|
|
<pre><relentless terse="true" description="The first five canonical variable names.">
|
|
<echo>foo</echo>
|
|
<echo>bar</echo>
|
|
<fail>baz</fail>
|
|
<echo>bat</echo>
|
|
<echo>blah</echo>
|
|
</relentless></pre>
|
|
</blockquote>
|
|
then the output should look something like this.
|
|
<blockquote>
|
|
<pre>[relentless] Relentlessly executing: The first five canonical variable names.
|
|
[echo] foo
|
|
[echo] bar
|
|
[relentless] Task task 3 failed: baz
|
|
[echo] bat
|
|
[echo] blah
|
|
|
|
BUILD FAILED
|
|
/home/richter/firmware/sensor/build.xml:1177: Relentless execution: 1 of 5 tasks failed.</pre>
|
|
</blockquote>
|
|
</p>
|
|
<hr>
|
|
<p align="center">Copyright © 2005 Ant-Contrib Project. All
|
|
rights Reserved.</p>
|
|
|
|
</body>
|
|
</html>
|