Specify, whether to generate multipart annotation headings.

A human-written description of an XML schema or schema component is generated from the content of an <xs:documentation> element found within the <xs:annotation> element that is direct child of an XSD element defining the schema or component. For example:


<xs:element name="SomeElement">
  <xs:annotation>
    <xs:documentation>
      element description
    <xs:documentation>
  </xs:annotation>
  ...
</xs:element>

However, <xs:annotation> elements are allowed to have multiple <xs:documentation> children (and <xs:schema> element may have even multiple <xs:annotation> children). In that case, the result description text will be produced from the content of all <xs:documentation> element found by the path:

component/annotation/documentation

When the component description is generated from the content of multiple <xs:documentation> elements, each of them will produce a separate part of the entire description text. In that case, each part will have a separate heading, so the whole text will look like the following:

Annotation 1:

Text 1...

Annotation 2:

Text 2 ...
...

This parameter allows you to suppress the generation of part headings, so the result text will be:

Text 1...
Text 2 ...
...