On Tue, 27 Jan 2026 13:30:50 GMT, Chen Liang <[email protected]> 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
