title: maven-javadoc-plugin not accepting <additionalparam>-Xdoclint:none</additionalparam>
body: <p>A <code>mvn release:perform</code> is failing due to javadocs not being created.  So I tried running </p>
  
  <pre><code>mvn javadoc:javadoc
  </code></pre>
  
  <p>myself and I see that it fails due to the javadoc comments in the source code not having definitions for all of the parameters and return values.  Errors are of the format:</p>
  
  <pre><code>Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.1:jar (attach-javadocs) on project my-project: MavenReportException: Error while generating Javadoc:
  
  Exit code: 1 - /my/file.java:36: warning: no description for @return
  </code></pre>
  
  <p><strong>This, however, used to work. So what changed?</strong></p>
  
  <p>I checked the maven-javadoc-plugin documentation and it now (in v3.0) says the parameter is not additionalParam, or additionalparam, but additionalOptions, and additionalJOptions.  See <a href="https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#additionalOptions" rel="noreferrer">maven-javadoc-plugin documentation</a>.</p>
  
  <p>When I searched for the parameter additionalParam, it does not appear.  I'm confused how this could have worked.  Searching for answers some people say to use what I'm using, others say to use additionalJOption.  See <a href="https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete">Maven is not working in Java 8 when Javadoc tags are incomplete</a>.</p>
  
  <h1>How can I fix it?</h1>
  
  <p><strong>Any ideas on what caused the problem and how to fix it?</strong></p>
  
  <h1>What I've tried</h1>
  
  <p>Luckily, I found a work around which was to disable the Javadoc linting from the command line:</p>
  
  <pre><code>mvn release:perform -Darugments="-Dmaven.javadoc.skip=true"
  </code></pre>
  
  <p>Kudo's to <a href="https://code.i-harness.com/en/q/711930" rel="noreferrer">code.i-harness.com posting</a> that gave me this work around.  </p>
  
  <p>So I'm passed the initial problem, but want/need to clean up the poms to remove useless parameters, or change them to the new/correct syntax (not yet tested).</p>
  
  <h1>Searches that were useful</h1>
  
  <p>Searching on SO gives these hits that were useful:</p>
  
  <ul>
  <li><p><a href="https://stackoverflow.com/questions/7412016/how-can-i-disable-the-maven-javadoc-plugin-from-the-command-line">How can I disable the Maven Javadoc plugin from the command line?</a> - Gave me the idea to search for maven.javadoc.skip which helped me find my work around.</p></li>
  <li><p><a href="https://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete">Maven is not working in Java 8 when Javadoc tags are incomplete</a> which says I should use <code>additionalJOption</code> parameter.  The same question has an answer that says to use what I'm using <code>&lt;additionalparam&gt;-Xdoclint:none&lt;/additionalparam&gt;</code></p></li>
  </ul>