Suppress deprecated and internal APIs from docs

Author: elizarov

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineContext.kt

@@ -46,7 +46,7 @@ public object Unconfined : CoroutineDispatcher() {
 }
 
 /**
- * **Deprecated**: `Here` was renamed to `Unconfined`.
+ * @suppress **Deprecated**: `Here` was renamed to `Unconfined`.
  */
 @Deprecated(message = "`Here` was renamed to `Unconfined`",
         replaceWith = ReplaceWith(expression = "Unconfined"))

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/CoroutineDispatcher.kt

@@ -81,7 +81,7 @@ public abstract class CoroutineDispatcher :
             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 `+`.
      */

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Deferred.kt

@@ -75,7 +75,7 @@ public interface Deferred<out T> : Job {
     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 @@ public fun <T> async(context: CoroutineContext, start: Boolean = true, block: su
 }
 
 /**
- * **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)"))

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/Job.kt

@@ -129,7 +129,7 @@ public interface Job : CoroutineContext.Element {
     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 @@ public fun Job.removeOnCompletion(node: LockFreeLinkedListNode): Job.Registratio
     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`")

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/LazyDeferred.kt

@@ -19,14 +19,14 @@ package kotlinx.coroutines.experimental
 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)"))

kotlinx-coroutines-core/src/main/kotlin/kotlinx/coroutines/experimental/intrinsics/Intrinsics.kt

@@ -24,6 +24,8 @@ import kotlin.coroutines.experimental.intrinsics.COROUTINE_SUSPENDED
  * 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? =