Missing element-list for https://docs.oracle.com/javase/8/docs/jre/api/security/jgss/spec

[Osipov, Michael]

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