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)
