From 0d89047e67e3e5d4c8354b2a6a4421532a8a7d4c Mon Sep 17 00:00:00 2001
From: Jan Materne <jhm@apache.org>
Date: Fri, 11 Jan 2008 08:24:55 +0000
Subject: [PATCH] Found some information about <sound> in my local storage
 which should be in the manual.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@611103 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/OptionalTasks/sound.html | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/manual/OptionalTasks/sound.html b/docs/manual/OptionalTasks/sound.html
index 648c1759d..1095f80cf 100644
--- a/docs/manual/OptionalTasks/sound.html
+++ b/docs/manual/OptionalTasks/sound.html
@@ -34,6 +34,9 @@ Note: At this point, the random selection is based on all the files
 in the directory, not just those ending in appropriate suffixes
 for sound-files, so be sure you only have sound-files in the 
 directory you specify.</p>
+<p>More precisely <code>&lt;sound&gt;</code> registers a hook that is
+triggered when the build finishes. Therefore you have to place this
+task as top level or inside a target which is always executed.</p>
 <p>
 Unless you are running on Java 1.3 or later, you need the Java Media Framework
 on the classpath (javax.sound). 
@@ -59,7 +62,8 @@ and <code>&lt;fail&gt;</code> elements:</p>
   <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.
+specific sound-file, to be played. If this file does not exist, an error message
+will be logged.
     </td>
     <td valign="top" align="center">Yes</td>
   </tr>