On Fri, 1 Nov 2024 20:26:45 GMT, Alexey Ivanov <aiva...@openjdk.org> wrote:
>>> 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? I can add it back if it is more convenient and readable to have the `@see` tag. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/21498#discussion_r1834883137
