RFR: 8375325: add anchors to the options in the security man pages

[Weijun Wang]

On Fri, 16 Jan 2026 00:46:48 GMT, Roger Calnan <duke at openjdk.org> wrote:

> adjust each of the command line options to include an html anchor so that one can give a link that goes directly to the section in the man page that covers a specific option

Looks good. Some might not be necessary.

src/java.base/share/man/keytool.md line 1591:

> 1589: The command creates the keystore named `mykeystore` in the working directory
> 1590: (provided it doesn't already exist), and assigns it the password specified by
> 1591: [`-keypass`]{#-keypass}. It generates a public/private key pair for the entity whose

I'd rather not giving this an anchor. It just happens to be mentioned here. It's not the formal spec for it.

src/java.base/share/man/keytool.md line 2366:

> 2364: that don't conform to the standard might be rejected by the JDK or other
> 2365: applications. Users should ensure that they provide the correct options for
> 2366: [`-dname`]{#-dname}, `-ext`, and so on.

Same for this one. No need to add an anchor here.

src/jdk.jartool/share/man/jarsigner.md line 800:

> 798:     path-separator character.
> 799: 
> 800: [`-J`]{#-J}*javaoption*

Maybe this one is not necessary. It's a general option for extra VM options.

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

PR Review: https://git.openjdk.org/jdk/pull/29258#pullrequestreview-3672060086
PR Review Comment: https://git.openjdk.org/jdk/pull/29258#discussion_r2699459977
PR Review Comment: https://git.openjdk.org/jdk/pull/29258#discussion_r2699461011
PR Review Comment: https://git.openjdk.org/jdk/pull/29258#discussion_r2699471280