Update changelog and wrote javadoc comments for new API