RFR: 8266666: Implementation for snippets [v7]

[Pavel Rappo]

On Fri, 20 Aug 2021 18:42:53 GMT, Jonathan Gibbons <jjg at 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