[ http://jira.codehaus.org/browse/MJAVADOC-8?page=all ]

Brett Porter updated MJAVADOC-8:
--------------------------------

    Fix Version: 2.0

> <group> parameter seems hard to use
> -----------------------------------
>
>          Key: MJAVADOC-8
>          URL: http://jira.codehaus.org/browse/MJAVADOC-8
>      Project: Maven 2.x Javadoc Plugin
>         Type: Bug

>  Environment: Windows XP
>     Reporter: Martin Desruisseaux
>     Priority: Minor
>      Fix For: 2.0

>
>
> The <group> parameter is a comma-separated list. A looks into the source code 
> suggest that the plugin uses StringTokenizer for splitting the String around 
> comas, no matter if the coma were inside quotes or not. Next, the tokens are 
> put between quotes if they contains spaces. This means that the following 
> parameter:
>   <group>
>       Feature Geometry   org.geotools.geometry*
>   </group>
> is translated into the following javadoc options:
>     -group "Feature Geometry   org.geotools.geometry*"
> when it should has been:
>     -group "Feature Geometry"   "org.geotools.geometry*"
> Putting "Feature Geometry" between quotes in the <group> parameter doesn't 
> help (it produces an other unexpected result). We really need a space between 
> the title and the packages; it is part of javadoc tools specification, and 
> current maven-javadoc-plugin seems to prevent that.
> Furthermore, because of the coma-delimited nature of the <group> argument, we 
> can't put coma in group title.
> I would like to suggest to replace the current <group> parameter syntax by 
> the same one than Ant:
>   <group title="Feature Geometry" packages="org.geotools.geometry*"/>

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to