On Tue, 7 Oct 2025 22:43:33 GMT, Phil Race <[email protected]> wrote:

>I don't see how that is better.

The specification will include a note about certain limitations, and under 
@implNote, we will describe the actual implementation-specific limitation. I 
believe that tag is appropriate in this context:

>"@implNote" — Implementation Notes. This section contains informative notes 
>about the implementation, such as advice for implementors or performance 
>characteristics specific to this class in this version of the JDK. The 
>information in this **section may change from release to release**. These 
>characteristics may also vary across platforms, vendors, and JDK versions.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/27640#discussion_r2412138582

Reply via email to