Fix Javadoc Warnings

There are several javadoc warnings that make the project not compile with the
Java 8 doclint.
Merge pull request #27 from marschall/javadoc-warnings

Fix  javadoc warnings that make the project not compile with the
Java 8 doclint.