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