The current set of Java Doc is old and in some cases, misleading. Also, during a release, there are a number of items missing.