You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by "Brett Porter (JIRA)" <ji...@codehaus.org> on 2006/02/28 04:11:35 UTC
[jira] Commented: (MJAVADOC-8) parameter seems hard to use
[ http://jira.codehaus.org/browse/MJAVADOC-8?page=comments#action_59611 ]
Brett Porter commented on MJAVADOC-8:
-------------------------------------
should probably be:
<groups>
<group>
<title>...</title>
<packages>...</packages>
</group>
...
</groups>
> <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
>
>
> 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: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org