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)

Reply via email to