Ilya P created CXFXJC-43:
----------------------------
Summary: Javadoc multiline support improvements
Key: CXFXJC-43
URL: https://issues.apache.org/jira/browse/CXFXJC-43
Project: CXF XJC Utils
Issue Type: Improvement
Components: Maven Plugin
Reporter: Ilya P
I found that if documentation block contains multiline comment similar to this:
{noformat}
<annotation>
<documentation>
Multiline documentation of
attribute
</documentation>
</annotation>{noformat}
then generated javadoc looks sloppy. For the example above, it will be look
like this:
{code:java}
/**
* Multiline documentation of
* attribute
*
*/
@XmlAttribute(name = "multilineDocumentedAttribute")
protected String multilineDocumentedAttribute; {code}
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:
{code:java}
/**
* Multiline documentation of
* attribute
*
*/
@XmlAttribute(name = "multilineDocumentedAttribute")
protected String multilineDocumentedAttribute;{code}
Here is PR on github: https://github.com/apache/cxf-xjc-utils/pull/6
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
