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