Gecko [ lorencats.com ]

Name	Size	Permission
antcallback_task.html	4.29 KB	-rw-r--r--
antclipse_task.html	15.34 KB	-rw-r--r--
antfetch_task.html	3.96 KB	-rw-r--r--
assert_task.html	5.78 KB	-rw-r--r--
compilewithwalls.html	6.56 KB	-rw-r--r--
for.html	8.64 KB	-rw-r--r--
foreach.html	5.23 KB	-rw-r--r--
forget.html	1.72 KB	-rw-r--r--
get-cookie_task.html	2.65 KB	-rw-r--r--
get-method_task.html	524 B	-rw-r--r--
head-method_task.html	523 B	-rw-r--r--
http-client_type.html	6.16 KB	-rw-r--r--
http-state_type.html	4.81 KB	-rw-r--r--
if.html	3.24 KB	-rw-r--r--
importurl.html	7.63 KB	-rw-r--r--
index.html	365 B	-rw-r--r--
inifile.html	3.17 KB	-rw-r--r--
limit_task.html	4.42 KB	-rw-r--r--
math_task.html	9.92 KB	-rw-r--r--
method_task_common.html	7.26 KB	-rw-r--r--
more_conditions.html	6.54 KB	-rw-r--r--
osfamily.html	1.07 KB	-rw-r--r--
outofdate.html	10.1 KB	-rw-r--r--
pathtofileset.html	2.46 KB	-rw-r--r--
performance_monitor.html	4.36 KB	-rw-r--r--
post-method_task.html	4.13 KB	-rw-r--r--
post_task.html	7.63 KB	-rw-r--r--
propertycopy.html	2.28 KB	-rw-r--r--
propertyregex.html	4.57 KB	-rw-r--r--
propertyselector.html	4.18 KB	-rw-r--r--
relentless.html	4.6 KB	-rw-r--r--
runtarget.html	834 B	-rw-r--r--
server_tasks.html	8.5 KB	-rw-r--r--
shellscript.html	4.16 KB	-rw-r--r--
sortlist.html	4.78 KB	-rw-r--r--
stopwatch_task.html	2.34 KB	-rw-r--r--
switch.html	2.21 KB	-rw-r--r--
throw.html	1.1 KB	-rw-r--r--
timestampselector.html	4.36 KB	-rw-r--r--
toc.html	3.41 KB	-rw-r--r--
trycatch.html	2.75 KB	-rw-r--r--
urlencode.html	2.47 KB	-rw-r--r--
variable_task.html	6.02 KB	-rw-r--r--
verifydesign.html	14.37 KB	-rw-r--r--
verifylegacytutorial.html	4.34 KB	-rw-r--r--
verifynewprojtutorial.html	1.54 KB	-rw-r--r--

Code Editor : relentless.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 &lt;relentless&gt; task will execute all of the
    nested tasks, regardless of whether one or more of the
    nested tasks fails.  When &lt;relentless&gt; 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
    &lt;relentless&gt; 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 &lt;relentless&gt;.  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>

<p>
    The only nested element supported by &lt;relentless&gt; is a list of tasks
    to be executed.  At least one task must be specified.
    </p>
    <P>
    It is important to note that &lt;relentless&gt; 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 &lt;antcall&gt; 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>&lt;relentless description="The first five canonical variable names."&gt;
    &lt;echo&gt;foo&lt;/echo&gt;
    &lt;echo&gt;bar&lt;/echo&gt;
    &lt;echo&gt;baz&lt;/echo&gt;
    &lt;echo&gt;bat&lt;/echo&gt;
    &lt;echo&gt;blah&lt;/echo&gt;
&lt;/relentless&gt;</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>    &lt;relentless terse="true" description="The first five canonical variable names."/&gt;</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>&lt;relentless terse="true" description="The first five canonical variable names."&gt;
    &lt;echo&gt;foo&lt;/echo&gt;
    &lt;echo&gt;bar&lt;/echo&gt;
    &lt;fail&gt;baz&lt;/fail&gt;
    &lt;echo&gt;bat&lt;/echo&gt;
    &lt;echo&gt;blah&lt;/echo&gt;
&lt;/relentless&gt;</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 &copy; 2005 Ant-Contrib Project. All
    rights Reserved.</p>

</body>
</html>

${this.title}

Code Editor : relentless.html