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

[Chen Liang]

On Tue, 27 Jan 2026 09:08:14 GMT, Hannes Wallnöfer <hannesw at openjdk.org> wrote:

>> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Remove redundant dot
>
> 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!

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

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