On Tue, 27 Jan 2026 09:08:14 GMT, Hannes Wallnöfer <[email protected]> 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
