keep schema in spec in synch with the source

Signed-off-by: Lukas Jungmann <lukas.jungmann@oracle.com>

spec/src/main/asciidoc/ch12-xml-or-mapping-descriptor.adoc

@@ -1504,6 +1504,7 @@ object/relational mapping schema for use with the Persistence API.
       </xsd:documentation>
     </xsd:annotation>
     <xsd:sequence>
+      <xsd:element name="comment" type="xsd:string" minOccurs="0" />
       <xsd:element name="check-constraint" type="orm:check-constraint"
                    minOccurs="0" maxOccurs="unbounded"/>
     </xsd:sequence>
@@ -1518,7 +1519,6 @@ object/relational mapping schema for use with the Persistence API.
     <xsd:attribute name="length" type="xsd:int"/>
     <xsd:attribute name="precision" type="xsd:int"/>
     <xsd:attribute name="scale" type="xsd:int"/>
-    <xsd:attribute name="comment" type="xsd:string"/>
   </xsd:complexType>
 
 <!-- **************************************************** -->
@@ -2192,6 +2192,7 @@ object/relational mapping schema for use with the Persistence API.
       </xsd:documentation>
     </xsd:annotation>
     <xsd:sequence>
+      <xsd:element name="comment" type="xsd:string" minOccurs="0" />
       <xsd:element name="foreign-key" type="orm:foreign-key"
                    minOccurs="0"/>
       <xsd:element name="check-constraint" type="orm:check-constraint"
@@ -2206,7 +2207,6 @@ object/relational mapping schema for use with the Persistence API.
     <xsd:attribute name="column-definition" type="xsd:string"/>
     <xsd:attribute name="options" type="xsd:string"/>
     <xsd:attribute name="table" type="xsd:string"/>
-    <xsd:attribute name="comment" type="xsd:string"/>
   </xsd:complexType>
 
 <!-- **************************************************** -->
@@ -2234,6 +2234,7 @@ object/relational mapping schema for use with the Persistence API.
       </xsd:documentation>
     </xsd:annotation>
     <xsd:sequence>
+      <xsd:element name="comment" type="xsd:string" minOccurs="0" />
       <xsd:sequence>
         <xsd:element name="join-column" type="orm:join-column"
                      minOccurs="0" maxOccurs="unbounded"/>
@@ -2256,7 +2257,6 @@ object/relational mapping schema for use with the Persistence API.
     <xsd:attribute name="name" type="xsd:string"/>
     <xsd:attribute name="catalog" type="xsd:string"/>
     <xsd:attribute name="schema" type="xsd:string"/>
-    <xsd:attribute name="comment" type="xsd:string"/>
     <xsd:attribute name="options" type="xsd:string"/>
   </xsd:complexType>
 
@@ -3120,6 +3120,7 @@ object/relational mapping schema for use with the Persistence API.
      </xsd:annotation>
      <xsd:sequence>
        <xsd:sequence>
+         <xsd:element name="comment" type="xsd:string" minOccurs="0" />
          <xsd:element name="primary-key-join-column"
                       type="orm:primary-key-join-column"
                       minOccurs="0" maxOccurs="unbounded"/>
@@ -3139,7 +3140,6 @@ object/relational mapping schema for use with the Persistence API.
     <xsd:attribute name="name" type="xsd:string" use="required"/>
     <xsd:attribute name="catalog" type="xsd:string"/>
     <xsd:attribute name="schema" type="xsd:string"/>
-    <xsd:attribute name="comment" type="xsd:string"/>
     <xsd:attribute name="options" type="xsd:string"/>
   </xsd:complexType>
 
@@ -3249,6 +3249,7 @@ object/relational mapping schema for use with the Persistence API.
       </xsd:documentation>
     </xsd:annotation>
     <xsd:sequence>
+      <xsd:element name="comment" type="xsd:string" minOccurs="0" />
       <xsd:element name="unique-constraint" type="orm:unique-constraint"
                    minOccurs="0" maxOccurs="unbounded"/>
       <xsd:element name="index" type="orm:index"
@@ -3259,7 +3260,6 @@ object/relational mapping schema for use with the Persistence API.
     <xsd:attribute name="name" type="xsd:string"/>
     <xsd:attribute name="catalog" type="xsd:string"/>
     <xsd:attribute name="schema" type="xsd:string"/>
-    <xsd:attribute name="comment" type="xsd:string"/>
     <xsd:attribute name="options" type="xsd:string"/>
   </xsd:complexType>