[jira] [Comment Edited] (MJAVADOC-368) Can not use a comma (,) in option additionalparam

[Michael Osipov (JIRA)]

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

Michael Osipov edited comment on MJAVADOC-368 at 12/22/15 7:11 PM:
-------------------------------------------------------------------

Given that the entire plugin parameter is ill-designed:

* wrong name, i.e., {{additionalparam}} Javadoc help taks about options and not 
parameters
* wrong documentation
* wrong semantics
...

I would close this as WONTFIX and create two new tickets:

1. Create parameter {{<additionalOptions>/<additionalOption>}} with proper 
sematics
2. Deprecate {{<additionalparam />}} in favor of 1.

This will avoid a lot of confusion.

WDYT?


was (Author: michael-o):
Given that the entire plugin parameter is ill-designed:

* wrong name, i.e., {{additionalparam}}
* wrong documentation
* wrong semantics
...

I would close this as WONTFIX and create two new tickets:

1. Create parameter {{<additionalOptions>/<additionalOption>}} with proper 
sematics
2. Deprecate {{<additionalparam />}} in favor of 1.

This will avoid a lot of confusion.

WDYT?


> Can not use a comma (,) in option additionalparam
> -------------------------------------------------
>
>                 Key: MJAVADOC-368
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-368
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>    Affects Versions: 2.9
>            Reporter: Andy Schönemann
>
> I would like to set an additional parameter for javadoc like
> {{<additionalparam>-header &apos;A,B&apos;</additionalparam>}}
> But this is not possible! Every comma here separates the string into 
> different parameters. So I'm not able to set parameters including commas.
> Furthermore, the options name is {{additionalparam}} and NOT 
> {{additionalparamS}}. So it should not be possible to set multiple parameters 
> here.
> I also tried 
> {{<additionalparam>-header &apos;A&#44;B&apos;</additionalparam>}}
> but this doesn't work either.
> [Plugin 
> documentation|http://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#additionalparam]
>  



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)