[ 
https://issues.apache.org/jira/browse/MJAVADOC-814?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17958183#comment-17958183
 ] 

Olivier Lamy commented on MJAVADOC-814:
---------------------------------------

This project has moved from Jira to GitHub Issues. This issue was migrated to 
[apache/maven-javadoc-plugin#1192|https://github.com/apache/maven-javadoc-plugin/issues/1192].
 

> Ability to split grouped packages over multiple lines
> -----------------------------------------------------
>
>                 Key: MJAVADOC-814
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-814
>             Project: Maven Javadoc Plugin (Moved to GitHub Issues)
>          Issue Type: New Feature
>          Components: javadoc
>    Affects Versions: 3.10.0
>            Reporter: Richard Eckart de Castilho
>            Assignee: Olivier Lamy
>            Priority: Major
>             Fix For: 3.11.2
>
>
> 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