XJC Javadoc generation : locale is ignored

[laurentschoelens]

See highsource/jaxb-tools#538

I'm trying to generate Java classes starting from an XSD.
The XSD contains documentation in multiple languages:

<xs:annotation>
    <xs:documentation xml:lang="de">DE: person description</xs:documentation>
    <xs:documentation xml:lang="en">EN: person description</xs:documentation>
    <xs:documentation xml:lang="fr">FR: person description</xs:documentation>
    <xs:documentation xml:lang="it">IT: person description</xs:documentation>
</xs:annotation>

In the pom.xml I defined the locale to be german:

    <build>
        <plugins>
            <plugin>
                <groupId>org.jvnet.jaxb</groupId>
                <artifactId>jaxb-maven-plugin</artifactId>
                <version>4.0.3</version>
...
                <configuration>
                    <locale>de</locale>
                </configuration>
            </plugin>
        </plugins>
    </build>

The documentation in the generated Java classes is set to italian, the last entry of <xs:documentation>.

public class Person {

    /**
     * IT: name description
     * 
     */
    @XmlElement(required = true)
    protected String name;

An example micro-project can be found here

[laurentschoelens]

@ggiambo

[laurentschoelens]

@ggiambo :

The documentation tag inside the annotation tag seems to be only 0..1, so multiple documentation tag is invalid definition and only the last is parsed by XJC during XSD-JAVA generation :
See com.sun.tools.xjc.reader.xmlschema.bindinfo.BindInfo

jaxb-ri/jaxb-ri/xjc/src/main/java/com/sun/tools/xjc/reader/xmlschema/bindinfo/BindInfo.java

Lines 60 to 71 in d60e9b9

	public final class BindInfo implements Iterable<BIDeclaration> {
	private BGMBuilder builder;
	@XmlLocation
	private Locator location;
	/**
	* Documentation taken from {@code <xs:documentation>s}.
	*/
	@XmlElement(namespace=XMLConstants.W3C_XML_SCHEMA_NS_URI)
	private Documentation documentation;