RFR: JDK-8298405: Support Markdown in the standard doclet [v6]

Jonathan Gibbons jjg at openjdk.org
Wed Feb 8 22:20:44 UTC 2023


> 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.
> 
> Background info: https://mail.openjdk.org/pipermail/javadoc-dev/2023-January/005563.html

Jonathan Gibbons has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 11 commits:

 - Merge with upstream/master
 - Merge with upstream/master
 - Rename MarkdownTree to RawTextTree
 - Merge with upstream/master
 - Update copyright years
 - Rename FFFC variable
   Share Markdown parser and renderer in instance of MarkdownHandler
 - Move CommonMark to new internal module.
   Add legal header to imported CommonMark source files
   Always use Text nodes inside AttributeTree values
   Unwrap <p> from "simple" paragraphs
 - Always use Text nodes inside AttributeTree values
 - Update to CommonMark 0.21.
 - fix whitespace
 - ... and 1 more: https://git.openjdk.org/jdk/compare/873558ee...59719f19

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

Changes: https://git.openjdk.org/jdk/pull/11701/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=11701&range=05
  Stats: 15687 lines in 146 files changed: 15384 ins; 111 del; 192 mod
  Patch: https://git.openjdk.org/jdk/pull/11701.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/11701/head:pull/11701

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


More information about the compiler-dev mailing list