Enunciate не генерирует описания из xs: документация по xs: elements

Question

Мы используем версию maven-enunciate-plugin 1.26.2 и сталкиваемся с проблемой во время генерации нашей документации. Мы добавили комментарии к нашим XSDs следующим образом:

<xs:complexType name="PagingParameters"> 
    <xs:annotation> 
     <xs:documentation>information about PagingParameters</xs:documentation> 
    </xs:annotation> 
    <xs:sequence> 
     <xs:choice minOccurs="0"> 
      <xs:element name="StartPos" type="xs:long" nillable="false">      
       <xs:annotation> 
        <xs:documentation>information about StartPos</xs:documentation> 
       </xs:annotation> 
      </xs:element> 
      <xs:element name="FollowOnBrowseToken" type="xs:string" nillable="false"> 
       <xs:annotation> 
        <xs:documentation>information about token</xs:documentation> 
       </xs:annotation> 
      </xs:element> 
     </xs:choice> 
     <xs:element name="NoOfRecords" type="xs:long" nillable="false"> 
      <xs:annotation> 
       <xs:documentation>information about noOfRecords</xs:documentation> 
      </xs:annotation> 
     </xs:element> 
    </xs:sequence> 
</xs:complexType> 

Первый набор получает разобраны и выходы правильно на странице излагают, однако все комментарии для отдельных элементов в нем полностью утрачены. Как ни странно, это происходит только с последовательностями элементов, но перечисления работают нормально.

Я пробовал несколько различных способов форматирования документации, в том числе использование блоков CDATA, но ничего, похоже, не работает.

Что мне не хватает? При необходимости я могу включить больше XSD.

Answer 1

Вычисление использует JavaDoc для анализа его документации. Можете ли вы подтвердить, что JavaDoc появляется в сгенерированных классах Java?

Answer 2

Javadoc сделать НЕ отображаться в сгенерированных классов, но затем JAXB переписывает это со своим стандартным комментарием, как это:

/** 
* Gets the value of the X property. 
* 
* @return 
*  possible object is 
*  {@link String } 
*  
*/ 
public String getX() { 

, но до сих пор нет Javadoc не показан в enuciate