Support for Markdown javadoc (JEP-467)

[lahodaj]

A patch to support Markdown javadoc (JEP-467).

[dbalek]

Looks fine to me. Thanks.

[lahodaj]

Unless there are objections, I will merge in the next day or so.

[mbien]

probably ok to merge as new feature, but I fear that this might confuse some of the javadoc editor hints since they probably don't expect markdown.

[lahodaj]

probably ok to merge as new feature, but I fear that this might confuse some of the javadoc editor hints since they probably don't expect markdown.

It might confuse something. Or some piece of code may be confused by the current situation (where the model already includes AST model of Markdown javadoc, but the JavadocUtilities don't understand it). I don't think this is an actionable claim, and I think this change is a step in finding out what's wrong, if anything, and fix it.

[mbien]

I don't think this is an actionable claim

it was just a feeling, but here an example after testing it quickly:

    ///
    /// @param str
    ///
    public static void foo(String str, int i) {}

the hint will suggest to insert the doc for i in the old format, ignoring that the method has already a block in the new format.

result:

    ///
    /// @param str
    ///

    /**
     *
     * @param str
     * @param i
     */
    public static void foo(String str, int i) {}

and I think this change is a step in finding out what's wrong, if anything, and fix it.

of course. That is why I said I think it is ok to merge this as new feature.

[lahodaj]

Hm, yes that happens. But it happens without this patch as well, so this is not something caused by this patch.

[mbien]

forgot to approve - looks good!