New candidate JEP: 467: Markdown Documentation Comments

David Lloyd david.lloyd at redhat.com
Wed Feb 28 15:23:53 UTC 2024


On Tue, Feb 27, 2024 at 2:31 PM Mark Reinhold <mark.reinhold at oracle.com>
wrote:

> https://openjdk.org/jeps/467
>
>   Summary: Enable JavaDoc documentation comments to be written in
>   Markdown rather than solely in a mixture of HTML and JavaDoc @-tags.
>

I read through this and I didn't notice any mention of how this would
integrate with existing doc interfaces in the annotation processing API
(Elements#getDocComment)? It would be great to be able to acquire at least
the raw text if not the processed Markdown during annotation processing. It
would also be good to be able to know what kind of doc text is being
returned (Markdown vs HTML).

-- 
- DML • he/him
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jdk-dev/attachments/20240228/5f1de03f/attachment-0001.htm>


More information about the jdk-dev mailing list