javadoc comments added for issue #2721