Additional javadoc for issue #41