Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-605

Exclude packages does not work as described in documentation

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Duplicate
    • 3.1.0
    • None
    • None
    • None

    Description

      This functionality worked in 3.0.1 and failed after upgrading to 3.1.0
      The following syntax is shown in the [documentation|https://maven.apache.org/plugins/maven-javadoc-plugin/examples/exclude-package-names.html] :

      <excludePackageNames>com.mycompany.myapp.package1.:com.mycompany.myapp.package2:.util.*</excludePackageNames>

      In this example the documentation states that the following packages are excluded:

      • com.mycompany.myapp.package2
      • com.mycompany.myapp.package2.subpackage4
      • com.mycompany.myapp.package2.subpackage5
      • com.mycompany.myapp.package2.util

      This was correct in 3.0.1, however since upgrading to 3.1.0, the following behavior is observed:

      Scenario 1 (which does not match current documentation)

      <excludePackageNames>com.mycompany.myapp.package2</excludePackageNames>

       Excluded

      • com.mycompany.myapp.package2

       Included

      • com.mycompany.myapp.package2.subpackage4
      • com.mycompany.myapp.package2.subpackage5
      • com.mycompany.myapp.package2.util

      Scenario 2 (This matches documentation scenario)

      <excludePackageNames>com.mycompany.myapp.package2.*</excludePackageNames>

       Excluded

      • com.mycompany.myapp.package2.subpackage4
      • com.mycompany.myapp.package2.subpackage5
      • com.mycompany.myapp.package2.util

       Included

      • com.mycompany.myapp.package2

       

      Scenario 3 (This is the current workaround)

      <excludePackageNames>com.mycompany.myapp.package2:com.mycompany.myapp.package2.*</excludePackageNames>

       Excluded

      • com.mycompany.myapp.package2
      • com.mycompany.myapp.package2.subpackage4
      • com.mycompany.myapp.package2.subpackage5
      • com.mycompany.myapp.package2.util

      Attachments

        Issue Links

          Activity

            People

              rfscholte Robert Scholte
              wcollishaw William Collishaw
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: