On Fri, 23 Feb 2024 22:32:23 GMT, Andy Goryachev <ango...@openjdk.org> wrote:
>> `@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: > >  Given that the changes are so far limited to spelling and formatting (code style for null), I think it would be fine to limit the changes in this PR to what he has already done. ------------- PR Review Comment: https://git.openjdk.org/jfx/pull/1379#discussion_r1501267342