You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ant.apache.org by ke...@apache.org on 2007/05/18 10:25:33 UTC
svn commit: r539309 - /ant/core/trunk/docs/manual/CoreTasks/retry.html
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>
+<retry retrycount="3">
+ <get src="http://www.unreliable-server.com/unreliable.tar.gz"
+ dest="/home/retry/unreliable.tar.gz"/>
+</retry>
+</pre>
+<p>This example shows how to use <code><retry></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