On Tue, 2 Nov 2021 17:39:17 GMT, Alan Bateman <al...@openjdk.org> 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