RFR: 8292968: java.net.ContentHandler's javadoc has a broken reference
Daniel Fuchs
dfuchs at openjdk.org
Fri Aug 26 11:51:55 UTC 2022
On Fri, 26 Aug 2022 09:22:26 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:
> Can I please get a review of this javadoc only change which addresses https://bugs.openjdk.org/browse/JDK-8292968?
>
> The updated javadoc now uses the `@systemProperty`, since this is the place where the semantics of this system property has been described. As per the expectations of `@systemProperty` (https://mail.openjdk.org/pipermail/core-libs-dev/2018-November/056653.html) this would then be a relevant place to use that javadoc tag.
>
> After this change, I've run `make docs` and verified that the generated javadoc renders properly and `java.content.handler.pkgs` shows up in the system properties listing page.
In fact - I am not sure we need a CSR. I thought one might be needed if we have the property now appear in the system property search - but the property was documented before, so I now believe the CSR is not needed.
-------------
PR: https://git.openjdk.org/jdk/pull/10040
More information about the net-dev
mailing list