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

"combine.children='append'" not being honored in <reporting/>

    XMLWordPrintableJSON

Details

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

    Description

      I'm trying to combine multiple maven-javadoc-plugin configuration stanzas such that child modules can append <link/> elements to those specified by the parent. This supposedly can be done by adding the attribute "combine.children='append'" to the <links/> element in the child module's <configuration/> element, like so:

          <reporting>
              <plugins>
                  <plugin>
                      <artifactId>maven-javadoc-plugin</artifactId>
                      <configuration>
                          <links combine.children="append">
                              <link>http://static.springframework.org/spring/docs/2.5.x/api/</link>
                          </links>
                      </configuration>
                  </plugin>
              </plugins>
          </reporting>
      

      What actually happens is that the child module's configuration reflects only the single <link/>, and not any <link/> elements also defined in the parent. The output of mvn help:effective-pom bears this out. Putting the plugin configuration into the <build/> element instead of <reporting/> shows the correct combination occurring (except that the report is obviously not configured that way...).

      The attached tarball contains a barebones multi-module project that shows this bug, as well as the output of help:effective-pom in separate files. I've also included the output of mvn -X help:effective-pom in the file build.log.

      Attachments

        1. maven_config_bug.tgz
          36 kB
          Brian Lalor

        Issue Links

          Activity

            People

              Unassigned Unassigned
              blalor Brian Lalor
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: