RFR: 8323213: Fix some javadoc broken links in ObjectReference, and other misc javadoc cleanups

Chris Plummer cjplummer at openjdk.org
Tue Jan 9 20:20:22 UTC 2024


On Tue, 9 Jan 2024 20:00:29 GMT, Alan Bateman <alanb at openjdk.org> wrote:

>> There are a lot of places where we use `see` in this manner, because it applies specifically to the text that proceeds it. These 3 were different in that the space was missing.
>
> Personally I wouldn't not use this style, instead I would limit the `@throws` to just the simple sentence and then use `@see` for related methods, just as we do in the core APIs.

We have 33 instances of using `see` like this in JDI. I rather not get into changing them for this PR.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/17311#discussion_r1446555486


More information about the serviceability-dev mailing list