Hello.

I have the following projects:

  io7m-example/
    io7m-example-lib1
    io7m-example-lib2
    io7m-example-documentation

The io7m-example-documentation project contains documentation written
in a DocBook-like language which is processed into XHTML at build time
and then packaged up into a zip file using the assembly plugin. The
io7m-example-documentation has a dependency on both io7m-example-lib1
and io7m-example-lib2.

I'd like to include aggregated javadocs from io7m-example-lib1 and
io7m-example-lib2 in the assembly but am running into walls at every
step.

Firstly, the javadoc plugin states that the aggregate goal should be
run as a report. As far as I know, that's not an option here, because
the output of the goal (the aggregated HTML) needs to be available to
the assembly plugin that's going to run in the package phase, and
reports are only going to be run afterwards as part of site generation.

Secondly, the javadoc plugin stubbornly refuses to do anything at all.

I have the following in the io7m-example-documentation project:

      <!-- Produce aggregate dependency javadocs -->
      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9.1</version>
        <executions>
          <execution>
            <id>javadoc-aggregate</id>
            <phase>package</phase>
            <goals>
              <goal>aggregate</goal>
            </goals>
            <configuration>
              
<outputDirectory>${project.build.directory}/apidocs</outputDirectory>
              <includeDependencySources>true</includeDependencySources>
            </configuration>
          </execution>
        </executions>
      </plugin>

      <!-- Produce documentation archive -->
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>2.4</version>
        <configuration>
          <descriptors>
            <descriptor>src/main/assembly/documentation.xml</descriptor>
          </descriptors>
        </configuration>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>

When I run "mvn -C clean package" from the io7m-example, the
io7m-example-lib1 and io7m-example-lib2 projects are compiled and
tested. The io7m-example-documentation project is executed and an
assembly is created, but the javadoc plugin appears to do precisely
nothing. No ${project.build.directory}/apidocs is created and no
error is signalled.

Am I doing something obviously wrong here?

M

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org

Reply via email to