Most of event classes withing java.awt.event package has a lack of documentation about parameters.
The main principles are covered in:
6210025 |InputEvent.getModifiersExText: unclear result for invalid modifiers
6210028 |MouseEvent.getMouseModifiersText: unclear result for invalid modifiers
4751457 |java.awt.event.MouseWheelEvent: doc's unclear
4752917 |java.awt.event.ActionEvent: clarification needed
4756696 |java.awt.event.WindowEvent: unclear doc
4660235 |Confusing documentation on change masks in HierarchyEvent
There are some more classes that needs spec refreshing
src/share/classes/java/awt/event/KeyEvent.java
src/share/classes/java/awt/event/AdjustmentEvent.java
src/share/classes/java/awt/event/ComponentEvent.java
src/share/classes/java/awt/event/InputMethodEvent.java
src/share/classes/java/awt/event/InvocationEvent.java
src/share/classes/java/awt/event/ItemEvent.java
src/share/classes/java/awt/event/TextEvent.java
src/share/classes/java/awt/event/ContainerEvent.java
src/share/classes/java/awt/event/FocusEvent.java
src/share/classes/java/awt/event/PaintEvent.java
src/share/classes/java/awt/dnd/DragGestureEvent.java
src/share/classes/java/awt/dnd/DropTargetEvent.java
also includes:
4495784 |Docs should be more informative for java.awt.event.InputEvent.getWhen()