RFR: 8266666: Implementation for snippets [v7]

Pavel Rappo prappo at openjdk.java.net
Mon Aug 23 18:06:33 UTC 2021


On Fri, 20 Aug 2021 18:09:47 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.
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/toolkit/taglets/SnippetTaglet.java line 39:
> 
>> 37: import jdk.javadoc.internal.doclets.toolkit.taglets.snippet.Parser;
>> 38: import jdk.javadoc.internal.doclets.toolkit.taglets.snippet.StyledText;
>> 39: import jdk.javadoc.internal.doclets.toolkit.util.Utils;
> 
> The langtools/javac/javadoc convention is to put standard JavaSE imports (`java.*`, `javax.*` ) first.

Since we are here, is there any langtools convention for when to collapse a span of single-import declarations into an import-on-demand (.*) declaration?

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

PR: https://git.openjdk.java.net/jdk/pull/4795


More information about the javadoc-dev mailing list