javadocs: minor style, grammar changes; add @since annotation to new method