From 1d86bd56109ffe068c1af9f50764cad77fe16ef6 Mon Sep 17 00:00:00 2001
From: Dmitry Jemerov <yole@jetbrains.com>
Date: Fri, 24 Feb 2017 13:35:04 +0100
Subject: [PATCH] Build multiplatform stdlib docs

---
 build.xml                |  4 +--
 libraries/build-docs.xml | 64 +++++++++++++++++++++++-----------------
 2 files changed, 39 insertions(+), 29 deletions(-)

diff --git a/build.xml b/build.xml
index f30bef91441..0bab79efbac 100644
--- a/build.xml
+++ b/build.xml
@@ -1035,13 +1035,13 @@
         <sequential>
             <java classname="org.jetbrains.kotlin.preloading.Preloader" failonerror="true" fork="true" maxmemory="${max.heap.size.for.forked.jvm}">
                 <classpath>
-                    <pathelement location="${kotlin-home}/lib/kotlin-preloader.jar"/>
+                    <pathelement location="${bootstrap.compiler.home}/lib/kotlin-preloader.jar"/>
                 </classpath>
                 <assertions>
                     <enable/>
                 </assertions>
                 <arg value="-cp"/>
-                <arg value="${kotlin-home}/lib/kotlin-compiler.jar"/>
+                <arg value="${bootstrap.compiler.home}/lib/kotlin-compiler.jar"/>
                 <arg value="org.jetbrains.kotlin.preprocessor.PreprocessorCLI"/>
                 <arg value="@{src}"/>
                 <arg value="@{output}"/>
diff --git a/libraries/build-docs.xml b/libraries/build-docs.xml
index 938f1007d0e..78c3d1446c7 100644
--- a/libraries/build-docs.xml
+++ b/libraries/build-docs.xml
@@ -2,7 +2,8 @@
     <!-- Generates the standard library documentation using Dokka. -->
     <property name="github.revision" value="master"/>
     <property name="dokka.path" value="../dependencies/dokka" />
-    <property name="output" value="${basedir}/doc" />
+    <property name="js.stdlib.src.path" value="../dependencies/js-stdlib-src" />
+    <property name="docs.output" value="${basedir}/doc" />
 
     <typedef resource="dokka-antlib.xml">
         <classpath>
@@ -16,38 +17,47 @@
     </typedef>
 
     <target name="clean">
-        <delete dir="${output}"/>
-        <mkdir dir="${output}"/>
+        <delete dir="${docs.output}"/>
+        <mkdir dir="${docs.output}"/>
     </target>
 
-    <macrodef name="document-stdlib">
-        <attribute name="jdk.version" />
-        <attribute name="additional.src" default="" />
+    <target name="build-js-stdlib-sources">
+        <ant antfile="build.xml" target="pack-js-stdlib-sources" dir=".."/>
 
-        <sequential>
-            <echo message="Building stdlib docs for JRE @{jdk.version}" />
-            <dokka src="stdlib/src:@{additional.src}:../core/builtins:../core/reflection.jvm:../core/runtime.jvm/src/kotlin/jvm/annotations:../core/runtime.jvm/src/kotlin/jvm/JvmClassMapping.kt:../core/runtime.jvm/src/kotlin/jvm/PurelyImplements.kt"
-                   samples="stdlib/samples/src" outputDir="${output}/jre@{jdk.version}" moduleName="kotlin-stdlib" skipDeprecated="true" outputFormat="kotlin-website" jdkversion="@{jdk.version}"
-                   include="stdlib/src/Module.md">
-                <sourcelink path=".." url="http://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/>
-            </dokka>
-            <dokka src="kotlin.test/shared/src/main/kotlin:kotlin.test/shared/src/main/kotlin.jvm:kotlin.test/junit/src/main"
-                   outputDir="${output}/jre@{jdk.version}" moduleName="kotlin-test" skipDeprecated="true" outputFormat="kotlin-website" jdkversion="@{jdk.version}">
-                <sourcelink path=".." url="http://github.com/JetBrains/kotlin/blob/${github.revision}" linesuffix="#L"/>
-            </dokka>
-        </sequential>
-    </macrodef>
+        <delete dir="${js.stdlib.src.path}"/>
+        <unzip src="../dist/kotlinc/lib/kotlin-stdlib-js-sources.jar" dest="${js.stdlib.src.path}"/>
+    </target>
 
-    <target name="document" depends="clean">
-        <document-stdlib jdk.version="6" />
-        <document-stdlib jdk.version="7" additional.src="stdlib/jre7/src" />
-        <document-stdlib jdk.version="8" additional.src="stdlib/jre7/src:stdlib/jre8/src" />
+    <target name="document" depends="clean,build-js-stdlib-sources">
+        <dokka samples="stdlib/samples/test" outputDir="${docs.output}/jre8" moduleName="kotlin-stdlib" skipDeprecated="true" outputFormat="kotlin-website-samples" jdkversion="8" impliedplatforms="JVM,JS"
+               include="stdlib/src/Module.md">
+
+            <sourceRoot path="stdlib/src" platforms="JVM"/>
+            <sourceRoot path="stdlib/jre7/src" platforms="JVM,JRE7"/>
+            <sourceRoot path="stdlib/jre8/src" platforms="JVM,JRE8"/>
+            <sourceRoot path="../core/builtins" platforms="JVM"/>
+            <sourceRoot path="../core/reflection.jvm" 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/builtins" platforms="JS"/>
+            <sourceRoot path="${js.stdlib.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="kotlin-website-samples" jdkversion="8" impliedplatforms="JVM,JS">
+
+            <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"/>
+        </dokka>
     </target>
 
     <target name="zip" depends="document">
-        <zip destfile="target/stdlib-docs.zip" basedir="${output}/jre8/kotlin-stdlib"/>
-        <zip destfile="target/docs-jre6.zip" basedir="${output}/jre6"/>
-        <zip destfile="target/docs-jre7.zip" basedir="${output}/jre7"/>
-        <zip destfile="target/docs-jre8.zip" basedir="${output}/jre8"/>
+        <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>