RFR: 8373186: Improve readability of core reflection toString specifications

[Chen Liang]

On Sat, 6 Dec 2025 21:35:57 GMT, Joe Darcy <darcy 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 360:

> 358:      *    private int java.io.FileDescriptor.fd
> 359:      *    public static java.util.List Foo.bar
> 360:      * </pre>

Having such examples here means this method has a specified output that users can parse.  We should move this to some non-normative section like an implementation note.

(Don't know why github mobile didn't capture my comment before, I already commented yesterday)

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

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