The documentation of java.applet.AudioClip on http://java.sun.com/j2se/1.5.0/docs/api/ needs to "suggest" applet developers to migrate from java.applet.AudioClip to javax.sound.sampled. java.applet.AudioClip is rudimentary, lacked many necessary functionalities, and caused many bugs and escalations. The javax.sound.sampled.* package has all functionalities of java.applet.AudioClip, and it can completely replace the package and resolve many problems that caused by java.applet.AudioClip.

We should also include some sample codes of javax.sound.sampled.* for developers on http://java.sun.com/products/java-media/sound/index.jsp and http://java.sun.com/j2se/1.5.0/docs/api/