netbeans javadoc links to ancient java se javadoc

[homberghp]

Apache NetBeans version

Apache NetBeans 25 release candidate

What happened

It is not a netbeans bug perse, but rather annoying.
When you lookup javadoc for say the netbeans-25 apis, following the links to some JDK apis, such as say ClassTree, you land in a Java SE 6 version of the com.sun javadoc.

Language / Project Type / NetBeans Component

javadoc

How to reproduce

look up WorkingCopy in java/java.source.base and click on e.g. Tree.
This will land you in https://docs.oracle.com/javase/6/docs/jdk/api/javac/tree/com/sun/source/tree/Tree.html?is-external=true
where https://docs.oracle.com/en/java/javase/17/docs/api/jdk.compiler/com/sun/source/tree/Tree.html would be more appropriate, since 17 is the min version for building netbeans >= 24.

Did this work correctly in an earlier version?

No / Don't know

Operating System

any, the problem lies on the server or deployment side

JDK

jdk 17

Apache NetBeans packaging

Other

Anything else

it is just an annoyance, and probably only a setting in one of the ant scripts or properties.
Other modules link to more up to date javadoc sites (such as java 8).

Are you willing to submit a pull request?

Yes

[mbien]

the doc is currently linked with the JDK 8 API

netbeans/nbbuild/javadoctools/template.xml

Line 88 in f5846de

<property name="javadoc.docs.jdk" value="https://docs.oracle.com/javase/8/docs/api"/>

which we should probably bump to 17.

There compiler classes are a special case since NB ships with the latest build (currently based on JDK 24 javac). So it doesn't surprise me that they have some linking issues since the situation is a bit unusual there.

[ebarboni]

We need both to match with jdk we use for javadoc build but with jdk 11 we have module before classtree

https://github.com/apache/netbeans/blob/master/nbbuild/javadoctools/links.xml contains the ref to faulty doc

[ebarboni]

Hope I find the way to workaround the issue. I will try to have a script to changes @JDK@/... to @JDK@@JAVAMODULE....@ in a manner I can reapply on the previous release back to a certain point.