mirror of
https://github.com/apache/ant.git
synced 2025-05-15 20:45:11 +00:00
PR: 5020 Reported By: jesse.glick@netbeans.com (Jesse Glick) git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@271131 13f79535-47bb-0310-9956-ffa450edef68
72 lines
2.3 KiB
HTML
72 lines
2.3 KiB
HTML
<html>
|
|
|
|
<head>
|
|
<title>Sleep Task</title>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h2><a name="sleep">Sleep</a></h2>
|
|
<h3>Description</h3>
|
|
<p> A task for sleeping a short period of time, useful when a build or deployment
|
|
process requires an interval between tasks.</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">hours</td>
|
|
<td valign="top">hours to to add to the sleep time</td>
|
|
<td valign="top" align="center">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">minutes</td>
|
|
<td valign="top"> minutes to add to the sleep time</td>
|
|
<td valign="top" align="center">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">seconds</td>
|
|
<td valign="top">seconds to add to the sleep time</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">milliseconds</td>
|
|
<td valign="top">milliseconds to add to the sleep time</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top">failonerror</td>
|
|
<td valign="top">flag controlling whether to break the build on an error.
|
|
</td>
|
|
<td align="center" valign="top">No</td>
|
|
</tr>
|
|
</table>
|
|
<p>The sleep time is the sum of specified values, hours, minutes seconds and milliseconds.
|
|
A negative value can be supplied to any of them provided the total sleep time
|
|
is positive</p>
|
|
<p>Note that sleep times are always hints to be interpred by the OS how it feels
|
|
- small times may either be ignored or rounded up to a minimum timeslice. Note
|
|
also that the system clocks often have a fairly low granularity too, which complicates
|
|
measuring how long a sleep actually took.</p>
|
|
<h3>Examples</h3>
|
|
<pre> <sleep milliseconds="10"/></pre>
|
|
Sleep for about 10 mS.
|
|
<pre> <sleep seconds="2"/></pre>
|
|
Sleep for about 2 seconds.
|
|
<pre> <sleep hours="1" minutes="-59" seconds="-58"/></pre>
|
|
<p>Sleep for one hour less 59:58, or two seconds again </p>
|
|
<pre> <sleep /></pre>
|
|
Sleep for no time at all. This may yield the CPU time to another thread or process.
|
|
<hr>
|
|
|
|
<p align="center">Copyright © 2001 Apache Software Foundation. All rights
|
|
Reserved.</p>
|
|
|
|
</body>
|
|
</html>
|
|
|