[jira] (MJAVADOC-378) Confusing param 'outputDirectory' for javadoc goal

["Herve Boutemy (JIRA)" <ji...@codehaus.org>]

    [ https://jira.codehaus.org/browse/MJAVADOC-378?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=347667#comment-347667 ] 

Herve Boutemy commented on MJAVADOC-378:
----------------------------------------

IIRC, outputDirectory is used when m-javadoc-p is used as mojo, not report

I understand this is confusing, but when you're using a report as a mojo (shared implementation in maven-reporting-impl), you don't have site's reporting output directory

any idea welcome

> Confusing param 'outputDirectory' for javadoc goal
> --------------------------------------------------
>
>                 Key: MJAVADOC-378
>                 URL: https://jira.codehaus.org/browse/MJAVADOC-378
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>    Affects Versions: 2.9.1
>         Environment: n/a
>            Reporter: Anders Hammar
>            Priority: Minor
>
> The param 'outputDirectory' seems to be misleading. Does it serve a purpose?
> Reading the docs at:
> http://maven.apache.org/plugins/maven-javadoc-plugin/examples/output-configuration.html
> the params to use to change where the javadoc should be generated is 'reportOutputDirectory' and 'destDir', not 'outputDirectory'.
> Also, very confusingly, the user property 'destDir' is used for both the 'destDir' and the 'outputDirectory' params. Which can't be right as 'destDir' should be relative to 'reportingOutputDirectory'.
> All is very confusing. 'outputDirectory' doesn't seems to be used as it's default value is not where the javadoc is generated.



--
This message was sent by Atlassian JIRA
(v6.1.6#6162)