RFR: 8278856: javac documentation does not mention use of Manifest class-path attribute [v2]

[Jan Lahoda]

On Tue, 19 Nov 2024 16:13:16 GMT, Christian Stein <cstein at openjdk.org> wrote:

>> Christian Stein has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains two additional commits since the last revision:
>> 
>>  - Merge branch 'openjdk:master' into patch-2
>>  - 8278856: javac documentation does not mention use of Manifest class-path attribute
>
> src/jdk.compiler/share/man/javac.md line 1291:
> 
>> 1289: and the specified JAR file(s) exist, they are automatically inserted into the
>> 1290: user class path after the JAR file. This rule also applies recursively to any
>> 1291: new JAR files found. Consult the [JAR File Specification](../jar/jar.html#class-path-attribute)
> 
> The link to the `jar.html` file using the relative path `../jar/` should lead to the JAR File Specification document. For JavaSE 23, that specification documentation is located at https://docs.oracle.com/en/java/javase/23/docs/specs/jar/jar.html
> 
> How can I test that the online version, for 23 hosted at https://docs.oracle.com/en/java/javase/23/docs/specs/man/javac.html, contains the correct link target?

I see javadoc uses a similar approach:
https://github.com/openjdk/jdk/blob/4c6af03f81e068a98b8f4628b96682a54f3946da/src/jdk.javadoc/share/man/javadoc.md?plain=1#L101

So the link here is probably OK, but I don't know what is the way to check.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/22243#discussion_r2491325249