RFR: 4617681: constructor of BufferedImage throws unexpected IllegalArgumentException

[Sergey Bylokhov]

On Tue, 7 Oct 2025 22:43:33 GMT, Phil Race <prr at openjdk.org> 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