[
https://issues.apache.org/jira/browse/MJAVADOC-469?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16729898#comment-16729898
]
Ilya Basin edited comment on MJAVADOC-469 at 12/27/18 9:52 PM:
---------------------------------------------------------------
bq. I don't agree with this. It is an array or args which has to be provided as
such. This is not a string.
If it's an array already, then how do you explain this:
https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#additionalOptions
bq. This value should include quotes as necessary for parameters that include
spaces.
Whose idea was it?
------------------------
bq. I don't understand in general why the argfile syntax is different to the
command line.
Maybe they wanted to allow something like:
{code}
"really/stra \r\t\n\" nge/path/"
{code}
was (Author: basinilya):
bq. I don't agree with this. It is an array or args which has to be provided as
such. This is not a string.
If it's an array already, then how do you explain this:
https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#additionalOptions
bq. This value should include quotes as necessary for parameters that include
spaces.
Whose idea was it?
bq. I don't understand in general why the argfile syntax is different to the
command line.
Maybe they wanted to allow something like:
{code}
"really/stra \r\t\n\" nge/path/"
{code}
> javadoc-plugin does not double backslashes in argument file
> -----------------------------------------------------------
>
> Key: MJAVADOC-469
> URL: https://issues.apache.org/jira/browse/MJAVADOC-469
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Components: javadoc
> Affects Versions: 2.10.4
> Reporter: Ilya Basin
> Assignee: Michael Osipov
> Priority: Major
>
> On Windows `generate-rest-docs` goal of `maven-jira-plugin` calls
> `maven-javadoc-plugin` with:
> {code}additionalparam: -output
> "C:\path\to\target\classes\resourcedoc.xml"{code}
> If this argument was passed to `javadoc.exe` directly, I'm pretty sure this
> would work. However, the javadoc plugin generates an argument file[1] named
> "options" and executes:
> {code}javadoc.exe ... @options{code}
> The file contains all arguments with unescaped backslashes, although javadoc
> command documentation[2] suggests:
> {quote}If a filename contains embedded spaces, put the whole filename in
> double quotes, and double each backslash ("My Files\\Stuff.java"){quote}
> javadoc plugin version "2.4" is hardcoded in jira plugin, but I see no
> related changes in "2.10.4" in AbstractJavadocMojo.addCommandLineOptions() .
> [1]: https://maven.apache.org/plugins/maven-javadoc-plugin/
> [2]:
> http://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#argumentfiles
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
