Description
Javadoc suffers from the following two problems:
- During HTML generatation Locale#getDefault() is invoked and all generated content maybe localized, e.g. German, Japanese. That is a surprise for most since they expect to see English content. One has to force with <locale>en</locale>.
- In the past JDKs Oracle now started to even localize stdout and stderr output to those languages (see https://github.com/openjdk/jdk21u-dev/tree/master/src/jdk.javadoc/share/classes/jdk/javadoc/internal/tool/resources), even more could come. This causes a regression with
MJAVADOC-751which relies on English language output to work.
Therefore, we will introduce a new parameter forceRootLocale which will add -J-Duser.language= -J-Duser.country= and will result in Locale#ROOT. Both will force generated HTML output and std output to be in English. Those who still need generated content in a specific language can pass <locale/> and it will work independently of the std output.
Attachments
Issue Links
- fixes
-
MJAVADOC-751 No warnings for localized output
-
- Closed
-
- links to