Add documentation annotation to enumeration in Schema view?
Posted: Mon Apr 20, 2009 11:38 pm
How can I add documentation annotations to individual xs:enumeration elements to document the meaning of the respective attribute values in the Schema view of the XSD editor? (I can add them "manually" in the Text view, though.)
Anyway, that documentation does not show up in the generated HTML documentation for that schema anywhere (except for in the source component detail, of course). Is this an oversight, design decision or do I have just some documentation generation settings set wrongly?
Here's a short sample XSD to test. Mind the documentation annotations for the individual xs:enumeration values "auto" and "manual":
-Christian
Anyway, that documentation does not show up in the generated HTML documentation for that schema anywhere (except for in the source component detail, of course). Is this an oversight, design decision or do I have just some documentation generation settings set wrongly?
Here's a short sample XSD to test. Mind the documentation annotations for the individual xs:enumeration values "auto" and "manual":
Code: Select all
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="sample">
<xs:complexType>
<xs:attribute ref="mode"/>
</xs:complexType>
</xs:element>
<xs:attribute name="mode">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:annotation>
<xs:documentation>documentation for "auto"</xs:documentation>
</xs:annotation>
<xs:enumeration value="auto"/>
<xs:annotation>
<xs:documentation>documentation for "manual"</xs:documentation>
</xs:annotation>
<xs:enumeration value="manual"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:schema>