On Mon, 25 May 2026 13:02:28 GMT, Jaikiran Pai <[email protected]> wrote:
>> For this case, I think you can drop the "implSpec" tag so that it's part of >> the method description. > > Fixed. I'm not sure if it is the right thing to **mandate** a knowingly wrong implementation in the API doc which is what we effectively do in the current form. From my point of view, the only acceptable tag for such a sentence would be `@implNote` because it described implementation details which "*are allowed to vary across platforms, vendors, and versions*" (although this is unlikely nowadays where we more or less only have a single JDK implementation). ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/30925#discussion_r3304550993
