RFR: JDK-8263043: Add test to verify order of tag output [v2]

Jonathan Gibbons jjg at openjdk.java.net
Fri Mar 5 18:04:06 UTC 2021


On Fri, 5 Mar 2021 16:06:05 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Hmmm ...
>> Actually, my initial version of the code _did_ include `@author`, but not `@version`.  But, it didn't work as expected ... because neither are actually supported on methods, and so they do not appear in the output.  See https://docs.oracle.com/en/java/javase/15/docs/specs/javadoc/doc-comment-spec.html#where-tags-can-be-used
>> 
>> So, if you really think we should test these as well, we will have to extend the test to include comments on a class or interface declaration.
>
> I looked at that table before suggesting to add those tags and realized that adding them would complicate the test, hence "consider". You could push the test as is and we will improve it later. It's up to you, Jon.

I've improved the test.

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

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


More information about the javadoc-dev mailing list