<AWT Dev>  Review request for 8003965: Toolkit.beep() documentation is ambiguous
anthony.petrov at oracle.com
Thu Aug 29 05:03:03 PDT 2013
I believe that a javadoc shouldn't mention any particular native APIs
used to implement a particular functionality, because:
1. There are many more platforms where Java runs, and they also may
implement the beep() method.
2. In the future we may need to change the underlying implementation,
and we certainly don't want to also change the javadoc to describe the
Hence, I suggest to only state something like the following:
"Tells the native system to emit a beep. Emitting depends on system
settings and hardware capabilities."
On 08/29/13 14:52, Oleg Pekhovskiy wrote:
> Hi all,
> please review the fix for JDK-8003965 (not available on bugs.sun.com):
> It's just a Javadoc fix.
More information about the awt-dev