A DESCRIPTION OF THE PROBLEM :
There is no indication on the page whatsoever which button number corresponds to which button on the mouse. I spent minutes debugging until I found out the right mouse button was BUTTON3 for some obscure reason.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
A small paragraph explaining that BUTTON1= left click, BUTTON2= middle click (?) BUTTON3 = right click, or some link to a relevant webpage explaining this.
ACTUAL -
Nothing.

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/javase/6/docs/api/java/awt/event/MouseEvent.html#getButton()