@elizarov Would you be interested in this contribution?

public suspend inline fun <T : Closeable?, R> T.useCancellably(
        crossinline block: (T) -> R
): R = suspendCancellableCoroutine { cont ->
    cont.invokeOnCancellation { this?.close() }
    use(block)
}

What is the use-case?

For any blocking java work

What kind of blocking java work? Example?

Example:

runBlocking {
        val foo = launch(<http://Dispatchers.IO|Dispatchers.IO>) {
            ServerSocket(PORT).useCancellably {
                it.accept()
                // ...
            }
        }

        delay(100)

        print("Cancelling")
        foo.cancel()
    }

Why would use blocking scokets with coroutines?

TBH, that was just a playground

I see the point. The only problem is that is it a very dangerous thing to give to users in a lib. Many blocking closeable things in Java cannot be concurrently closed (example: JDBC connections) and by trying to close them concurrently you’ll just make it worse

Do you think it would be worth showing in the docs?

I don’t know. Our docs are already too large. They need more simpler examples and explanations for basic concepts.

Yeah, that's true 😆 😭