On Tue, 29 Oct 2024 17:06:08 GMT, Harshitha Onkar <hon...@openjdk.org> wrote:
>> src/java.desktop/share/classes/java/awt/MouseInfo.java line 68:
>>
>>> 66: * @throws SecurityException if a security manager exists and its
>>> 67: * {@code checkPermission} method doesn't allow the
>>> operation
>>> 68: * @see GraphicsConfiguration
>>
>> Is `GraphicsConfiguration` removed from the list because it's already
>> mentioned and linked in the description above? Is it intentional?
>
>> Is it intentional?
>
> It was probably by mistake. but you are right, I see it mentioned already in
> the doc. I don't think we need to mention it again?
It has a value… when it's mentioned with `@see`, the link is present in the
*See Also* section, as you can see in the the specification of
[`MouseInfo.getPointerInfo()`](https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/MouseInfo.html#getPointerInfo()).
Without the `@see` tag, one has to read the entire description to find the link.
It looks subtle. We can restore the `@see`-link later if deemed necessary.
Does anyone else have an opinion?
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/21498#discussion_r1826266398
