Review fixup: signature changed, docs fixed

Author: mvicsokolova

kotlinx-coroutines-core/api/kotlinx-coroutines-core.api

@@ -277,7 +277,7 @@ public final class kotlinx/coroutines/Dispatchers {
 	public static final fun getIO ()Lkotlinx/coroutines/CoroutineDispatcher;
 	public static final fun getMain ()Lkotlinx/coroutines/MainCoroutineDispatcher;
 	public static final fun getUnconfined ()Lkotlinx/coroutines/CoroutineDispatcher;
-	public final fun shutdown (Lkotlinx/coroutines/CoroutineDispatcher;)V
+	public final fun shutdownDefaultDispatcher (Lkotlinx/coroutines/Dispatchers;)V
 }
 
 public final class kotlinx/coroutines/DispatchersKt {

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

@@ -80,12 +80,20 @@ public expect object Dispatchers {
     public val Unconfined: CoroutineDispatcher
 
     /**
-     * Shuts down the dispatcher.
+     * Shuts down the [Default] dispatcher.
      *
      * Its implementation depends on the platform:
      * - On Kotlin/JVM and Kotlin/JS takes no effect.
-     * - On Kotlin/Native requests termination of the worker created by the [Default] dispatcher.
+     * - On Kotlin/Native requests termination of the Worker created by the [Default] dispatcher.
+     *   [Default] dispatcher is backed by a [SingleThreadDispatcher] that creates a Worker and never shuts it down.
+     *   According to the current implementation, Kotlin/Native memory leak checker can not do it’s job while
+     *   there are active workers left at the program shutdown. Thus, if the memory leak checker is activated
+     *   (`Platform.isMemoryLeakCheckerActive = true`) this method should be called before program termination
+     *   to avoid the leaking worker.
+     *
+     * **Note**: For now this declaration is only present in `native-mt` versions of `kotlinx.coroutines`.
+     *           It will be available in regular versions when #2558 is implemeted.
      */
     @ExperimentalCoroutinesApi
-    public fun CoroutineDispatcher.shutdown()
+    public fun Dispatchers.shutdownDefaultDispatcher()
 }

kotlinx-coroutines-core/js/src/Dispatchers.kt

@@ -10,7 +10,7 @@ public actual object Dispatchers {
     public actual val Default: CoroutineDispatcher = createDefaultDispatcher()
     public actual val Main: MainCoroutineDispatcher = JsMainDispatcher(Default, false)
     public actual val Unconfined: CoroutineDispatcher = kotlinx.coroutines.Unconfined
-    public actual fun CoroutineDispatcher.shutdown() {}
+    public actual fun Dispatchers.shutdownDefaultDispatcher() {}
 }
 
 private class JsMainDispatcher(

kotlinx-coroutines-core/jvm/src/Dispatchers.kt

@@ -116,5 +116,5 @@ public actual object Dispatchers {
     @JvmStatic
     public val IO: CoroutineDispatcher = DefaultScheduler.IO
 
-    public actual fun CoroutineDispatcher.shutdown() {}
+    public actual fun Dispatchers.shutdownDefaultDispatcher() {}
 }

kotlinx-coroutines-core/native/src/Dispatchers.native.kt

@@ -13,8 +13,8 @@ public actual object Dispatchers {
     public actual val Main: MainCoroutineDispatcher = createMainDispatcher(Default)
     public actual val Unconfined: CoroutineDispatcher get() = kotlinx.coroutines.Unconfined // Avoid freezing
 
-    public actual fun CoroutineDispatcher.shutdown() {
-        if (this === DefaultDispatcher) shutdown()
+    public actual fun Dispatchers.shutdownDefaultDispatcher() {
+        DefaultDispatcher.shutdown()
     }
 }