On Thu, 15 Dec 2022 23:47:45 GMT, Jonathan Gibbons <j...@openjdk.org> wrote:

> Support for Markdown comments in the standard doclet.
> 
> To enable Markdown in a comment, start the comment with `/**md` followed by 
> whitespace.  The syntax is as defined for CommonMark.
> 
> The work is in 3 parts:
> 
> 1. Update the Compiler Tree API to support Markdown tree nodes, containing 
> strings of (uninterpreted) Markdown source code.
> 2. Import commonmark-java into the `jdk.javadoc` module, to be able to 
> convert Markdown strings to HTML.
> 3. Update the standard doclet, to leverage the preceding two parts, to 
> translate Markdown in documentation comments to `Content` nodes.
> 
> There are new tests both for the low level work in the Compiler Tree API, and 
> for the overall high-level work in the doclet.

src/jdk.javadoc/share/classes/jdk/internal/org/commonmark/internal/Bracket.java 
line 48:

> 46:     public boolean bracketAfter = false;
> 47: 
> 48:     static public Bracket link(Text node, Position markerPosition, 
> Position contentPosition, Bracket previous, Delimiter previousDelimiter) {

Let's use blessed modifiers order
Suggestion:

    public static Bracket link(Text node, Position markerPosition, Position 
contentPosition, Bracket previous, Delimiter previousDelimiter) {

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

PR: https://git.openjdk.org/jdk/pull/11701

Reply via email to