search

adoptium / adoptium-support

For end-user problems reported with our binary distributions
Apache License 2.0
46 stars 15 forks source link

man pages are out of date #504

Open keturn opened 2 years ago

keturn commented 2 years ago

What are you trying to do?

Learn the options available for the JVM.

Expected behaviour:

man java (or man -l man/man1/java.1) shows me documentation corresponding to the program in bin/java, including information about the JVM in this distribution.

Observed behaviour:

man -l man/man1/java.1 in a recent build of temurin-11 shows me documentation for some build of JDK 8 in 2015.

sxa commented 2 years ago

That presumably comes from the upstream codebase at https://github.com/openjdk/jdk11u/blob/master/src/solaris/doc/sun/man/man1/java.1 so is not something we can resolve at Adoptium

keturn commented 2 years ago

It says the files are generated: https://github.com/adoptium/jdk11u/blob/87e0662a7336cbdb3de30a0c597f1588b44483e9/src/linux/doc/man/DO_NOT_EDIT--GENERATED_FILES#L1-L2

Could the build re-generate them?

sxa commented 2 years ago

Generate them from what? We just run the standard openjdk build process and those files are presumably generated in some form somewhere else before being put into the openjdk github repository. We have no control or involvement over that part of the process and Adoptium would not wish to write and maintain our own versions.

github-actions[bot] commented 2 years ago

We are marking this issue as stale because it has not been updated for a while. This is just a way to keep the support issues queue manageable. It will be closed soon unless the stale label is removed by a committer, or a new comment is made.