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