Integrated: 8377857: Add since checker test for java.naming module
Jaikiran Pai
jpai at openjdk.org
Sat Feb 14 09:16:20 UTC 2026
On Fri, 13 Feb 2026 02:00:09 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:
> Can I please get a review of this change which introduces a test to verify the usages of `@since` javadoc tags in the `java.naming` module? This addresses https://bugs.openjdk.org/browse/JDK-8377857.
>
> The `SinceChecker` test utility has been in use for several modules, but wasn't added for java.naming. The commit in this PR adds one for that module.
>
> The `SinceChecker` test utility does not handle the presence of a comma in (for example `@since X, Y`) correctly. The javadoc tag spec for `@since` allows that syntax https://docs.oracle.com/en/java/javase/25/docs/specs/javadoc/doc-comment-spec.html#since. As a workaround, the commit in this PR splits the `@since` on `javax.naming.InitialContext` class into two separate declarations (this too is allowed by the `@since` tag spec). I've verified that the generated javadoc continues to correctly show these values. I have also spoken to Nizar about this issue in SinceChecker and it will be addressed separately.
This pull request has now been integrated.
Changeset: 49e2a6b6
Author: Jaikiran Pai <jpai at openjdk.org>
URL: https://git.openjdk.org/jdk/commit/49e2a6b696c2063f0b4331b0a6d064852d676fcd
Stats: 31 lines in 2 files changed: 29 ins; 0 del; 2 mod
8377857: Add since checker test for java.naming module
Reviewed-by: alanb
-------------
PR: https://git.openjdk.org/jdk/pull/29705
More information about the core-libs-dev
mailing list