Um dos mantenedores do Kaffe (http://www.kaffe.org) mostrou a diferença entre a documentação das APIs do Java feita pela Sun e pelo projeto Classpath. Como exemplo, ele deu esta classe (java.awt.geom.CubicCurve2D).
Depois a gente fica mandando o pessoal procurar no Javadoc 
Mas muitas vezes a documentação oficial da Sun é críptica, ou simplesmente incompleta, e você acaba tendo de completar os detalhes (foi o que provavelmente o pessoal do projeto Classpath teve de fazer).