#169 updated javadoc.