Add reference docs tasks to Gradle build

- Move spring-webflow-reference to src/reference
- Upgrade to Docbook 5
- Apply docbook plugin
- Add tasks for generating distribution zip files

build.gradle

@@ -234,6 +234,12 @@ configure(rootProject) {
 
     description = 'Spring Web Flow'
 
+    apply plugin: 'docbook-reference'
+
+    reference {
+        sourceDir = file('src/reference')
+    }
+
     // don't publish the default jar for the root project
     configurations.archives.artifacts.clear()
 
@@ -258,9 +264,103 @@ configure(rootProject) {
         maxMemory = '1024m'
     }
 
+    task docsZip(type: Zip) {
+        group = 'Distribution'
+        classifier = 'docs'
+        description = "Builds -${classifier} archive containing api and reference " +
+            "for deployment at static.springframework.org/spring-webflow/docs."
+
+        from('src/dist') {
+            include 'changelog.txt'
+        }
+
+        from (api) {
+            into 'api'
+        }
+
+        from (reference) {
+            into 'reference'
+        }
+    }
+
+    task schemaZip(type: Zip) {
+        group = 'Distribution'
+        classifier = 'schema'
+        description = "Builds -${classifier} archive containing all " +
+            "XSDs for deployment at static.springframework.org/schema."
+
+        subprojects.each { subproject ->
+            def Properties schemas = new Properties();
+
+            subproject.sourceSets.main.resources.find {
+                it.path.endsWith('META-INF/spring.schemas')
+            }?.withInputStream { schemas.load(it) }
+
+            for (def key : schemas.keySet()) {
+                def shortName = key.replaceAll(/http.*schema.(.*).spring-.*/, '$1')
+                assert shortName != key
+                File xsdFile = subproject.sourceSets.main.allSource.find {
+                    it.path.endsWith(schemas.get(key))
+                }
+                assert xsdFile != null
+                into (shortName) {
+                    from xsdFile.path
+                }
+            }
+        }
+    }
+
+    task distZip(type: Zip, dependsOn: [docsZip, schemaZip]) {
+        group = 'Distribution'
+        classifier = 'dist'
+        description = "Builds -${classifier} archive, containing all jars and docs, " +
+                      "suitable for community download page."
+
+        def baseDir = "${project.name}-${project.version}";
+
+        from('src/dist') {
+            include 'notice.txt'
+            into "${baseDir}"
+            expand(copyright: new Date().format('yyyy'), version: project.version)
+        }
+
+        from('src/dist') {
+            include 'readme.txt'
+            include 'license.txt'
+            into "${baseDir}"
+        }
+
+        from(zipTree(docsZip.archivePath)) {
+            into "${baseDir}/docs"
+        }
+
+        from(zipTree(schemaZip.archivePath)) {
+            into "${baseDir}/schema"
+        }
+
+        subprojects.each { subproject ->
+            into ("${baseDir}/libs") {
+                from subproject.jar
+                if (subproject.tasks.findByPath('sourcesJar')) {
+                    from subproject.sourcesJar
+                }
+                if (subproject.tasks.findByPath('javadocJar')) {
+                    from subproject.javadocJar
+                }
+            }
+        }
+    }
+
+    artifacts {
+        archives docsZip
+        archives schemaZip
+        archives distZip
+    }
+
     task wrapper(type: Wrapper) {
         description = 'Generates gradlew[.bat] scripts'
         gradleVersion = '1.0-rc-1'
     }
+
 }
 

spring-webflow-reference/src/actions.xml → src/reference/actions.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-<chapter id="actions">
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xml:id="actions">
 	<title>Executing actions</title>
 	<sect1 id="actions-introduction">
 		<title>Introduction</title>
@@ -463,4 +464,4 @@ public class FileUploadHandler {
 			</para>
 		</sect2>			
 	</sect1>
-</chapter>
+</chapter>

spring-webflow-reference/src/defining-flows.xml → src/reference/defining-flows.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-<chapter id="defining-flows">
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xml:id="defining-flows">
 	<title>Defining Flows</title>
 	<sect1 id="defining-flows-introduction">
 		<title>Introduction</title>
@@ -493,4 +494,4 @@ public interface FlowOutcome {
 			</para>				
 		</sect2>		
 	</sect1>
-</chapter>
+</chapter>

spring-webflow-reference/src/el.xml → src/reference/el.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-<chapter id="el">
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xml:id="el">
 	<title>Expression Language (EL)</title>
 	<sect1 id="el-introduction">
 		<title>Introduction</title>
@@ -370,4 +371,4 @@
 			If no such variable is found, an <code>EvaluationException</code> will be thrown.
 		</para>
 	</sect1>
-</chapter>
+</chapter>

spring-webflow-reference/src/flow-definition-field-mappings.xml → src/reference/flow-definition-field-mappings.xml

@@ -1,7 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-	"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
-<appendix id="field-mappings">
+<appendix xmlns="http://docbook.org/ns/docbook" version="5.0"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    xmlns:xi="http://www.w3.org/2001/XInclude"
+    xml:id="field-mappings">
 	<title>Flow Definition Language 1.0 to 2.0 Mappings</title>
 	<para>
 		The flow definition language has changed since the 1.0 release.