On Fri, 20 Aug 2021 18:42:53 GMT, Jonathan Gibbons <j...@openjdk.org> wrote:
>> Pavel Rappo has updated the pull request incrementally with one additional >> commit since the last revision: >> >> Pass through FIXMEs and TODOs >> >> Downgrades FIXMEs that do not mark *feature issues* to TODOs, or removes >> those FIXMEs completely. For example, unlike Style hierarchy, Action >> hierarchy won't benefit from becoming sealed. So the respective FIXME is >> removed. > > test/langtools/jdk/javadoc/doclet/testSnippetTag/TestSnippetTag.java line > 1508: > >> 1506: ) >> 1507: // Uncomment when parser has improved (this would allow to write meta >> snippets, >> 1508: // i.e. snippets showing how to write snippets. > > Just a question: what are the limitations in the parser that are getting in > the way here? Both the commented-out code and its description are from a previous version of markup; you can see that the syntax is slightly different from what we have in JEP today. It's good that you asked this question, because this piece is outdated. Although the markup syntax has changed, the idea for the test remained: there has to be a way to produce a snippet that showcases markup. I will have to implement that idea. ------------- PR: https://git.openjdk.java.net/jdk/pull/4795
