RFR: 8373186: Improve readability of core reflection toString specifications

[Chen Liang]

On Mon, 8 Dec 2025 22:27:21 GMT, Roger Riggs <rriggs at openjdk.org> wrote:

>> Partial implementation of a spec refactoring to get some feedback before writing similar changes for other core reflection types.
>
> src/java.base/share/classes/java/lang/reflect/Field.java line 349:
> 
>> 347: 
>> 348:     /**
>> 349:      * {@return a string describing this {@code Field}}
> 
> I don't see a compelling reason to backtrack on the format of toString. 
> Its likely to break some application or description of the field to a user.

I think the reason to change the format is some future modifiers, like ACC_STRICT_INIT, won't get printed.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/28688#discussion_r2600533536