RFR: JEP 359-Records: javadoc code
Jonathan Gibbons
jonathan.gibbons at oracle.com
Thu Oct 31 13:59:33 UTC 2019
On 10/31/19 3:31 AM, Chris Hegarty wrote:
> Jon,
>
>> On 30 Oct 2019, at 23:50, Jonathan Gibbons <jonathan.gibbons at oracle.com> wrote:
>>
>> ...
>>
>> Also, the sets of examples are updated, showing examples linked and not linked to JDK API docs
>> http://cr.openjdk.java.net/~jjg/amber-records/examples/api-with-link/
>> http://cr.openjdk.java.net/~jjg/amber-records/examples/api-no-link/
> The API docs should show all records as final, regardless of whether or not the final keywords appears in the source code. ( I’m not sure that this is currently the case in the changes ).
>
> Additionally, ( something that I forgot previously ) I think that the API doc for all nested records should show them as static, regardless of whether or not the static keyword appears in the source code. ( A nested record is implicitly static ).
>
> -Chris.
Chris,
Thanks for the comment. I'll check with the experts on this. While it is
true that records are implicitly static final, javadoc does not show
implicit modifiers in other similar contexts, like interfaces.
-- Jon
More information about the javadoc-dev
mailing list