This request for improved documentation is from a customer
(see radiance case 64550412, escalation 1-8624157).


Detailed Problem Description:
-----------------------------

The docs for JComponent.setComponentPopupMenu() states "The UI is responsible fo
r registering bindings and adding the necessary listeners such that the JPopupMe
nu will be shown at the appropriate time".
 
This method is new in JDK 1.5, and it is supposed to make popup menus easier to
program, with behaviour consistent with the L&F. The expectation is calling setC
omponentPopupMenu() on a JPanel would make the panel show a popup. To say that e
xpected behaviour is a programmer should guess that an empty mouse listener also
 needs to be added to the panel does not make sense.
 
At a minimum the documentation needs to improved.

see attached test case.

Initial evaluation by CFE/PTS
------------------------------
>I looked into the source code. You are adding the mouselistner to
>one of the panels and that is the reason you are seeing the popup
>on where ever you clicking on that panel. But for the second panel
>you have not added the mouselistner and by default mouselistner is
>added to the button and that is the reason in the second panel you
>are seeing the popup only when clicks over the button.
>This is the expected behaviour.

This can be verified by adding the following debug statements:

    MouseListener[] m;
    m = buttonA.getMouseListeners();
    System.out.println("\ndefault JButton's listeners " + m.length);
    for (int i=0; i<m.length; i++);
        System.out.println(m[0]);
    m = panelA.getMouseListeners();
    System.out.println("\ndefault JPanel's listeners " + m.length);

with the following output:

default JButton's listeners 1
javax.swing.plaf.basic.BasicButtonListener@17a29a1

default JPanel's listeners 0

Without a listener, JPanel will not response to events.
###@###.### 2005-05-16 20:51:25 GMT