Skip to content

JavaDoc generated from XML may contain malformed html #581

Open
@Lukiz

Description

@Lukiz

I have sample xsd that looks like this:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Data">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Age" type="xs:unsignedByte" />
                <xs:element name="Under18" type="xs:boolean" >
                    <xs:annotation>
                        <xs:documentation>Resolve age &lt;&gt; 18</xs:documentation>
                    </xs:annotation>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

After generating java code the entity for less-then sign &lt; is not preserved as escaped entity but replaced with proper character <.

    /**
     * Resolve age <> 18
     * 
     */
    @XmlElement(name = "Under18")
    protected boolean under18;

It leads to invalid HTML.
Our project has check for valid JavaDoc and fails on malformed HTML.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug-externalIssue concerns an external dependency

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions