Configuring Help File

If a custom <helpfile/> parameter is specified, you will be able to use it:

  • if <helpfile/> is a given file, you could use an absolute or a relative path, for instance:
    1. <project>
    2. ...
    3. <reporting> (or <build>)
    4. <plugins>
    5. <plugin>
    6. <groupId>org.apache.maven.plugins</groupId>
    7. <artifactId>maven-javadoc-plugin</artifactId>
    8. <version>2.10.4</version>
    9. <configuration>
    10. <helpfile>${basedir}/path/to/your/helpfile</helpfile>
    11. ...
    12. </configuration>
    13. </plugin>
    14. </plugins>
    15. ...
    16. </reporting> (or </build>)
    17. ...
    18. </project>
  • since 2.6, <helpfile/> could be a resource in your project directory, i.e. src/main/java, src/main/resources or src/main/javadoc, for instance:
    1. <project>
    2. ...
    3. <reporting> (or <build>)
    4. <plugins>
    5. <plugin>
    6. <groupId>org.apache.maven.plugins</groupId>
    7. <artifactId>maven-javadoc-plugin</artifactId>
    8. <version>2.10.4</version>
    9. <configuration>
    10. <helpfile>path/to/your/resource/help-doc.html</helpfile>
    11. ...
    12. </configuration>
    13. </plugin>
    14. </plugins>
    15. ...
    16. </reporting> (or </build>)
    17. ...
    18. </project>
  • since 2.6, <helpfile/> could be a resource in the Javadoc plugin dependencies, for instance:
    1. <project>
    2. ...
    3. <build>
    4. <plugins>
    5. <plugin>
    6. <groupId>org.apache.maven.plugins</groupId>
    7. <artifactId>maven-javadoc-plugin</artifactId>
    8. <version>2.10.4</version>
    9. <configuration>
    10. <helpfile>path/to/your/resource/help-doc.html</helpfile>
    11. </configuration>
    12. <dependencies>
    13. <dependency>
    14. <groupId>groupId</groupId>
    15. <artifactId>artifactId</artifactId>
    16. <version>version</version>
    17. </dependency>
    18. </dependencies>
    19. </plugin>
    20. </plugins>
    21. ...
    22. </build>
    23. ...
    24. </project>