java version "1.6.0_19"
Java(TM) SE Runtime Environment (build 1.6.0_19-b04)
Java HotSpot(TM) Client VM (build 16.2-b04, mixed mode, sharing)

Does this problem occur on J2SE 5.0.x or 6.0? Yes / No (pick one)
Yes

Operating System Configuration Information (be specific):
Client: Microsoft Windows XP [Version 5.1.2600]

Bug Description:
JMenu.add and remove methods JavaDoc is not complete

This is related to bug: 6286346.
It appears that it is required to call getPopupMenu().repaint() and
getPopupMenu().revalidate() following any changes to a visible JMenu.
(It is not painting properly otherwise)

The JavaDoc for JMenu.add and remove methods needs to mention this