RFR: 8347063: Add comments in ClassFileFormatVersion for class file format evolution history [v3]

[Chen Liang]

On Wed, 8 Jan 2025 05:51:12 GMT, Chen Liang <liach at openjdk.org> wrote:

>> `javax.lang.model.SourceVersion` has a series of comments describing the new language features present in each source version. Similar comments for the `ClassFileFormatVersion` would be helpful, so readers no longer need to search through the JVMS to find changes in new versions.
>
> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Use since-style versions

Technically this 45.0 vs 45.3 only matters for 1.0 vs 1.1; those are intricate details like "Oak classes" with u1 max stacks and locals which was removed from hotspot around JDK 14 or so and never part of the JVMS. Now we really only care about majors, and we have the majors in the enums themselves, so I wasn't too eager to jam up the list of versions with the major versions.

Thanks for the reviews.

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

PR Comment: https://git.openjdk.org/jdk/pull/22934#issuecomment-2584263459