RFR: JDK-8305713: DocCommentParser: merge blockContent and inlineContent [v6]

[Pavel Rappo]

On Wed, 19 Apr 2023 14:17:57 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Please review a cleanup in DocCommentParser to merge blockContent and inlineContent into a single method to parse "rich content" in a doc comment.
>> 
>> **Note:** This is dependent on PR #13362, to convert `DocCommentParser` to use enhanced switch.
>
> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
> 
>   address review feedback

src/jdk.compiler/share/classes/com/sun/tools/javac/parser/DocCommentParser.java line 82:

> 80:         /** The initial part of an HTML file up to and including the {@code body} and possible {@code <main>} tag. */
> 81:         PREAMBLE,
> 82:         /** The initial part of a doc comment, or the rich-text content of a block tag. */

Curious: is "initial part of a doc comment" the same as what we now call [main description](https://docs.oracle.com/en/java/javase/20/docs/specs/javadoc/doc-comment-spec.html#main-description)?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13431#discussion_r1171511438