Fix javadoc warnings and clarify; some from old-1.1.xx/78bc745