Dokka fixes

  * Provide module with Kotlin 1.3 API because Kotlin 1.2 from Dokka can't read classes marked as "from the future"
  * Add runConfiguration dokkaStubs which is included only during dokka task with some classpath magic for Kotlin 1.3
  * Add package.list for slf4j
  * Fix unresolved types/links in documentation
  * Suppress all internal/inherited API

Author: qwwdfsad

build.gradle

@@ -103,7 +103,7 @@ configure(subprojects.findAll { !sourceless.contains(it.name)  }) {
 
 // --------------- Configure sub-projects that are part of the library ---------------
 
-def internal = sourceless + ['benchmarks', 'knit', 'js-stub', 'binary-compatibility-validator']
+def internal = sourceless + ['benchmarks', 'knit', 'js-stub', 'stdlib-stubs', 'binary-compatibility-validator']
 
 // Reconfigure source sets to avoid long "src/main/kotlin/fqn"
 configure(subprojects.findAll { !it.name.contains(sourceless) && it.name != "benchmarks" }) {

common/kotlinx-coroutines-core-common/src/CoroutineContext.common.kt

@@ -6,6 +6,10 @@ package kotlinx.coroutines
 
 import kotlin.coroutines.*
 
+/**
+ * Creates context for the new coroutine. It installs [Dispatchers.Default] when no other dispatcher nor
+ * [ContinuationInterceptor] is specified, and adds optional support for debugging facilities (when turned on).
+ */
 public expect fun CoroutineScope.newCoroutineContext(context: CoroutineContext): CoroutineContext
 
 internal expect fun createDefaultDispatcher(): CoroutineDispatcher

common/kotlinx-coroutines-core-common/src/CoroutineDispatcher.kt

@@ -103,7 +103,7 @@ public abstract class CoroutineDispatcher :
     )
     public operator fun plus(other: CoroutineDispatcher) = other
 
-    // for nicer debugging
+    /** @suppress for nicer debugging */
     override fun toString(): String = "$classSimpleName@$hexAddress"
 }
 

common/kotlinx-coroutines-core-common/src/CoroutineScope.kt

@@ -58,7 +58,6 @@ import kotlin.coroutines.*
  * ```
  */
 public interface CoroutineScope {
-
     /**
      * Context of this scope.
      */

common/kotlinx-coroutines-core-common/src/Delay.kt

@@ -16,7 +16,7 @@ import kotlin.coroutines.*
  *
  * @suppress **This an internal API and should not be used from general code.**
  */
-@InternalCoroutinesApi // todo: Remove references from other docs
+@InternalCoroutinesApi
 public interface Delay {
     /**
      * Delays coroutine for a given time without blocking a thread and resumes it after a specified time.
@@ -65,9 +65,7 @@ public interface Delay {
  *
  * Note, that delay can be used in [select] invocation with [onTimeout][SelectBuilder.onTimeout] clause.
  *
- * This function delegates to [Delay.scheduleResumeAfterDelay] if the context [CoroutineDispatcher]
- * implements [Delay] interface, otherwise it resumes using a built-in single-threaded scheduled executor service.
- *
+ * Implementation note: how exactly time is tracked is an implementation detail of [CoroutineDispatcher] in the context.
  * @param timeMillis time in milliseconds.
  */
 public suspend fun delay(timeMillis: Long) {

common/kotlinx-coroutines-core-common/src/Exceptions.common.kt

@@ -4,6 +4,9 @@
 
 package kotlinx.coroutines
 
+/**
+ * @suppress **This an internal API and should not be used from general code.**
+ */
 @InternalCoroutinesApi
 public expect class CompletionHandlerException(message: String, cause: Throwable) : RuntimeException
 

common/kotlinx-coroutines-core-common/src/NonCancellable.kt

@@ -5,12 +5,11 @@
 
 package kotlinx.coroutines
 
-import kotlinx.coroutines.NonCancellable.isActive
 import kotlinx.coroutines.selects.*
 import kotlin.coroutines.*
 
 /**
- * A non-cancelable job that is always [active][isActive]. It is designed for [withContext] function
+ * A non-cancelable job that is always [active][Job.isActive]. It is designed for [withContext] function
  * to prevent cancellation of code blocks that need to be executed without cancellation.
  *
  * Use it like this:
@@ -26,7 +25,7 @@ public object NonCancellable : AbstractCoroutineContextElement(Job), Job {
      * @suppress **This an internal API and should not be used from general code.**
      */
     @InternalCoroutinesApi
-    override val isActive: Boolean  get() = true
+    override val isActive: Boolean get() = true
 
     /**
      * Always returns `false`.

common/kotlinx-coroutines-core-common/src/Runnable.common.kt

@@ -4,6 +4,7 @@
 
 package kotlinx.coroutines
 
+/** @suppress */
 public expect interface Runnable {
     public fun run()
 }

common/kotlinx-coroutines-core-common/src/Timeout.kt

@@ -20,8 +20,7 @@ import kotlin.coroutines.intrinsics.*
  * The sibling function that does not throw exception on timeout is [withTimeoutOrNull].
  * Note, that timeout action can be specified for [select] invocation with [onTimeout][SelectBuilder.onTimeout] clause.
  *
- * This function delegates to [Delay.invokeOnTimeout] if the context [CoroutineDispatcher]
- * implements [Delay] interface, otherwise it tracks time using a built-in single-threaded scheduled executor service.
+ * Implementation note: how exactly time is tracked is an implementation detail of [CoroutineDispatcher] in the context.
  *
  * @param timeMillis timeout time in milliseconds.
  */
@@ -42,8 +41,7 @@ public suspend fun <T> withTimeout(timeMillis: Long, block: suspend CoroutineSco
  * The sibling function that throws exception on timeout is [withTimeout].
  * Note, that timeout action can be specified for [select] invocation with [onTimeout][SelectBuilder.onTimeout] clause.
  *
- * This function delegates to [Delay.invokeOnTimeout] if the context [CoroutineDispatcher]
- * implements [Delay] interface, otherwise it tracks time using a built-in single-threaded scheduled executor service.
+ * Implementation note: how exactly time is tracked is an implementation detail of [CoroutineDispatcher] in the context.
  *
  * @param timeMillis timeout time in milliseconds.
  */

common/kotlinx-coroutines-core-common/src/channels/Channel.kt

@@ -342,7 +342,7 @@ public interface ChannelIterator<out E> {
  *   while previously sent elements **are lost**.
  *   Sender to this channel never suspends and [offer] always returns `true`.
  *
- * * When `capacity` is positive, but less than [UNLIMITED] -- it creates [ArrayChannel].
+ * * When `capacity` is positive, but less than [UNLIMITED] -- it creates array-based channel with given capacity.
  *   This channel has an array buffer of a fixed `capacity`.
  *   Sender suspends only when buffer is fully and receiver suspends only when buffer is empty.
  */