From 37e1a12731df2457d0c05a5a0406129cd664c8a1 Mon Sep 17 00:00:00 2001
From: Tim Donohue <tdonohue@duraspace.org>
Date: Mon, 18 Jul 2016 15:46:03 -0500
Subject: [PATCH] DS-3154: Disable doclint for Java 1.8 by default

---
 pom.xml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/pom.xml b/pom.xml
index 3cbae9f9c2..4cdb5644d3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -493,6 +493,25 @@
             </build>
         </profile>
 
+        <!--
+            If building with Java 8 (JDK 1.8), then disable the default 'doclint' validation.
+            'doclint' validates all Javadoc comments (see http://openjdk.java.net/jeps/172).
+            Unfortunately though, it also causes our release process to fail with Java 8,
+            as DSpace still has several modules with invalid Javadoc comments.
+            While we hope to clean this up in the future, for now we are forced to disable it.
+            See DS-3154 for more info.
+        -->
+        <profile>
+            <id>doclint-java8-disable</id>
+            <activation>
+                <jdk>[1.8,)</jdk>
+            </activation>
+            <properties>
+                <!-- Note: ${javadoc.opts} is passed to maven-javadoc-plugin below -->
+                <javadoc.opts>-Xdoclint:none</javadoc.opts>
+            </properties>
+        </profile>
+
         <!--
            These profiles activate the inclusion of various modules into
            the DSpace Build process. They activate automatically if the
@@ -746,6 +765,9 @@
                                 <goals>
                                     <goal>aggregate-jar</goal>
                                 </goals>
+                                <configuration>
+                                    <additionalparam>${javadoc.opts}</additionalparam>
+                                </configuration>
                             </execution>
                         </executions>
                     </plugin>