Document stdlib in a separate task

Avoid Tasty errors, and allows us to use wiki syntax for the project.

Author: abgruszecki

.github/workflows/scala3doc.yaml

@@ -57,6 +57,9 @@ jobs:
       - name: Generate Scala 3 documentation
         run: ./project/scripts/sbt scala3doc/generateScala3Documentation
 
+      - name: Generate Scala 3 stdlib documentation
+        run: ./project/scripts/sbt scala3doc/generateScala3StdlibDocumentation
+
       - name: Generate documentation for example project using dotty-sbt
         run: ./project/scripts/sbt "sbt-dotty/scripted sbt-dotty/scala3doc"
 

project/Build.scala

@@ -1160,7 +1160,9 @@ object Build {
   val testcasesOutputDir = taskKey[String]("Root directory where tests classses are generated")
   val testcasesSourceRoot = taskKey[String]("Root directory where tests sources are generated")
   val generateSelfDocumentation = taskKey[Unit]("Generate example documentation")
+  // Note: the two tasks below should be one, but a bug in Tasty prevents that
   val generateScala3Documentation = taskKey[Unit]("Generate documentation for dotty lib")
+  val generateScala3StdlibDocumentation = taskKey[Unit]("Generate documentation for Scala3 standard library")
   val generateTestcasesDocumentation  = taskKey[Unit]("Generate documentation for testcases, usefull for debugging tests")
   lazy val `scala3doc` = project.in(file("scala3doc")).asScala3doc
   lazy val `scala3doc-testcases` = project.in(file("scala3doc-testcases")).asScala3docTestcases
@@ -1503,17 +1505,27 @@ object Build {
           }.value,
           generateScala3Documentation := Def.taskDyn {
             val dottyJars: Seq[java.io.File] = Seq(
-              // (`scala3-interfaces`/Compile/products).value,
-              // (`tasty-core-bootstrapped`/Compile/products).value,
-              // (`scala3-library-bootstrapped`/Compile/products).value,
-              (`stdlib-bootstrapped`/Compile/products).value,
+              (`scala3-interfaces`/Compile/products).value,
+              (`tasty-core-bootstrapped`/Compile/products).value,
+              (`scala3-library-bootstrapped`/Compile/products).value,
             ).flatten
 
             val roots = joinProducts(dottyJars)
 
             if (dottyJars.isEmpty) Def.task { streams.value.log.error("Dotty lib wasn't found") }
             else generateDocumentation(roots, "Scala 3", "scala3", "-p scala3doc/scala3-docs --projectLogo scala3doc/scala3-docs/logo.svg  --revision master")
           }.value,
+
+          generateScala3StdlibDocumentation:= Def.taskDyn {
+            val dottyJars: Seq[java.io.File] = Seq(
+              (`stdlib-bootstrapped`/Compile/products).value,
+            ).flatten
+
+            val roots = joinProducts(dottyJars)
+
+            if (dottyJars.isEmpty) Def.task { streams.value.log.error("Dotty lib wasn't found") }
+            else generateDocumentation(roots, "Scala 3", "scala3-stdlib", "-p scala3doc/scala3-docs --syntax wiki --projectLogo scala3doc/scala3-docs/logo.svg  --revision master")
+          }.value,
           generateTestcasesDocumentation := Def.taskDyn {
             generateDocumentation(Build.testcasesOutputDir.in(Test).value, "Scala3doc testcases", "testcases", "--revision master")
           }.value,

scala3doc/src/dotty/dokka/tasty/comments/wiki/Converter.scala

@@ -113,8 +113,20 @@ class Converter(val repr: Repr) extends BaseConverter {
           resolveLinkQuery(target, Some(body).filter(!_.isEmpty))
       })
 
-    case _: (Superscript | Subscript | RepresentationLink | HtmlTag) =>
-      sys.error("not yet supported: Superscript | Subscript | RepresentationLink | HtmlTag")
+    case Superscript(i) =>
+      def name = inl.getClass.getSimpleName
+      println(s"WARN: not yet supported: $name")
+      emitInline(i)
+
+    case Subscript(i) =>
+      def name = inl.getClass.getSimpleName
+      println(s"WARN: not yet supported: $name")
+      emitInline(i)
+
+    case _: (RepresentationLink | HtmlTag) =>
+      def name = inl.getClass.getSimpleName
+      println(s"WARN: not yet supported: $name")
+      name // doesn't compile if name is a val
   }
 
   def convertInline(inl: Inline): Seq[dkkd.DocTag] =