[MJAVADOC-654] javadoc plugin: "mvn site" works, "mvn release:perform" breaks

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Incomplete
• Affects Version/s: 3.2.0
• Component/s: javadoc
• Assignee: Robert Scholte
• Reporter: Graham Leggett
• Created: 12/Jun/20 20:54
• Updated: 23/Aug/21 18:11
• Resolved: 23/Aug/21 18:11

Description

In order to work around the javadoc bug where minor (and in our case uncorrectable) docs glitches are now fatal, the following is added to the plugin config:

      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.2.0</version>
        <configuration>
          <additionalOptions>
            <additionalOption>-Xdoclint:none</additionalOption>
          </additionalOptions>
        </configuration>
      </plugin>

This works when you run "mvn site", but doesn't work when you run "mvn release:perform".

Most specifically, when "mvn release:perform" is executed the javadoc plugin behaves like the additional option is not present at all.

This breaks the release process.