XHTML 1 schema annotations

I'm writing an XML editor, in which element annotations are displayed. 
However, it can only display element-related annotations when there is 
an explicit (i.e. xml) relation between the element definition and the 
annotation.
Also, I think it would be conceptually better (by adding a meaning to 
the relationship element-annotation) to write for instance:

   <xs:element name="hr">
     <xs:annotation>
       <xs:documentation>
       horizontal rule
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

instead of:

   <xs:annotation>
     <xs:documentation>
     =================== Horizontal 
Rule ==================================
     </xs:documentation>
   </xs:annotation>

   <xs:element name="hr">
     <xs:complexType>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

or to write:

   <xs:element name="dl">
     <xs:annotation>
       <xs:documentation>
       definition list
       </xs:documentation>
     </xs:annotation>
     <xs:complexType>
       <xs:choice maxOccurs="unbounded">
         <xs:element ref="dt"/>
         <xs:element ref="dd"/>
       </xs:choice>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

   <xs:element name="dt">
     <xs:annotation>
       <xs:documentation>
       definition term
       </xs:documentation>
     </xs:annotation>
     <xs:complexType mixed="true">
       <xs:complexContent>
         <xs:extension base="Inline">
           <xs:attributeGroup ref="attrs"/>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
   </xs:element>

instead of:

   <xs:annotation>
     <xs:documentation>
     definition lists - dt for term, dd for its definition
     </xs:documentation>
   </xs:annotation>

   <xs:element name="dl">
     <xs:complexType>
       <xs:choice maxOccurs="unbounded">
         <xs:element ref="dt"/>
         <xs:element ref="dd"/>
       </xs:choice>
       <xs:attributeGroup ref="attrs"/>
     </xs:complexType>
   </xs:element>

   <xs:element name="dt">
     <xs:complexType mixed="true">
       <xs:complexContent>
         <xs:extension base="Inline">
           <xs:attributeGroup ref="attrs"/>
         </xs:extension>
       </xs:complexContent>
     </xs:complexType>
   </xs:element>

As a side note, I've been waiting for an XML schema for XHTML for a long 
time, so I'm glad it's finally there :-)

Damien

Received on Thursday, 5 September 2002 07:10:53 UTC