updated javadoc, fixes #22