File: build-docs.xml

package info (click to toggle)
kotlin 1.3.31%2Bds1-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 109,524 kB
  • sloc: java: 454,753; xml: 18,599; javascript: 10,452; sh: 513; python: 97; makefile: 54; ansic: 4
file content (112 lines) | stat: -rw-r--r-- 5,966 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<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"/>

    <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="dist-stdlib">
        <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:dist"/>
        </java>
    </target>

    <path id="stdlib.compile.classpath">
        <fileset dir="${basedir}/../dist/kotlinc/lib/" includes="kotlin-stdlib.jar"/>
    </path>
    <path id="kotlin-test.compile.classpath">
        <fileset dir="${basedir}/../dist/kotlinc/lib/" includes="kotlin-stdlib.jar"/>
        <pathelement location="${basedir}/lib/junit-4.11.jar"/>
    </path>
    <target name="document" depends="clean,dist-stdlib">
        <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/jvm/src" platforms="JVM"/>
            <!--<sourceRoot path="stdlib/common/src" />-->
            <!--<sourceRoot path="stdlib/common/src/generated" platforms="Common"/>-->
            <!--<sourceRoot path="stdlib/common/build/common-sources" />-->
            <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="../core/builtins/native" />
            <sourceRoot path="../core/builtins/src" />
            <sourceRoot path="stdlib/common/src" />
            <sourceRoot path="stdlib/src" />

            <sourcelink path=".." url="https://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="https://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/>
            <ExternalDocumentationLink url="https://kotlinlang.org/api/latest/jvm/stdlib/" packageListUrl="${stdlib.package.list}" />
            <ExternalDocumentationLink url="https://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>