Add a Gradle target "allJavaDoc" for an initial combined JavaDoc run

git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1888421 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/build.gradle b/build.gradle
index aa29309d2b3213cc97c0b7f89a228e4961e62d17..ee3e3d2dbf8a46d8b5f9fcf74a4d636cba37c0b9 100644 (file)
--- a/build.gradle
+++ b/build.gradle
@@ -223,6 +223,47 @@ if (JavaVersion.current().isJava8Compatible()) {
        }
 }
 
+// initial try to provide a combined JavaDoc, grouping is still missing here, though!
+task allJavaDoc(type: Javadoc) {
+       source subprojects.collect { it.sourceSets.main.allJava }
+
+       // for possible settings see https://docs.gradle.org/current/dsl/org.gradle.api.tasks.javadoc.Javadoc.html
+       classpath = files(subprojects.collect { it.sourceSets.main.compileClasspath })
+       destinationDir = file("${buildDir}/docs/javadoc")
+       maxMemory="384M"
+
+       // for possible options see https://docs.gradle.org/current/javadoc/org/gradle/external/javadoc/StandardJavadocDocletOptions.html
+       options.use = true
+       options.splitIndex = true
+
+       title = 'POI API Documentation'
+       options.bottom = '<![CDATA[<i>Copyright ' + new Date().format('yyyy') + ' The Apache Software Foundation or\n' +
+                       'its licensors, as applicable.</i>]]>'
+
+       options.group('DDF - Dreadful Drawing Format', 'org.apache.poi.ddf*')
+       options.group('HPSF - Horrible Property Set Format', 'org.apache.poi.hpsf*')
+       options.group('SS - Common Spreadsheet Format', 'org.apache.poi.ss*')
+       options.group('HSSF - Horrible Spreadsheet Format', 'org.apache.poi.hssf*')
+       options.group('XSSF - Open Office XML Spreadsheet Format', 'org.apache.poi.xssf*')
+       options.group('SL - Common Slideshow Format',  'org.apache.poi.sl*')
+       options.group('HSLF - Horrible Slideshow Format', 'org.apache.poi.hslf*', 'org.apache.poi.hwmf*', 'org.apache.poi.hemf*')
+       options.group('XSLF - Open Office XML Slideshow Format', 'org.apache.poi.xslf*')
+       options.group('HWPF - Horrible Word Processor Format', 'org.apache.poi.hwpf*')
+       options.group('XWPF - Open Office XML Word Processor Format', 'org.apache.poi.xwpf*')
+       options.group('HDGF - Horrible Diagram Format', 'org.apache.poi.hdgf*')
+       options.group('XDGF - Open Office XML Diagram Format', 'org.apache.poi.xdgf*')
+       options.group('HMEF - Transport Neutral Encoding Files (TNEF)', 'org.apache.poi.hmef*')
+       options.group('HSMF Outlook message file format', 'org.apache.poi.hsmf*')
+       options.group('HPBF - Publisher Format Files', 'org.apache.poi.hpbf*')
+       options.group('POIFS - POI File System', 'org.apache.poi.poifs*')
+       options.group('Utilities', 'org.apache.poi.util*')
+       options.group('Excelant', 'org.apache.poi.ss.excelant**')
+       options.group('Examples', 'org.apache.poi.examples*')
+}
+
+task jenkins
+jenkins.dependsOn allJavaDoc
+
 rat {
     // Input directory, defaults to '.'
     inputDir.set(file("."))