On Fri, 23 Feb 2024 21:58:30 GMT, Nir Lisker <nlis...@openjdk.org> wrote:
>> I don't mind either way. > > `@return` statements usually state this condition explicitly, like `Map#get`: > "the value to which the specified key is mapped, or `null` if this map > contains no mapping for the key". My point is that it should be mentioned in the first paragraph then. It can be repeated in @return later, if you prefer. Map.get() does indeed mention this in the first paragraph:  ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1379#discussion_r1501237620