ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From k...@apache.org
Subject svn commit: r539309 - /ant/core/trunk/docs/manual/CoreTasks/retry.html
Date Fri, 18 May 2007 08:25:33 GMT
Author: kevj
Date: Fri May 18 01:25:32 2007
New Revision: 539309

URL: http://svn.apache.org/viewvc?view=rev&rev=539309
Log:
-retry task container

Added:
    ant/core/trunk/docs/manual/CoreTasks/retry.html

Added: ant/core/trunk/docs/manual/CoreTasks/retry.html
URL: http://svn.apache.org/viewvc/ant/core/trunk/docs/manual/CoreTasks/retry.html?view=auto&rev=539309
==============================================================================
--- ant/core/trunk/docs/manual/CoreTasks/retry.html (added)
+++ ant/core/trunk/docs/manual/CoreTasks/retry.html Fri May 18 01:25:32 2007
@@ -0,0 +1,56 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+<html>
+
+<head>
+<meta http-equiv="Content-Language" content="en-us">
+<link rel="stylesheet" type="text/css" href="../stylesheets/style.css">
+<title>Retry Task</title>
+</head>
+<body>
+<h2>Retry</h2>
+<h3>Description</h3>
+<p>Retry is a container task - it can contain an Ant task. The nested 
+task is executed, if an error occurs, the task can be executed again without
+the build failing.  The amount of times that the nested task can be 'retried'
+is configurable.</p>
+
+<h3>Parameters</h3>
+<table border="1" cellpadding="2" cellspacing="0">
+  <tr> 
+    <td valign="top"><b>Attribute</b></td>
+    <td valign="top"><b>Description</b></td>
+    <td align="center" valign="top"><b>Required</b></td>
+  </tr>
+  <tr> 
+    <td valign="top">retrycount</td>
+    <td valign="top">number of times to attempt to execute the nested task</td>
+    <td valign="top" align="center">Yes</td>
+  </tr>
+</table>
+<p>Any valid Ant task may be embedded within the retry task.</p>
+
+<h3>Example</h3>
+<pre>
+&lt;retry retrycount="3"&gt;
+  &lt;get src="http://www.unreliable-server.com/unreliable.tar.gz" 
+  		dest="/home/retry/unreliable.tar.gz"/&gt;
+&lt;/retry&gt;
+</pre>
+<p>This example shows how to use <code>&lt;retry&gt;</code> to
wrap a task which must interact with an unreliable network resource.</p>
+</body>
+</html>
\ No newline at end of file



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message