javadocs clarification: JRootPane.setGlassPane() has undocumented, unobvious behavior

There is an order dependency on calling setGlassPane() and setVisible() that should be documented in the javadocs for JRootPane.setGlassPane().

The following code:
    myGlassPane.setVisible(true);
    frame.setGlassPane(myGlassPane);
results in ... nothing. But this:
    frame.setGlassPane(myGlassPane);
    myGlassPane.setVisible(true);
does as expected (assuming the glass pane has anything to display).

The behavior in the method is that the visibility of the new glass pane is based on the visibility of the previous glass pane. Given that implicit and unobvious behavior, we should doc this.
###@###.### 11/2/04 22:20 GMT