Javadoc multiline support improvements

[polikarpovilya]

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, javadoc will transform into:

/**
 * Multiline documentation of
 * attribute
 * 
 */
@XmlAttribute(name = "multilineDocumentedAttribute")
protected String multilineDocumentedAttribute;

[don-vip]

This would be a nice enhancement.

[ffang]

Hi @polikarpovilya,

Thanks for the contribution!

Could you please create a CXF XJC issue here and link to this PR?

Best Regards
Freeman

[polikarpovilya]

Done.
https://issues.apache.org/jira/browse/CXFXJC-43

[coheigea]

Are the unit tests in JavadocPluginTest.java corresponding to the added test resources missing?