LUCENE-5593: speed up javadocs generation in build

git-svn-id: https://svn.apache.org/repos/asf/lucene/dev/trunk@1614058 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Robert Muir 2014-07-28 15:36:27 +00:00
parent 8f1ca8b847
commit 2080ddc885
25 changed files with 51 additions and 26 deletions

View File

@ -32,7 +32,8 @@
<import file="../module-build.xml"/>
<target name="javadocs" depends="javadocs-analyzers-common, compile-core">
<target name="javadocs" depends="javadocs-analyzers-common, compile-core, check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../analyzers-common"/>

View File

@ -184,7 +184,8 @@
</path>
<target name="javadocs" depends="javadocs-memory,javadocs-highlighter,javadocs-analyzers-common,
javadocs-queryparser,javadocs-facet,javadocs-spatial,compile-core">
javadocs-queryparser,javadocs-facet,javadocs-spatial,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../memory"/>

View File

@ -39,7 +39,8 @@
<target name="jar-core" depends="common.jar-core" />
<target name="javadocs" depends="javadocs-queries,compile-core">
<target name="javadocs" depends="javadocs-queries,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -2012,6 +2012,15 @@ ${ant.project.name}.test.dependencies=${test.classpath.list}
</sequential>
</macrodef>
<target name="check-javadocs-uptodate">
<uptodate property="javadocs-uptodate-${name}" targetfile="${build.dir}/${final.name}-javadoc.jar">
<srcfiles dir="${src.dir}">
<include name="**/*.java"/>
<include name="**/*.html"/>
</srcfiles>
</uptodate>
</target>
<macrodef name="modules-crawl">
<attribute name="target" default=""/>
<attribute name="failonerror" default="true"/>

View File

@ -57,8 +57,9 @@
<target name="test-core" depends="common.test"/>
<target name="javadocs-core" depends="javadocs"/>
<target name="javadocs" description="Generate javadoc for core classes">
<sequential>
<target name="javadocs" description="Generate javadoc for core classes"
depends="check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/core"/>
<invoke-javadoc destdir="${javadoc.dir}/core" title="${Name} ${version} core API">
<sources>

View File

@ -40,7 +40,8 @@
<fileset dir="lib"/>
</path>
<target name="javadocs" depends="javadocs-analyzers-common,javadocs-queryparser,javadocs-facet,javadocs-expressions,compile-core">
<target name="javadocs" depends="javadocs-analyzers-common,javadocs-queryparser,javadocs-facet,javadocs-expressions,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<!-- we link the example source in the javadocs, as its ref'ed elsewhere -->
<invoke-module-javadoc linksource="yes">
<links>

View File

@ -40,7 +40,7 @@
<target name="compile-core" depends="jar-queries,common.compile-core" />
<target name="javadocs" depends="javadocs-queries,compile-core">
<target name="javadocs" depends="javadocs-queries,compile-core,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -36,7 +36,8 @@
<target name="compile-core" depends="jar-queries,common.compile-core" />
<target name="javadocs" depends="javadocs-queries,compile-core">
<target name="javadocs" depends="javadocs-queries,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -37,7 +37,8 @@
<target name="init" depends="module-build.init,jar-queries"/>
<target name="javadocs" depends="javadocs-queries,compile-core">
<target name="javadocs" depends="javadocs-queries,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -35,7 +35,8 @@
</path>
<target name="compile-core" depends="jar-memory, common.compile-core" />
<target name="javadocs" depends="javadocs-memory,compile-core">
<target name="javadocs" depends="javadocs-memory,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../memory"/>

View File

@ -36,7 +36,8 @@
<target name="init" depends="module-build.init,jar-grouping"/>
<target name="javadocs" depends="javadocs-grouping,compile-core">
<target name="javadocs" depends="javadocs-grouping,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../grouping"/>

View File

@ -60,9 +60,10 @@
<antcall target="common.test" inheritRefs="true" />
</target>
<target name="build-artifacts-and-tests" depends="jar, compile-test" />
<!-- TODO: why does this previous depend on compile-core? -->
<target name="javadocs" depends="compile-core,javadocs-lucene-core">
<target name="javadocs" depends="compile-core,javadocs-lucene-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc/>
</target>

View File

@ -35,7 +35,8 @@
<target name="compile-core" depends="jar-queries,jar-sandbox,common.compile-core"/>
<target name="javadocs" depends="javadocs-queries,javadocs-sandbox,compile-core">
<target name="javadocs" depends="javadocs-queries,javadocs-sandbox,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -38,7 +38,8 @@
<target name="init" depends="module-build.init,jar-facet"/>
<target name="javadocs" depends="javadocs-facet,compile-core">
<target name="javadocs" depends="javadocs-facet,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../facet"/>

View File

@ -43,7 +43,8 @@
<target name="compile-core" depends="jar-queries,jar-misc,common.compile-core" />
<target name="javadocs" depends="javadocs-queries,javadocs-misc,compile-core">
<target name="javadocs" depends="javadocs-queries,javadocs-misc,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../queries"/>

View File

@ -35,7 +35,8 @@
<path refid="base.classpath"/>
</path>
<target name="javadocs" depends="javadocs-queries,javadocs-misc,compile-core">
<target name="javadocs" depends="javadocs-queries,javadocs-misc,compile-core,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<invoke-module-javadoc>
<links>
<link href="../analyzers-common"/>

View File

@ -54,7 +54,8 @@
<target name="-check-forbidden-rue"/>
<target name="javadocs-core" depends="javadocs"/>
<target name="javadocs" depends="init,javadocs-lucene-core,javadocs-lucene-codecs">
<target name="javadocs" depends="init,javadocs-lucene-core,javadocs-lucene-codecs,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/test-framework"/>
<invoke-javadoc overview="${src.dir}/overview.html"

View File

@ -238,7 +238,7 @@
<target name="lucene-javadocs" depends="javadocs-lucene-core,javadocs-analyzers-common,javadocs-analyzers-icu,javadocs-analyzers-kuromoji,javadocs-analyzers-phonetic,javadocs-analyzers-smartcn,javadocs-analyzers-morfologik,javadocs-analyzers-stempel,javadocs-analyzers-uima,javadocs-codecs,javadocs-expressions,javadocs-suggest,javadocs-grouping,javadocs-queries,javadocs-queryparser,javadocs-highlighter,javadocs-memory,javadocs-misc,javadocs-spatial,javadocs-test-framework"/>
<!-- create javadocs for the current module -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -67,7 +67,7 @@
</path>
<!-- TODO: make this nicer like lucene? -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-dataimporthandler">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-dataimporthandler,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -107,7 +107,7 @@
</path>
<!-- TODO: make this nicer like lucene? -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction,javadocs-morphlines-core,javadocs-morphlines-cell">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction,javadocs-morphlines-core,javadocs-morphlines-cell,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -109,7 +109,7 @@
</path>
<!-- TODO: make this nicer like lucene? -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction,javadocs-morphlines-core">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction,javadocs-morphlines-core,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -68,7 +68,7 @@
</path>
<!-- TODO: make this nicer like lucene? -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solr-core,javadocs-extraction,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -43,7 +43,7 @@
</path>
<!-- specialized to ONLY depend on solrj -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solrj">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,lucene-javadocs,javadocs-solrj,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -51,7 +51,8 @@
</target>
<!-- Specialized to depend on nothing -->
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url">
<target name="javadocs" depends="compile-core,define-lucene-javadoc-url,check-javadocs-uptodate"
unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<solr-invoke-javadoc>

View File

@ -59,7 +59,7 @@
<!-- Override common-solr.javadocs to include JUnit links -->
<!-- and to copy the built javadocs to ${dest}/docs/api/test-framework -->
<target name="javadocs"
depends="compile-core,jar-test-framework,lucene-javadocs,javadocs-test-framework,define-lucene-javadoc-url">
depends="compile-core,jar-test-framework,lucene-javadocs,javadocs-test-framework,define-lucene-javadoc-url,check-javadocs-uptodate" unless="javadocs-uptodate-${name}">
<sequential>
<mkdir dir="${javadoc.dir}/${name}"/>
<!-- NOTE: explicitly not using solr-invoke-javadoc, or attempting to