RFR: JEP 359-Records: javadoc code

[Jonathan Gibbons]

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