#920903 openjdk-11-jdk-headless: ships documentation for JDK 8, not JDK 11

Package:
src:openjdk-11
Source:
openjdk-11
Submitter:
Thorsten Glaser
Date:
2021-02-20 17:33:05 UTC
Severity:
important
Tags:
#920903#5
Date:
2019-01-30 13:57:44 UTC
From:
To:
I saw in https://bugs.openjdk.java.net/browse/JDK-8217581 that
“ (The page for JDK 9 does list correct values.) ” and I was like,
hey, I’ve seen it on my system too!

Turns out that yes.

tglase@tglase:~ $ realpath /usr/share/man/man1/javadoc.1.gz
/usr/lib/jvm/java-11-openjdk-x32/man/man1/javadoc.1.gz
tglase@tglase:~ $ man -l /usr/lib/jvm/java-11-openjdk-x32/man/man1/javadoc.1.gz 2>/dev/null | tail -1
JDK 8                            03 March 2015                      javadoc(1)

This is a bug, mismatching documentation that does not document
the installed software correctly is being installed.
#920903#10
Date:
2020-08-10 10:49:19 UTC
From:
To:
Hi there!

As a Java developer, I'm very much interested in having this bug
fixed. It has already caused me to give wrong information to other
people... :/ For example: the java(1) man page lists the option
`-XX:+HeapDumpOnOutOfMemory`, but this option has been renamed to
`-XX:+HeapDumpOnOutOfMemoryError` in Java 11.

Is this a Debian packaging problem or does upstream provide the wrong
documentation?

Let me know if I can help fix this, I know Debian packaging a bit.

Cheers,
  Etienne
#920903#15
Date:
2020-08-10 11:17:59 UTC
From:
To:
that's the documentation provided by upstream.
#920903#20
Date:
2020-08-10 12:11:22 UTC
From:
To:
Thank you for the fast answer Matthias. :)
Would https://bugs.openjdk.java.net/browse/JDK-8225134 be the
corresponding upstream issue? Is there any hope this could be fixed in a
future OpenJDK 11 release?

  Etienne
#920903#25
Date:
2020-08-10 12:17:06 UTC
From:
To:
That's the issue for 13, not 11.

if somebody updates those for 11 ...
#920903#30
Date:
2020-08-10 13:23:08 UTC
From:
To:
I'd happily file an upstream bug to prod them, but I can't get the form
at https://bugreport.java.com/bugreport/start_form.do to work... :(

  Etienne
#920903#35
Date:
2020-08-19 06:41:01 UTC
From:
To:
forwarded 920903 https://bugs.openjdk.java.net/browse/JDK-8251572
thanks
I managed to report this bug to Oracle, so it might increase the
chances of someone eventually fixing it. :)

Cheers
  Etienne