[MJAVADOC-701] javadoc site is broken for projects that contain modules

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.3.1
• Fix Version/s: 3.6.0
• Component/s: javadoc

Environment

Maven home: /usr/local/Cellar/maven/3.8.4/libexec
Java version: 17.0.1, vendor: Eclipse Adoptium, runtime: /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "11.5", arch: "x86_64", family: "mac"

• Assignee: Henning Schmiedehausen
• Reporter: Henning Schmiedehausen
• Created: 06/Dec/21 20:00
• Updated: 13/Sep/23 01:47
• Resolved: 08/Sep/23 18:01

Description

How to reproduce:

 

% git clone https://github.com/hgschmie/pg-embedded.git

% cd pg-embedded

% git checkout -b 4.0-branch pg-embedded-4.0

% ./mvnw clean site

% ls target/site/apidocs

allclasses-index.html     jquery-ui.overrides.css    script-dir
allpackages-index.html    legal                      script.js
constant-values.html      member-search-index.js     search.js
de                        module-search-index.js     src-html
deprecated-list.html      overview-summary.html      stylesheet.css
element-list              overview-tree.html         tag-search-index.js
index-all.html            package-search-index.js    type-search-index.js
index.html                resources

% ./mvnw clean install site

% ls target/site/apidocs

allclasses-index.html                overview-tree.html
allpackages-index.html               package-search-index.js
constant-values.html                 resources
de.softwareforge.testing.postgres    script-dir
deprecated-list.html                 script.js
element-list                         search.js
index-all.html                       src
index.html                           src-html
jquery-ui.overrides.css              stylesheet.css
legal                                tag-search-index.js
member-search-index.js            type-search-index.js
module-search-index.js

==> If the build only creates the site (run aggregate-no-fork, javadoc, javadoc-no-fork), it will not contain the module subfolder (de.softwareforge.testing.postgres)

==> if the build also runs the "javadoc:jar" goal, the site will contain the module subfolder

 

I have looked through the debug output and the options to the maven javadoc plugin execution but nothing stands out. Just that one builds the module javadoc correctly and the other does not.

 

 

 

 

 

Issue Links

• is fixed by: MJAVADOC-770 Allow building javadoc "the old fashioned way" after Java 8