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

["Jesko Jochum (JIRA)" <ji...@apache.org>]

Jesko Jochum created MJAVADOC-548:
-------------------------------------

             Summary: 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: 3.0.1, 2.10.4
         Environment: Windows 7 x64
Apache Maven 3.5.4
            Reporter: Jesko Jochum


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)