A DESCRIPTION OF THE PROBLEM :
Hi!

So i came across with this error while i was reading about how binding to a GUI component worked. I was reading the firePropertyChange() method and i noticed the very last overloading method of the firePropertyChange() had wrong javadocs for its Parameters.
The actual overloading method is:

firePropertyChange(String propertyName, short oldValue, short newValue)

Parameters:
propertyName - the programmatic name of the property that was changed
oldValue - the old value of the property (as a short)
newValue - the old value of the property (as a short)

As you can see the newValue documentation should be the "new" value to the property instead of the "old".

Regards,
Run Yan.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
 newValue - the new value of the property (as a short)
ACTUAL -
newValue - the old value of the property (as a short)

URL OF FAULTY DOCUMENTATION :
I accessed this javadoc from my netbeans IDE.