OpenJDK 11 build generates `ja_JP.UTF8` manpages by default

[Erik Joelsson]

On 2020-06-08 06:57, Benjamin Asbach wrote:
> Hello Erik,
>
> I was not talking about the change in how to build the docs. I was 
> talking about the intention of generating ja_JP manpages by default in 
> OpenJDK11 build.
>
> Since they're generated by default many distributions - e.g. Ubuntu - 
> bundle them [1]:
>
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jar.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jarsigner.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/javac.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/javadoc.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/javap.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jcmd.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jdb.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jdeps.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jinfo.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jmap.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jps.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jrunscript.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jstack.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jstat.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/jstatd.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/rmic.1.gz
> /usr/lib/jvm/java-11-openjdk-amd64/man/ja_JP.UTF-8/man1/serialver.1.gz
>
Not sure what the question actually is but will try to cover as much as 
I can. I see no bug here but here is what I know.

In OpenJDK version 11, there are a bunch of man pages in the source 
(including ja_JP translations) which we by default include in the 
generated image. These man pages are outdated as nobody is keeping them 
up to date. OracleJDK builds of the same stopped including them for this 
reason, but at the time, we left them in OpenJDK in case someone else 
would be interested in keeping them up to date. I believe this happened 
already in JDK 9.

In JDK 12, these man pages were removed and replaced by updated man 
pages. These updated pages do not have translated version.

So, in JDK 11, the build will include all the old and outdated man 
pages, including the ja_JP translations, and in JDK 14 the build will 
include all the updated, English only, man pages.

It's possible to disable manpages in either JDK version with the 
configure option --disable-manpages.

/Erik

> Greetings Benjamin
>
> [1] 
> https://ubuntu.pkgs.org/18.04/ubuntu-updates-main-amd64/openjdk-11-jdk-headless_11.0.7+10-2ubuntu2~18.04_amd64.deb.html
>
> On 2020-06-08 15:32, Erik Joelsson wrote:
>> On 2020-06-08 06:15, Benjamin Asbach wrote:
>>> Hello,
>>>
>>> I currently try to improve the NixOS OpenJDK build for OpenJDK 11. I 
>>> recognized that the make target "all" creates manpages for 
>>> "ja_JP.UTF8" [1].
>>>
>>> I also tried compiling OpenJDK 14 which does not generate this kind 
>>> of output.
>>>
>>> So I wonder if this done intentionally or a bug?
>>>
>> Man pages have changed since JDK 11, it's not a bug. It happened here:
>>
>> https://bugs.openjdk.java.net/browse/JDK-8178317
>>
>> /Erik
>>
>>> Thanks in advance
>>> Benjamin
>>>
>>> [1] 
>>> https://hg.openjdk.java.net/jdk-updates/jdk11u/file/46d4984bb3c6/make/Images.gmk