Improve source-code compatibility with prev version of openChannel().use { ... }

Author: elizarov

binary-compatibility-validator/reference-public-api/kotlinx-coroutines-core.txt

@@ -585,7 +585,7 @@ public final class kotlinx/coroutines/experimental/channels/BroadcastChannel$Fac
 
 public final class kotlinx/coroutines/experimental/channels/BroadcastChannelKt {
 	public static final fun BroadcastChannel (I)Lkotlinx/coroutines/experimental/channels/BroadcastChannel;
-	public static final synthetic fun use (Lkotlinx/coroutines/experimental/channels/ReceiveChannel;Lkotlin/jvm/functions/Function1;)V
+	public static final fun use (Lkotlinx/coroutines/experimental/channels/ReceiveChannel;Lkotlin/jvm/functions/Function1;)Ljava/lang/Object;
 }
 
 public final class kotlinx/coroutines/experimental/channels/BroadcastKt {

common/kotlinx-coroutines-core-common/src/main/kotlin/kotlinx/coroutines/experimental/channels/BroadcastChannel.kt

@@ -111,16 +111,19 @@ public interface SubscriptionReceiveChannel<out T> : ReceiveChannel<T>, Closeabl
 }
 
 /** @suppress **Deprecated**: Left here for migration from SubscriptionReceiveChannel */
-@Deprecated(level = DeprecationLevel.HIDDEN, message = "Use `ReceiveChannel<*>.consume` instead")
-public inline fun <E, R> ReceiveChannel<E>.use(block: (ReceiveChannel<E>) -> R) {
+@Deprecated(
+    level = DeprecationLevel.WARNING,
+    message = "Use `ReceiveChannel<*>.consume` instead",
+    replaceWith = ReplaceWith("consume { let(block) }")
+)
+public inline fun <E, R> ReceiveChannel<E>.use(block: (ReceiveChannel<E>) -> R): R {
     var exception: Throwable? = null
     try {
-        block(this)
+        return block(this)
     } catch (t: Throwable) {
         exception = t
         throw t
-    }
-    finally {
+    } finally {
         this.cancel(exception)
     }
 }