RFR: 8338411: Implement JEP 486: Permanently Disable the Security Manager [v9]

[Alexey Ivanov]

On Tue, 29 Oct 2024 17:06:08 GMT, Harshitha Onkar <honkar at 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