Finalized improvements of javadoc, fixes #4