A DESCRIPTION OF THE PROBLEM :
Current text seems to say that this method returns the value that was set in either the command line arguments or by a System.setProperty(...) call.

There is not any indication of whether this actually enables or disables extra mouse button input being allowed.

It also seems to imply that the default "true" return has no built in relevance to whether the system itself supports extra mouse buttons.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
A clear description of what the method does and does not do.

If the implications are both true, then that should be explicitly stated.

If the implications are not true, then the real use of this method needs to be explained more clearly.

I know it's not high priority, but it seems like it's either a simple fix or very broken :)
ACTUAL -
The text is confusing. The clearest reading I get from it is that calling this method returns a value set by the user and/or programmer but has no effect or relation other than being an awkward global boolean.

URL OF FAULTY DOCUMENTATION :
http://download.oracle.com/javase/7/docs/api/java/awt/Toolkit.html