Richard Eckart de Castilho created MJAVADOC-814:
---------------------------------------------------
Summary: Ability to split grouped packages over multiple lines
Key: MJAVADOC-814
URL: https://issues.apache.org/jira/browse/MJAVADOC-814
Project: Maven Javadoc Plugin
Issue Type: New Feature
Components: javadoc
Affects Versions: 3.10.0
Reporter: Richard Eckart de Castilho
When configuring groups, the packages in the group need to be written on a
single line separated with colons.
{noformat}
<groups>
<group>
<title>Core</title>
<packages>
org.apache.uima.analysis_component:org.apache.uima.analysis_engine
</packages>
</group>
</groups>
{noformat}
If there are many packages that can not easily be captured using a prefix
pattern, this yields a very long line.
It would be greate if one could split the packages over multiple lines such as
{noformat}
<groups>
<group>
<title>Core</title>
<packages>
org.apache.uima.analysis_component:
org.apache.uima.analysis_engine
</packages>
</group>
</groups>
{noformat}
The code internally already calls
{{org.apache.maven.plugins.javadoc.JavadocUtil.quotedArgument(String)}} to
sanitze the line breaks away, but it seems the whitespace still breaks it and
javadoc tool in the end only recognizes the first package in the multi-line
group.
Even nicer may be.
{noformat}
<groups>
<group>
<title>Core</title>
<packages>
<package>org.apache.uima.analysis_component</package>
<package>org.apache.uima.analysis_engine</package>
</packages>
</group>
</groups>
{noformat}
--
This message was sent by Atlassian Jira
(v8.20.10#820010)