Use groovydoc plugin to reduce memory strain in Travis

Author: graemerocher

build.gradle

@@ -12,6 +12,7 @@ buildscript {
         classpath 'com.bmuschko:gradle-nexus-plugin:2.3'
         classpath "io.codearte.gradle.nexus:gradle-nexus-staging-plugin:0.5.3"
         classpath "gradle.plugin.io.sdkman:gradle-sdkvendor-plugin:1.0.0"
+        classpath "io.github.groovylang.groovydoc:groovydoc-gradle-plugin:1.0.1"
     }
 }
 
@@ -160,6 +161,11 @@ apply from: "gradle/idea.gradle"
 subprojects { project ->
     version = grailsVersion
     group = "org.grails"
+
+    configurations {
+        documentation
+    }
+
     ext.isTestSuite = project.name.startsWith("grails-test-suite")
     ext.isCiBuild = project.hasProperty("isCiBuild")
     ext.pomInfo = {
@@ -206,6 +212,7 @@ subprojects { project ->
     if(project.name == 'grails-bom') return
 
     apply plugin: 'groovy'
+    apply plugin: "io.github.groovylang.groovydoc"
     if(!isTestSuite) {
         apply plugin: 'com.bmuschko.nexus'
         apply plugin: 'maven-publish'
@@ -259,7 +266,18 @@ subprojects { project ->
         options.debug = true
     }
 
+    configure([groovydoc]) {
+        onlyIf {
+            !isTestSuite
+        }
+        classpath += configurations.documentation
+        jvmArgs "-Xmx512M"
+    }
+
     configure([javadoc]) {
+        onlyIf {
+            !isTestSuite
+        }
         options.encoding "UTF-8"
         options.docEncoding "UTF-8"
         options.charSet "UTF-8"
@@ -279,6 +297,10 @@ subprojects { project ->
     }
 
     dependencies {
+        documentation("org.fusesource.jansi:jansi:$jansiVersion")
+        documentation("jline:jline:$jlineVersion")
+        documentation "org.codehaus.groovy:groovy-ant:$groovyVersion"
+
         compile groovyDependency
 
         testCompile "org.codehaus.groovy:groovy-test:${groovyVersion}", {

gradle/docs.gradle

@@ -1,3 +1,11 @@
+buildscript {
+    repositories {
+        maven { url "https://repo.grails.org/grails/core" }
+    }
+    dependencies {
+        classpath "io.github.groovylang.groovydoc:groovydoc-gradle-plugin:1.0.1"
+    }
+}
 /**
  * Since Grails is a mixed Groovy/Java codebase the javadoc tool needs stubs in order for javadoc compilation to pass
  * This target generates a set of stubs for the Groovy sources
@@ -66,15 +74,15 @@ task javadoc(type:Javadoc) {
     verbose = false
 }
 
-task groovydoc(type:Groovydoc) {
-    def subs = subprojects.findAll { it.name != 'grails-dependencies' && it.name != 'grails-bom' && it.name != 'grails-compat' }
+task groovydoc(type:org.groovy.lang.groovydoc.tasks.GroovydocTask) {
+    def subs = subprojects.findAll {
+        it.name != 'grails-dependencies' && it.name != 'grails-bom' && it.name != 'grails-compat' && !it.name.startsWith("grails-test-suite") }
     classpath = files(subs.configurations.compile)
     groovyClasspath = files(subs.configurations.compile)
     destinationDir = file("$docs.destinationDir/api")
     windowTitle = "Grails $grailsVersion"
     docTitle = "Grails $grailsVersion"
     source subs.sourceSets.main.groovy.srcDirs
-    use = true
 // Can't make these link methods to work
 //    link("http://static.springsource.org/spring/docs/3.0.x/javadoc-api", "org.springframework.")
 //    link("http://download.oracle.com/javase/1.5.0/docs/api", "java." , "javax.")