RFR: 8370154: Update @jls and @jvms taglets to point to local specs dir

Chen Liang liach at openjdk.org
Sat Nov 8 05:46:59 UTC 2025


On Sat, 8 Nov 2025 01:29:13 GMT, Dan Smith <dlsmith at openjdk.org> wrote:

> Updated the JSpec taglets to use relative links into `../specs/jls` and `../specs/jvms` rather than external links, possible now due to JDK-8370153.
> 
> I was surprised there doesn't seem to be a standard way to get a relative path to the docs root, but I copy/pasted from ToolGuide, and made some tweaks based on failures I saw.
> 
> Tested with 'make docs' and manually confirmed that a handful of different `@jls` and `@jvms` tags are pointing to the right place.

I think we can go ahead with this once we verify Oracle's doc build passes. I will approve once the system property passing in Docs.gmk is updated.

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

PR Comment: https://git.openjdk.org/jdk/pull/28207#issuecomment-3506017879


More information about the javadoc-dev mailing list