<i18n dev> RFR: 8276348: Use blessed modifier order in java.base

[Pavel Rappo]

On Tue, 2 Nov 2021 17:39:17 GMT, Alan Bateman <alanb at 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