Name: fb126949 Date: 10/08/2003
When calling the open() method without parameters (inherited from interface Line) in an instance of Clip, an IllegalArgumentException is thrown. This behavior has always existed.
However, javadoc of Line.open() states:
This method takes no arguments, and opens the
line with the current settings. For
SourceDataLine and TargetDataLine objects, this
means that the line is opened with default
settings. For a Clip, however, the buffer size
is determined when data is loaded. Since this
method does not allow the application to specify
any data to load, it allocates resources for a
clip with zero frames of data, and there is no
means for subsequently loading data into that
clip. Therefore, you should instead use one of
the open methods provided in the Clip interface
to load data into the Clip.
This is not useful and it was never implemented like that. Therefore the text above should be changed to specify explicitely that IAE is thrown if Clip.open() is called.
checked in bug fix