On Tue, 2 Nov 2021 17:39:17 GMT, Alan Bateman <[email protected]> wrote:
>> src/java.base/share/classes/java/lang/Object.java line 282:
>>
>>> 280: * <li>For objects of type {@code Class,} by executing a
>>> 281: * static synchronized method of that class.
>>> 282: * </ul>
>>
>> In comments, I think the 'synchronized static 'reads better, the
>> conventional order is for the code.
>
>> In comments, I think the 'synchronized static 'reads better, the
>> conventional order is for the code.
>
> I think Roger is right and maybe the change to the javadoc could be dropped
> from this patch.
It's tough when a natural language clashes with a programming language. I
appreciate that this particular clash might cause discomfort to native English
speakers. (This reminds me of that _DOSASCOMP_ mnemonic for adjective order.)
That said, consider the following pragmatic aspect. Unless we change the script
not to process prose in comments (btw, how would we do that?), every single
time we run that script, that particular line in Object.java will need to be
tracked and excluded.
-------------
PR: https://git.openjdk.java.net/jdk/pull/6213
