Incorrect javadocs prevent compilation from completing with JDK 8 about mixin HOT 5 CLOSED

I was under the impression that we were working with JDK 6 which is what all of my testing has been performed under. If it's only javadoc then I can fix building in JDK 8 easily though.

from mixin.

jdk 8 is rather picky w/ javadoc

from mixin.

I know, I kind of like the javadoc to be clean though and generally spend quite a bit of time adding javadoc comments to everything. Not sure what JDK8 would be choking on but I'll investigate.

from mixin.

It's a few things: For one, it doesn't like the </pre></blockquote></p> because <pre> and <blockquote> imply </p> on the opening tags.

There's also a spot or two where you have <init>, which makes it complain because that's not a tag, and using @-returns instead of @-return

from mixin.

I actually took the nesting of blockquotes/pre etc from the JDK javadoc, so go figure why that breaks! The ctor reference makes sense and I can replace the html entities.

from mixin.