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

[Benjamin Asbach]

I guess I was under the impression that there's a configuration to 
generate all kind of man page languages and was puzzled that ja_JP was 
generated by default.

Thanks for clearification.

Greetings
Benjamin

On 2020-06-08 16:23, Erik Joelsson wrote:
> 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