Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

JAXB: How to generate English Javadoc

When I generate JAXB classes using the maven-jaxb2-plugin I get classes with partial(!?) German Javadoc. (My default locale: de_CH)

What I want: English Javadoc

I tried to set the maven opts: -Duser.language=en -Duser.country=US but it had no effect.

How can I generate JAXB classes with English Javadoc?

Here is the Javadoc for some JAXB classes with partial German Javadoc: http://drombler.sourceforge.net/DromblerACP/docs/site/0.2.1-SNAPSHOT/apidocs/org/drombler/acp/core/action/jaxb/package-frame.html

Here is the according XSD: http://sourceforge.net/p/drombler/drombler-acp/ci/default/tree/drombler-acp-core-action/src/main/resources/actions.xsd

Here is the according POM: http://sourceforge.net/p/drombler/drombler-acp/ci/default/tree/drombler-acp-core-action/pom.xml

Related JAXB Issue:

https://java.net/jira/browse/JAXB-1001

Any workaround?

like image 880
Puce Avatar asked Mar 14 '14 15:03

Puce


2 Answers

You can pass arbitrary properties to XJC using the args/arg element in the configuration of the maven-jaxb2-plugin:

<configuration>
    <extension>true</extension>
    <args>
        <arg>-Duser.language=en</arg>
    </args>
</configuration>

These arguments will be just passed to XJC.

However I have no idea if -Duser.language=en -Duser.country=US are the right options. Anyway the args/arg will be passed to XJC. If it does not work please file an issue here.

Disclaimer: I'm the author of maven-jaxb2-plugin.

Update

This feature is implemented in the version 0.10.0. Now you can do the following:

        <plugin>
            <groupId>org.jvnet.jaxb2.maven2</groupId>
            <artifactId>maven-jaxb2-plugin</artifactId>
            <configuration>
                <locale>es</locale>
            </configuration>
        </plugin>
like image 120
lexicore Avatar answered Oct 19 '22 14:10

lexicore


in windows command line:

> SET JAVA_TOOL_OPTIONS=-Duser.language=en -Duser.country=US -Dfile.encoding=UTF-8
> xjc .

tested with jdk9

like image 24
benez Avatar answered Oct 19 '22 15:10

benez