Uploaded image for project: 'DSpace'
  1. DSpace
  2. DS-3154

Maven release process fails when using Java 8 because of Javadocs errors

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed (View Workflow)
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 6.0
    • Fix Version/s: 6.0
    • Component/s: None
    • Labels:
      None
    • Environment:
      Java 8
    • Attachments:
      0
    • Comments:
      6
    • Documentation Status:
      Not Required

      Description

      Currently, if you attempt to run mvn release:perform using Java 8, the Maven process will fail almost immediately because of Javadocs errors.

      This is because DocLint was added in Java 8: http://openjdk.java.net/jeps/172

      See also: http://stackoverflow.com/questions/15886209/maven-is-not-working-in-java-8-when-javadoc-tags-are-incomplete

      Also, this blog post has a list of invalid JavaDocs with Java 8 will now complain about: http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html

      While it is possible to disable DocLint checks, it is NOT recommended (obviously). The better route would be to cleanup our Javadocs errors (warnings are OK) so that Java 8 releases will succeed.

      You can also see these errors by simply running mvn javadoc:aggregate using Java 8, as this attempts to generate Javadocs for all our modules.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                tdonohue Tim Donohue
                Reporter:
                tdonohue Tim Donohue
              • Votes:
                1 Vote for this issue
                Watchers:
                4 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: