The standard javadocs for EventQueue show that the full API for getNextEvent() is
public final boolean getNextEvent(Event event)
With nothing about what it actually does, what the argument is, when it returns true, etc.
I take it from the sample code that turns true when there is the queue is not empty, and when it is going to return true, it modifies the argument "event" to contain the event at the top of the queue.
If this is a correct guess, I'm more than willing to change the source to improve the javadoc.
Is this guess correct?
And if so, how to I submit a patch? or to who?
BTW, I'm not a fan of the API's design, which is more of a C-idiom than a standard Java one. Usually in Java, you return the entry in the queue, and if its non-blocking, you would return a null.