Plugin Documentation

This report describes goals, parameters details, requirements and sample usage of this plugin.

Goals

Goals available for this plugin:

Goal	Description
tycho-document-bundle:build-help-index	A Mojo to pre-build search help index for a plug-in.
tycho-document-bundle:configure-document-bundle-plugin	This mojo is only there
tycho-document-bundle:javadoc	Create the javadoc based API reference for this bundle. This mojo creates the javadoc documentation by calling the javadoc application from the command line. In addition it creates a ready to include toc-xml file for the Eclipse Help system. The sources for creating the javadoc are generated automatically based on the dependency that this project has. As dependency you can specify any other maven project, for example the feature project that references you other bundles. Included features will be added to the list. The javadoc executable path is determined in this order: `executable` argument of the `javadocOptions` configuration element, if available active Maven toolchain `java.home` system property `JAVA_HOME` environment setting if none of the above can be used, the javadoc executable is invoked without an explicit path and relies on the operating system PATH variable
tycho-document-bundle:schema-to-html	This mojo provides the functionality of org.eclipse.pde.internal.core.ant.ConvertSchemaToHTML

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven	3.9.6
JDK	17

System Requirements History

The following specifies the minimum requirements to run this Maven plugin for historical versions:

Plugin Version	Maven	JDK
from 4.0.0 to 4.0.10	3.9.0	17
from 3.0.0 to 3.0.5	-	17
from 2.0.0 to 2.7.5	-	11
from 1.1.0 to 1.7.0	-	8
from 0.23.0 to 1.0.0	-	7
0.22.0	-	6
from 0.20.0 to 0.21.0	-	5

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.eclipse.tycho.extras</groupId>
          <artifactId>tycho-document-bundle-plugin</artifactId>
          <version>5.0.0-SNAPSHOT</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.eclipse.tycho.extras</groupId>
        <artifactId>tycho-document-bundle-plugin</artifactId>
      </plugin>
      ...
    </plugins>
  </build>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"