RFR: 8376274: JSpec preview support and output enhancement [v2]

[Chen Liang]

On Tue, 27 Jan 2026 13:30:50 GMT, Chen Liang <liach at openjdk.org> wrote:

>> make/jdk/src/classes/build/tools/taglet/JSpec.java line 198:
>> 
>>> 196:                         // Change whole text to "§chapter.x" in inline tags.
>>> 197:                         literal = sectionSign + chapter + section;
>>> 198:                     }
>> 
>> What is the rationale for only using the section sign when there is no title? If we render a title-less tag as `§1.2.34`, why not also render a titled tag as `§1.2.34 Section Title` (or vice versa)?
>> 
>> For preview spec links, should there be a marker to indicate the preview status? I'm thinking of adding something like `(preview feature)` after the link, or a superscript <sup>PREVIEW</sup> tag like we use in API references.
>
> I don't add section sign before full title because that's how jls/jvms menu entries render.
> 
> For preview, you have a great point. I will add the superscript!

I don't add section sign before full title because that's how jls/jvms menu entries render.

For preview, you have a great point. I will add the superscript!

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

PR Review Comment: https://git.openjdk.org/jdk/pull/29402#discussion_r2732028494