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

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

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Duplicate
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: None
    • Labels:
      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

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

                Dates

                • Created:
                  Updated:
                  Resolved: