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:

![Screenshot 2024-02-23 at 14 30 
02](https://github.com/openjdk/jfx/assets/107069028/977a6dbc-c0b0-4a00-a14d-8ff40353c365)

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1379#discussion_r1501237620

Reply via email to