| <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" erroronmissingdir="false"> |
| <include name="*.jar"/> |
| </fileset> |
| |
| <!-- used for running locally --> |
| <fileset dir="${dokka.path}/runners/fatjar/build/libs/" erroronmissingdir="false"> |
| <include name="dokka-fatjar*.jar"/> |
| </fileset> |
| </classpath> |
| </typedef> |
| |
| <target name="clean"> |
| <delete dir="${docs.output}"/> |
| <mkdir dir="${docs.output}"/> |
| </target> |
| |
| <target name="preprocess-js-common-and-compile-builtins"> |
| <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"/> |
| <arg line=":kotlin-stdlib:builtinsJar"/> |
| <arg line=":kotlin-stdlib:distJar"/> |
| </java> |
| </target> |
| |
| <path id="stdlib.compile.classpath"> |
| <fileset dir="${basedir}/stdlib/build/libs/" includes="builtins-*.jar"/> |
| </path> |
| <path id="kotlin-test.compile.classpath"> |
| <fileset dir="${basedir}/stdlib/build/libs/" includes="dist-kotlin-stdlib.jar"/> |
| <pathelement location="${basedir}/lib/junit-4.11.jar"/> |
| </path> |
| <target name="document" depends="clean,preprocess-js-common-and-compile-builtins"> |
| <dokka samples="stdlib/samples/test" outputDir="${docs.output}/jre8" moduleName="kotlin-stdlib" skipDeprecated="false" outputFormat="${dokka.format}" jdkversion="8" impliedplatforms="JVM,JS" |
| include="stdlib/src/Module.md" noStdlibLink="true" classpathref="stdlib.compile.classpath" languageVersion="1.2"> |
| |
| <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="stdlib/jvm/runtime/kotlin/jvm/annotations" platforms="JVM"/> |
| <sourceRoot path="stdlib/jvm/runtime/kotlin/jvm/JvmClassMapping.kt" platforms="JVM"/> |
| <sourceRoot path="stdlib/jvm/runtime/kotlin/jvm/PurelyImplements.kt" platforms="JVM"/> |
| <sourceRoot path="stdlib/jvm/runtime/kotlin/TypeAliases.kt" platforms="JVM"/> |
| <sourceRoot path="stdlib/jvm/runtime/kotlin/text/TypeAliases.kt" platforms="JVM"/> |
| |
| |
| <sourceRoot path="../core/builtins/native" platforms="JS"/> |
| <sourceRoot path="../core/builtins/src" platforms="JS"/> |
| |
| <sourceRoot path="stdlib/js/src" platforms="JS"/> |
| <sourceRoot path="../js/js.libraries/src/core/generated" platforms="JS"/> |
| <sourceRoot path="${js.stdlib.common.src.path}" platforms="JS"/> |
| |
| <sourcelink path=".." url="http://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/> |
| |
| <!-- TODO Docs? --> |
| <packageOptions prefix="org.w3c" reportUndocumented="false"/> |
| <packageOptions prefix="org.khronos" reportUndocumented="false"/> |
| <packageOptions prefix="jquery" suppress="true"/> |
| <packageOptions prefix="kotlin.reflect.jvm.internal" suppress="true"/> |
| </dokka> |
| <makeurl file="${docs.output}/jre8/kotlin-stdlib/package-list" property="stdlib.package.list"/> |
| <dokka outputDir="${docs.output}/jre8" moduleName="kotlin-test" skipDeprecated="false" outputFormat="${dokka.format}" jdkversion="8" impliedplatforms="JVM,JS" |
| include="kotlin.test/Module.md" noStdlibLink="true" classpathref="kotlin-test.compile.classpath" languageVersion="1.2"> |
| |
| <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/junit/src/main/kotlin" platforms="JVM"/> |
| <sourceRoot path="kotlin.test/testng/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="${stdlib.package.list}" /> |
| <ExternalDocumentationLink url="http://junit.org/junit4/javadoc/latest/" /> |
| <packageoptions prefix="org.junit" skipdeprecated="true"/> |
| </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> |