ataLine.Info.getFormats() should document NOT_SPECIFIED


DataLine.Info.getFormats() returns an array of audio formats that are supported by the data line. However, some lines support a very wide range or any value for some parameters of the audio format, like lines that support any sample rate from 10Hz to 200KHz. In such cases, the current implementation sets the respective parameter (and the dependent parameters, if any) to AudioSystem.NOT_SPECIFIED. 

The method's documentation should mention that fields in the audio format may be set to NOT_SPECIFIED and what it means.

In the long run, a consistent concept for specifying ranges should be added to the Java Sound API.


======================================================================
 xxxxx@xxxxx  2003-11-03
checked in fix

N/A

 xxxxx@xxxxx  2003-08-26
	Fixing this helps reducing the confusion among developers where and when AudioSystem.NOT_SPECIFIED can be used.