RFR: 8284697: Avoid parsing the doc comment of an element that is not documented

[Jonathan Gibbons]

On Mon, 18 Apr 2022 12:08:40 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> > The way to test it would be to put errors into a doc comment, and verify that no errors are reported, strongly implying the comment was not parse
> 
> Although we could do that, we should also keep in mind that those errors weren't reported before. If such a test is run on an unfixed version, it won't fail. This is not the behaviour one would expect from a regression test.

Ah ... I see the problem: although any errors will be detected (in `DocCommentParser`) they will never get reported, to be seen by a test, because the comment will still be ignored.

-------------

PR: https://git.openjdk.java.net/jdk/pull/8266