[jira] [Commented] (MJAVADOC-548) Misleading Setting "excludePackageNames"

["Robert Scholte (JIRA)" <ji...@apache.org>]

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

Robert Scholte commented on MJAVADOC-548:
-----------------------------------------

Your description doesn't match with how this parameter should work/is described, see https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#excludePackageNames
Also notice that these are translated to the javadoc tool arguments {{-exclude  packagename1:packagename2:...}}
Please provide a minimal project to reproduce your issue.


> Misleading Setting "excludePackageNames"
> ----------------------------------------
>
>                 Key: MJAVADOC-548
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-548
>             Project: Maven Javadoc Plugin
>          Issue Type: Improvement
>          Components: javadoc
>    Affects Versions: 2.10.4, 3.0.1
>         Environment: Windows 7 x64
> Apache Maven 3.5.4
>            Reporter: Jesko Jochum
>            Priority: Minor
>
> The setting {{excludePackageNames}} is not working, as I would expect, or should be renamed to something like {{excludePathNames}} with an updated description, to reveal what it is really doing.
> I have the default layout for the sources, i.e. they get stored in the {{${project.basedir}\src\main\java}} subfolder of my project.
>  For testing purposes I sometimes create classes in the subpackage {{my.companyname.temp}}, which I do not want to have included in the generated javadoc, why I use the following {{excludePackageNames}} setting:
> {noformat}
> ...
> <!-- Exclude files in temporary packages -->
> <excludePackageNames>*.temp.*</excludePackageNames>
> ...
> {noformat}
> in my {{pom.xml}}.
> By doing this, I wanted to exclude all .java sources in the folders {{${project.basedir}\src\main\java*\temp*}} from the javadoc generation, but what I got was an exclusion of all .java sources, if there is a subfolder with the name {{temp}} in any segment of the path, even in the {{$\{project.basedir}}}.
> So, after moving the project into e.g. the folder {{D:\temp\}} no javadoc gets generated at all.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)