You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cxf.apache.org by GitBox <gi...@apache.org> on 2019/07/11 16:03:19 UTC

[GitHub] [cxf-xjc-utils] polikarpovilya opened a new pull request #6: Javadoc multiline support improvements

polikarpovilya opened a new pull request #6: Javadoc multiline support improvements
URL: https://github.com/apache/cxf-xjc-utils/pull/6
 
 
   I found that if documentation block contains multiline comment similar to this:
   ```
   <annotation>
   	<documentation>
                       Multiline documentation of
                       attribute
   	</documentation>
   </annotation>
   ```
   then generated javadoc looks sloppy. For the example above, it will be look like this:
   >     /**
   >      * Multiline documentation of
   >      *                     attribute
   >      * 
   >      */
   >     @XmlAttribute(name = "multilineDocumentedAttribute")
   >     protected String multilineDocumentedAttribute;
   
   Unfortunately, this problem cannot be identified during tests, because the compiled class org.eclipse.jdt.core.dom.Javadoc contains TagElement with a list of fragments without extra whitespaces.
   
   Using solution from [here](https://stackoverflow.com/a/15495235), javadoc will transform into:
   >     /**
   >      * Multiline documentation of
   >      * attribute
   >      * 
   >      */
   >     @XmlAttribute(name = "multilineDocumentedAttribute")
   >     protected String multilineDocumentedAttribute;

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services