Javadoc edits for RC-1.

Sylvain. Herre are a bunch of Javadoc edits mainly for consistency and grammar.