On Tue, 30 Jun 2026 16:47:23 GMT, Joe Darcy <[email protected]> wrote:
> These changes for JEP 401 add preview APIs in a new way compared to prior > JEPs. In particular, there are different versions of platform classes with > different behavioral semantics with and without preview being enabled. Given > that, I think it would be helpful to document the mechanisms used to > implement this novel arrangement, say by a new file in the `doc` directory > like "value-class-preview.md". > > I'd like to see this file describe: > > * How the preview versions of the sources/classes are generated from the base > version, including the build changes. > * How the wrapper class caches work with preview enabled. > * High-level test methodology for these classes. > > The classes with different version with and without preview enabled could > then contain a source-only comment pointing to this file so maintains of > those files would know where to go to get more context. Created https://bugs.openjdk.org/browse/JDK-8387875 for this issue. ------------- PR Comment: https://git.openjdk.org/jdk/pull/31123#issuecomment-4904590841
