A DESCRIPTION OF THE PROBLEM :
Enum's values() method is not documented. This makes it difficult to understand how, for example, to iterate through all values of an Enum.


URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Enum.html