@@ -19,12 +19,31 @@ for sound-files, so be sure you only have sound-files in the
directory you specify.</p>
<h3>Parameters</h3>
<p>(none)</p>
<h3>Nested Elements</h3>
<h4>success</h4>
<p>Specifies the sound to be played if the build succeeded.</p>
<h4>fail</h4>
<p>Specifies the sound to be played if the build failed.</p>
<h3>Nested Element Parameters</h3>
<p>
The following attributes may be used on the <code><success></code>
and <code><fail></code> elements:</p>
<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">source</td>
<td valign="top">the path to a sound-file directory, or the name of a
specific sound-file, to be played.
</td>
<td valign="top" align="center">Yes</td>
</tr>
<tr>
<td valign="top">loops</td>
<td valign="top">the number of extra times to play the sound-file;
@@ -40,26 +59,14 @@ directory you specify.</p>
<td valign="top" align="center">No</td>
</tr>
</table>
<p>
To specify the sound-files or the sound-file directories, use the
nested <code><success></code> and <code><fail></code>
elements:</p>
<blockquote>
<pre>
<success> the path to a sound-file directory, or the name of a
specific sound-file, to be played if the build succeeded.
<fail> the path to a sound-file directory, or the name of a
specific sound-file, to be played if the build succeeded.
</pre>
</blockquote>
<h3>Examples</h3>
<blockquote>
<pre>
<target name="fun" if="fun" unless="fun.done">
<sound loops="2" >
<sound>
<success source="${user.home}/sounds/bell.wav"/>
<fail source="${user.home}/sounds/ohno.wav"/>
<fail source="${user.home}/sounds/ohno.wav" loops="2"/>
</sound>
<property name="fun.done" value="true"/>
</target>