Hmmm... it's a hard problem because we intentionally have invalid html in our private javadoc, since it's designed primarily for human readers, e.g.
error: malformed HTML [javadoc] * Precondition and postcondition: 0 <= i < modulus. jsr166 has: [javadoc] 86 errors [javadoc] 780 warnings ... the world wants to be able to use markdown in javadoc ...
