[
https://issues.apache.org/jira/browse/MJAVADOC-752?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Henning Schmiedehausen updated MJAVADOC-752:
--------------------------------------------
Component/s: javadoc
(was: jar)
> Setting the output directory affects dependencySourceIncludes
> -------------------------------------------------------------
>
> Key: MJAVADOC-752
> URL: https://issues.apache.org/jira/browse/MJAVADOC-752
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Components: javadoc
> Affects Versions: 3.5.0
> Reporter: Henning Schmiedehausen
> Priority: Major
>
> I have a large, multi-module build (github.com/jdbi/jdbi) where we build
> separate javadoc jars for all modules. These are built with a javadoc plugin
> configuration that writes the javadoc information into target/apidocs. This
> works fine.
> At the end of our build we aggregate all the separate javadoc modules into a
> single documentation site.
> This is the javadoc configuration for that:
> {{<configuration>
>
> <outputDirectory>${project.build.directory}/generated-docs/apidocs</outputDirectory>
> <includeDependencySources>true</includeDependencySources>
> <dependencySourceIncludes>
> <dependencySourceInclude>org.jdbi:*</dependencySourceInclude>
> </dependencySourceIncludes>
> <doctitle>Jdbi3 ${project.version} API</doctitle>
> <windowtitle>Jdbi3 ${project.version} API</windowtitle>
> </configuration>
> }}
> The reactor build tries to load the included modules (org.jdbi:*) but does
> not look into the target/apidocs folder where the javadoc was written but
> from target/generated-docs/apidocs. Setting the output directory for the
> aggregation module affects the directory that the javadoc plugin uses to
> resolve the dependencySourceInclude directory.
> Expected effect: Setting the output directory only affects the place where
> the aggregated doc is written. The plugin still picks up the existing javadoc
> from the target/apidocs folders in the included modules
> Observed effect: Setting the output directory makes the plugin look at the
> wrong folders for the included moduled and does not find the existing
> documentation
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
