On 2024-05-31 21:38, Jonathan Gibbons wrote: > Michael, > > There is no `element-list` file for any version of JDK before JDK 9. > Before JDK 9, the appropriate information was in the `package-list` > file. In JDK 9, with the introduction of modules, the format of the file > was updated to include modules, and because this was an incompatible > change, the file was renamed as well, to `element-list`. > > It is an annoying misconfiguration of `docs.oracle.com` that you are > seeing `302 Moved Temporarily` instead of `404 Not Found` which would be > a more semantically accurate response. > > That leaves the question of why whatever you were doing was looking for > `element-list` in JDK 8. To answer that, we need more info, to determine > whether it is just a command-line error on your part, or any error in > the `javadoc` tool itself. What version of JDK and javadoc are you > using; what external libraries were you referencing in `-link` or `- > linkoffline` options; and what source level were you using, with either > the `-source` or `--release` options?
John, thanks for the elaboration. Let me better clarify what happens. The code is question with a modification for you is available at: https://github.com/michael-o/tomcatspnegoad/tree/javadoc-issue Class net.sf.michaelo.tomcat.pac.asn1.AdIfRelevantAsn1Parser uses com.sun.security.jgss.AuthorizationDataEntry and others use private Sun classes which does not allow me to use -release for now, only -source. The source is Java 8. When I run javadoc:javadoc with Zulu 8 all links are generated successfully. Running Zulu 11 with extracted Javadoc call (&"C:\Program Files\Zulu\zulu-11\bin\javadoc.exe" -verbose "@options" "@packages") gives me no warning, even in verbose mode. It simply does not link. When trying Temurin 22.0.1 (&"C:\Temp\jdk-22.0.1+8\bin\javadoc.exe" -verbose "@options" "@packages") it gives me: > Warnung: URL > https://docs.oracle.com/javase/8/docs/jre/api/security/jgss/spec/element-list > wurde umgeleitet an https://docs.oracle.com/en/java/javase/22/ - > Aktualisieren Sie die Befehlszeilenoptionen, um diese Warnung zu unterdrücken. That is the redirect. Either I am misunderstanding or I have hit an edge case for public classes outside of the standard JDK (Java namespaces). Here is the input to Javadoc (@options, @packages) if you cannot try yourself: https://gist.github.com/michael-o/212c6797b000914b9142f1f077b1d9df I have tried: > Apache Maven 3.8.8 (4c87b05d9aedce574290d1acc98575ed5eb6cd39) > Maven home: C:\Entwicklung\Programme\apache-maven-3.8.8 > Java version: 11.0.18, vendor: Azul Systems, Inc., runtime: C:\Program > Files\Zulu\zulu-11 > Default locale: de_DE, platform encoding: UTF-8 > OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows" > Apache Maven 3.8.8 (4c87b05d9aedce574290d1acc98575ed5eb6cd39) > Maven home: C:\Entwicklung\Programme\apache-maven-3.8.8 > Java version: 1.8.0_362, vendor: Azul Systems, Inc., runtime: C:\Program > Files\Zulu\zulu-8\jre > Default locale: de_DE, platform encoding: Cp1252 > OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows" > Apache Maven 3.8.8 (4c87b05d9aedce574290d1acc98575ed5eb6cd39) > Maven home: C:\Entwicklung\Programme\apache-maven-3.8.8 > Java version: 22.0.1, vendor: Eclipse Adoptium, runtime: C:\Temp\jdk-22.0.1+8 > Default locale: de_DE, platform encoding: UTF-8 > OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows" Note: I have routed the Javadoc traffic through Fiddler and it clearly following the misconfigured docs.oracle.com location: > # Result Protocol Host URL Body Caching Content-Type > Process Comments Custom > 10 302 HTTPS docs.oracle.com > /javase/8/docs/jre/api/security/jgss/spec/element-list 1 > javadoc:24660 > # Result Protocol Host URL Body Caching Content-Type > Process Comments Custom > 12 200 HTTPS docs.oracle.com /en/java/javase/22/ 33 431 > max-age=19052 text/html javadoc:24660 Regards, Michael
