Suppress deprecated and internal APIs from docs
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineContext.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineContext.kt
index abc54d2..ae34637 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineContext.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineContext.kt
@@ -46,7 +46,7 @@
}
/**
- * **Deprecated**: `Here` was renamed to `Unconfined`.
+ * @suppress **Deprecated**: `Here` was renamed to `Unconfined`.
*/
@Deprecated(message = "`Here` was renamed to `Unconfined`",
replaceWith = ReplaceWith(expression = "Unconfined"))
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineDispatcher.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineDispatcher.kt
index 17fbac2..b581336 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineDispatcher.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineDispatcher.kt
@@ -81,7 +81,7 @@
DispatchedContinuation(this, continuation)
/**
- * **Error**: Operator '+' on two CoroutineDispatcher objects is meaningless.
+ * @suppress **Error**: Operator '+' on two CoroutineDispatcher objects is meaningless.
* CoroutineDispatcher is a coroutine context element and `+` is a set-sum operator for coroutine contexts.
* The dispatcher to the right of `+` just replaces the dispatcher the left of `+`.
*/
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
index c722c80..ee1c713 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt
@@ -75,7 +75,7 @@
public fun getCompleted(): T
/**
- * **Deprecated**: Use `isActive`.
+ * @suppress **Deprecated**: Use `isActive`.
*/
@Deprecated(message = "Use `isActive`", replaceWith = ReplaceWith("isActive"))
public val isComputing: Boolean get() = isActive
@@ -108,7 +108,7 @@
}
/**
- * **Deprecated**: `defer` was renamed to `async`.
+ * @suppress **Deprecated**: `defer` was renamed to `async`.
*/
@Deprecated(message = "`defer` was renamed to `async`", level = DeprecationLevel.WARNING,
replaceWith = ReplaceWith("async(context, block = block)"))
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Job.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Job.kt
index 65c7bd1..7d81966 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Job.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Job.kt
@@ -129,7 +129,7 @@
public fun cancel(cause: Throwable? = null): Boolean
/**
- * **Error**: Operator '+' on two Job objects is meaningless.
+ * @suppress **Error**: Operator '+' on two Job objects is meaningless.
* Job is a coroutine context element and `+` is a set-sum operator for coroutine contexts.
* The job to the right of `+` just replaces the job the left of `+`.
*/
@@ -192,7 +192,7 @@
onCompletion(RemoveOnCompletion(this, node))
/**
- * **Deprecated**: `join` is now a member function of `Job`.
+ * @suppress **Deprecated**: `join` is now a member function of `Job`.
*/
@Suppress("EXTENSION_SHADOWED_BY_MEMBER", "DeprecatedCallableAddReplaceWith")
@Deprecated(message = "`join` is now a member function of `Job`")
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/LazyDeferred.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/LazyDeferred.kt
index 83c2869..4efa86b 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/LazyDeferred.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/LazyDeferred.kt
@@ -19,14 +19,14 @@
import kotlin.coroutines.experimental.CoroutineContext
/**
- * **Deprecated**: `Deferred` incorporates functionality of `LazyDeferred`. See [Deferred].
+ * @suppress **Deprecated**: `Deferred` incorporates functionality of `LazyDeferred`. See [Deferred].
*/
@Deprecated(message = "`Deferred` incorporates functionality of `LazyDeferred`", level = DeprecationLevel.WARNING,
replaceWith = ReplaceWith("Deferred"))
typealias LazyDeferred<T> = Deferred<T>
/**
- * **Deprecated**: Replace with `async(context, start = false) { ... }`. See [async].
+ * @suppress **Deprecated**: Replace with `async(context, start = false) { ... }`. See [async].
*/
@Deprecated(message = "This functionality is incorporated into `async", level = DeprecationLevel.WARNING,
replaceWith = ReplaceWith("async(context, start = false, block = block)"))
diff --git a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/intrinsics/Intrinsics.kt b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/intrinsics/Intrinsics.kt
index aaf865d..477ebef 100644
--- a/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/intrinsics/Intrinsics.kt
+++ b/kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/intrinsics/Intrinsics.kt
@@ -24,6 +24,8 @@
* This function creates and start a new, fresh instance of suspendable computation every time it is invoked.
* If the coroutine never suspends, then its result is returned directly,
* otherwise it returns [COROUTINE_SUSPENDED] and the [completion] continuation is invoked when coroutine completes.
+ *
+ * @suppress **This is unstable API and it is subject to change.**
*/
@Suppress("PLATFORM_CLASS_MAPPED_TO_KOTLIN", "UNCHECKED_CAST")
public fun <T> (suspend () -> T).startCoroutineOrReturn(completion: Continuation<T>): Any? =