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
Posted Date : 2007-02-02 13:30:02.0

also includes:
4495784 |Docs should be more informative for java.awt.event.InputEvent.getWhen()
Posted Date : 2007-02-05 11:55:05.0

N/A

should follow the spec writer guide:
http://java.sun.com/j2se/javadoc/writingapispecs/index.html#method
Posted Date : 2007-02-02 13:31:54.0