RFR: JDK-8298405: Support Markdown in Documentation Comments [v6]

[Jonathan Gibbons]

On Tue, 30 Jan 2024 00:39:43 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.compiler/share/classes/com/sun/tools/javac/parser/DocCommentParser.java line 259:
>> 
>>> 257:         LineKind lineKind = textKind == DocTree.Kind.MARKDOWN ? peekLineKind() : null;
>>> 258: 
>>> 259:         if (DEBUG) System.err.println("starting content " + showPos(bp) + " " + newline);
>> 
>> Debug output is useful. I wonder if we should consider https://openjdk.org/jeps/264.
>
> My oops for leaving the code in, or at least not cleaning it up more.

yeah, the debug code was pretty obsolete; I removed all except the generally useful method to show the text surrounding a position in the input buffer.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16388#discussion_r1473654007