javadoc broken by Java 8

[denis-yuen]

Javadoc in Java 8 has some new features that check our javadocs.
They are broken and should be updated to match, then remove the workaround in Maven to disable the checks.

https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete