Files
kotlin-fork/libraries/build-docs.xml
T
2017-12-15 20:09:34 +03:00

93 lines
4.7 KiB
XML

<project name="Kotlin standard library" default="document">
<!-- Generates the standard library documentation using Dokka. -->
<property name="github.revision" value="master"/>
<property name="dokka.path" value="../dependencies/dokka" />
<property name="docs.output" value="${basedir}/doc" />
<property name="dokka.format" value="kotlin-website-html"/>
<property name="js.stdlib.common.src.path" value="stdlib/js/build/common-sources"/>
<typedef resource="dokka-antlib.xml">
<classpath>
<fileset dir="${dokka.path}/lib">
<include name="*.jar"/>
</fileset>
<!-- used for running locally -->
<pathelement path="${dokka.path}/out/artifacts/dokka.jar"/>
</classpath>
</typedef>
<target name="clean">
<delete dir="${docs.output}"/>
<mkdir dir="${docs.output}"/>
</target>
<target name="preprocess-js-common">
<java classname="org.gradle.wrapper.GradleWrapperMain"
fork="true"
dir="${basedir}/.."
failonerror="true"
timeout="4000000"
taskname="gradle">
<classpath>
<pathelement location="${basedir}/../gradle/wrapper/gradle-wrapper.jar"/>
</classpath>
<arg line="--no-daemon"/>
<arg line=":kotlin-stdlib-js:preprocessSourcesMain"/>
</java>
</target>
<target name="document" depends="clean,preprocess-js-common">
<dokka samples="stdlib/samples/test" outputDir="${docs.output}/jre8" moduleName="kotlin-stdlib" skipDeprecated="true" outputFormat="${dokka.format}" jdkversion="8" impliedplatforms="JVM,JS"
include="stdlib/src/Module.md" noStdlibLink="true">
<sourceRoot path="stdlib/src" platforms="JVM"/>
<sourceRoot path="stdlib/jdk7/src" platforms="JVM,JRE7"/>
<sourceRoot path="stdlib/jdk8/src" platforms="JVM,JRE8"/>
<sourceRoot path="../core/builtins/native" platforms="JVM"/>
<sourceRoot path="../core/builtins/src" platforms="JVM"/>
<sourceRoot path="../core/reflection.jvm/src" platforms="JVM"/>
<sourceRoot path="../core/runtime.jvm/src/kotlin/jvm/annotations" platforms="JVM"/>
<sourceRoot path="../core/runtime.jvm/src/kotlin/jvm/JvmClassMapping.kt" platforms="JVM"/>
<sourceRoot path="../core/runtime.jvm/src/kotlin/jvm/PurelyImplements.kt" platforms="JVM"/>
<sourceRoot path="../core/runtime.jvm/src/kotlin/TypeAliases.kt" platforms="JVM"/>
<sourceRoot path="../core/runtime.jvm/src/kotlin/text/TypeAliases.kt" platforms="JVM"/>
<sourceRoot path="../core/builtins/native" platforms="JS"/>
<sourceRoot path="../core/builtins/src" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/browser" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/core" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/dom" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/generated" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/js" platforms="JS"/>
<sourceRoot path="../js/js.libraries/src/reflect" platforms="JS"/>
<sourceRoot path="${js.stdlib.common.src.path}" platforms="JS"/>
<sourcelink path=".." url="http://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/>
</dokka>
<dokka outputDir="${docs.output}/jre8" moduleName="kotlin-test" skipDeprecated="true" outputFormat="${dokka.format}" jdkversion="8" impliedplatforms="JVM,JS"
noStdlibLink="true">
<sourceRoot path="kotlin.test/common/src/main/kotlin" platforms="JVM,JS"/>
<sourceRoot path="kotlin.test/jvm/src/main/kotlin" platforms="JVM"/>
<sourceRoot path="kotlin.test/js/src/main/kotlin" platforms="JS"/>
<sourcelink path=".." url="http://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/>
<ExternalDocumentationLink url="https://kotlinlang.org/api/latest/jvm/stdlib/" packageListUrl="file://${docs.output}/jre8/kotlin-stdlib/package-list" />
</dokka>
</target>
<target name="write-build-number">
<echo file="${docs.output}/jre8/kotlin-stdlib/buildNumber.txt">${build.number}</echo>
<echo file="${docs.output}/jre8/kotlin-test/buildNumber.txt">${build.number}</echo>
</target>
<target name="zip" depends="document,write-build-number">
<zip destfile="target/stdlib-docs.zip" basedir="${docs.output}/jre8/kotlin-stdlib"/>
<zip destfile="target/kotlin-test-docs.zip" basedir="${docs.output}/jre8/kotlin-test"/>
</target>
</project>