Update the Javadocs.

If any Javadoc is not consistent please report it.