> 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