adoptium / installer

Installer scripts for Eclipse Temurin binaries
Apache License 2.0
144 stars 71 forks source link

Linux (RPM/DEB/APK) installer packages don't install javadoc package. #814

Open mahiarmody opened 5 months ago

mahiarmody commented 5 months ago

When installing temurin JDK via the Deb installation on Debian or Ubuntu, the java doc package is missing. When openJDK is installed via the Ubuntu repository, this package available for installation.

Would it be possible to add the doc package when installing temurin openJDK via Deb installation on Debian or Ubuntu? Here's the current output from apt-cache search:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE

It would be great if we could additionally get something like this instead:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE temurin-21-doc - Eclipse Temurin 21 Development Kit (JDK) documentation

jiekang commented 1 month ago

When installing temurin JDK via the Deb installation on Debian or Ubuntu, the java doc package is missing. When openJDK is installed via the Ubuntu repository, this package available for installation.

@mahiarmody Can you share a link to this doc package on the Ubuntu repo that you are referring to? Or elaborate further on what it is. That will help us when evaluating this issue.

Would it be possible to add the doc package when installing temurin openJDK via Deb installation on Debian or Ubuntu? Here's the current output from apt-cache search:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE

It would be great if we could additionally get something like this instead:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE temurin-21-doc - Eclipse Temurin 21 Development Kit (JDK) documentation

mahiarmody commented 4 weeks ago

Hello Jie, Thank you for your reply. Here's the link from the Ubuntu repo:http://us.archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-21/openjdk-21-doc_21.0.2%2b13-1%7e22.04.1_all.deb

I obtained this link by issuing the following command in the terminal: apt download --print-uris openjdk-21-doc Output of the above-mentioned command: 'http://us.archive.ubuntu.com/ubuntu/pool/universe/o/openjdk-21/openjdk-21-doc_21.0.2%2b13-1%7e22.04.1_all.deb' openjdk-21-doc_21.0.2+13-1~22.04.1_all.deb 12097872 SHA512:23d58d9bf98b99416d0afeb92cc1a53f791aea66aea7a16523bf089490530c561531bb9641f62fd06c4e233022aea975f67b6c70a1ce173d028c0e3fa09c23ba The request is to install an offline version of the Java Doc API (the entire HTML tree). So, instead of having to be connected to the Internet to get to the online java docs available at: "https://docs.oracle.com/en/java/javase/21/docs/api/allclasses-index.html", we could get an offline copy of the same, stored somewhere in the local file system. That way no Internet connection is required to view the Java docs. The Ubuntu repository installs these at: "/usr/share/doc/openjdk-21-doc/api/allclasses-index.html". Please let me know if you need any further information. Thank you. Sincerely,Mahiar

On Monday, 27 May, 2024 at 07:42:48 am GMT-10, Jie Kang ***@***.***> wrote:  

When installing temurin JDK via the Deb installation on Debian or Ubuntu, the java doc package is missing. When openJDK is installed via the Ubuntu repository, this package available for installation.

@mahiarmody Can you share a link to this doc package on the Ubuntu repo that you are referring to? Or elaborate further on what it is. That will help us when evaluating this issue.

Would it be possible to add the doc package when installing temurin openJDK via Deb installation on Debian or Ubuntu? Here's the current output from apt-cache search:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE

It would be great if we could additionally get something like this instead:

temurin-21-jdk - Eclipse Temurin 21 JDK temurin-21-jre - Eclipse Temurin 21 JRE temurin-21-doc - Eclipse Temurin 21 Development Kit (JDK) documentation

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.Message ID: @.***>

jiekang commented 4 weeks ago

For reference in future investigations, I think the source code for the .deb package is:

https://salsa.debian.org/openjdk-team/openjdk/tree/openjdk-21

jiekang commented 3 weeks ago

Also noting the Fedora RPMs have a e.g. java-21-openjdk-javadoc package.

I think it's sensible to add something for our packages...

judovana commented 3 weeks ago

Until now, I was not sure how to read the bug issue. And until now, I thought that I'm the only one using the local javadocs.....

judovana commented 3 weeks ago

In addition, fedora rpsm have java-xyz-openjdk-javadoc-zip whcih ccontains stil lthe same javadoc, only in zip. This is much more easily indexable by IDEs