Mark all Worker-related API as obsolete.

* Explain what obsolete means and why workers are obsolete
* Add some documentation to workers to explain its common pitfalls

^KT-54702


Merge-request: KT-MR-9563
Merged-by: Vsevolod Tolstopyatov <qwwdfsad@gmail.com>

kotlin-native/backend.native/tests/codegen/initializers/workers1.kt

@@ -20,6 +20,7 @@ val z1 = Z(42)
 val z2 = Z(x.s.length)
 
 // FILE: main.kt
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 
 fun foo() {
@@ -32,4 +33,4 @@ fun foo() {
 fun main() {
     foo()
     println(z2.x)
-}
+}

kotlin-native/backend.native/tests/codegen/initializers/workers2.kt

@@ -12,6 +12,7 @@ class Z(val x: Int)
 val z = Z(42)
 
 // FILE: main.kt
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 
 fun main() {
@@ -20,4 +21,4 @@ fun main() {
     worker.execute(TransferMode.SAFE, { -> }, {
         it -> println(z.x)
     }).consume { }
-}
+}

kotlin-native/backend.native/tests/framework/multiple/shared/shared.kt

@@ -1,4 +1,5 @@
-import kotlin.native.concurrent.Worker
+@file:OptIn(ObsoleteWorkersApi::class)
+import kotlin.native.concurrent.*
 
 object RuntimeState {
     fun produceChange() {

kotlin-native/backend.native/tests/interop/objc/illegal_sharing.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 import kotlin.test.*

kotlin-native/backend.native/tests/interop/objc/illegal_sharing_with_weak/main.kt

@@ -1,3 +1,4 @@
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 import kotlinx.cinterop.autoreleasepool
 import objclib.*

kotlin-native/backend.native/tests/interop/objc/kt42172/main.kt

@@ -1,4 +1,4 @@
-@file:OptIn(kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class
 
 import objclib.*
 import kotlin.native.concurrent.*

kotlin-native/backend.native/tests/interop/objc/tests/objcWeakRefs.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class, kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(FreezingIsDeprecated::class, kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class)
 
 import kotlinx.cinterop.*
 import kotlin.native.concurrent.*

kotlin-native/backend.native/tests/interop/objc/tests/sharing.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlinx.cinterop.*
 import kotlin.native.concurrent.*

kotlin-native/backend.native/tests/interop/objc/tests/utils.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlinx.cinterop.*
 import kotlin.native.concurrent.*
@@ -16,4 +16,4 @@ fun nsArrayOf(vararg elements: Any): NSArray = NSMutableArray().apply {
     elements.forEach {
         this.addObject(it as ObjCObject)
     }
-}
+}

kotlin-native/backend.native/tests/interop/objc/tests/workerAutoreleasePool.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/interop/workerSignals/workerSignals.kt

@@ -1,4 +1,4 @@
-@file:OptIn(kotlin.ExperimentalStdlibApi::class)
+@file:OptIn(kotlin.ExperimentalStdlibApi::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/basic/cleaner_in_tls_worker.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(ExperimentalStdlibApi::class, kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(ExperimentalStdlibApi::class, kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class)
 
 import kotlin.test.*
 

kotlin-native/backend.native/tests/runtime/basic/cleaner_workers.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(ExperimentalStdlibApi::class, FreezingIsDeprecated::class, kotlin.experimental.ExperimentalNativeApi::class, kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(ExperimentalStdlibApi::class, FreezingIsDeprecated::class, kotlin.experimental.ExperimentalNativeApi::class, kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class)
 
 package runtime.basic.cleaner_workers
 

kotlin-native/backend.native/tests/runtime/basic/initializers6.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.basic.initializers6
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/basic/worker_random.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.basic.worker_random
 
 import kotlin.native.concurrent.*
@@ -39,4 +40,4 @@ fun testRandomWorkers() {
     workers.forEach {
         it.requestTermination().result
     }
-}
+}

kotlin-native/backend.native/tests/runtime/concurrent/worker_bound_reference0.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class, kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(FreezingIsDeprecated::class, kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class)
 
 package runtime.concurrent.worker_bound_reference0
 

kotlin-native/backend.native/tests/runtime/memory/stable_ref_cross_thread_check.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.memory.stable_ref_cross_thread_check
 

kotlin-native/backend.native/tests/runtime/workers/atomic0.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.atomic0
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/enum_identity.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.enum_identity
 
 import kotlin.test.*
@@ -21,4 +22,4 @@ fun runTest() {
         input.kind == A.B
     }).result
     println(result)
-}
+}

kotlin-native/backend.native/tests/runtime/workers/freeze0.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.freeze0
 
@@ -30,4 +30,4 @@ data class SharedData(val string: String, val int: Int, val member: SharedDataMe
     }
     worker.requestTermination().result
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/freeze2.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.freeze2
 

kotlin-native/backend.native/tests/runtime/workers/freeze3.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.freeze3
 

kotlin-native/backend.native/tests/runtime/workers/lazy0.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.lazy0
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/lazy4.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.lazy4
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/leak_memory_with_worker_termination.kt

@@ -1,3 +1,4 @@
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 import kotlin.native.Platform
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/runtime/workers/leak_worker.kt

@@ -1,3 +1,4 @@
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 import kotlin.native.Platform
 import kotlinx.cinterop.*

kotlin-native/backend.native/tests/runtime/workers/mutableData1.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.mutableData1
 
 import kotlin.native.concurrent.*
@@ -45,4 +45,4 @@ private fun assertContentsEquals(expected: ByteArray, actual: MutableData) {
     expected.forEachIndexed { index, byte ->
         assertEquals(byte, actual.get(index))
     }
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker0.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.worker0
 
 import kotlin.test.*
@@ -22,4 +23,4 @@ import kotlin.native.concurrent.*
     }
     worker.requestTermination().result
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker1.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.worker1
 
 import kotlin.test.*
@@ -32,4 +33,4 @@ import kotlin.native.concurrent.*
         it.requestTermination().result
     }
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker10.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class, kotlin.experimental.ExperimentalNativeApi::class, kotlin.native.runtime.NativeRuntimeApi::class)
+@file:OptIn(FreezingIsDeprecated::class, kotlin.experimental.ExperimentalNativeApi::class, kotlin.native.runtime.NativeRuntimeApi::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker10
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker11.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker11
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker2.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.worker2
 
 import kotlin.test.*
@@ -42,4 +43,4 @@ data class WorkerResult(val intResult: Int, val stringResult: String)
         it.requestTermination().result
     }
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker3.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.worker3
 
 import kotlin.test.*
@@ -33,4 +34,4 @@ fun main(args: Array<String>) {
     if (dataParam.int != 17) println("Fail 2")
     worker.requestTermination().result
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker4.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker4
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker5.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlin.test.*
 
@@ -50,4 +50,4 @@ fun main() {
     runTest0()
     runTest1()
     runTest2()
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker6.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker6
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker7.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 package runtime.workers.worker7
 
 import kotlin.test.*
@@ -25,4 +26,4 @@ import kotlin.native.concurrent.*
     worker.requestTermination().result
 
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker8.kt

@@ -2,7 +2,7 @@
  * Copyright 2010-2018 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license
  * that can be found in the LICENSE file.
  */
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.worker8
 
@@ -30,4 +30,4 @@ data class SharedData(val string: String, val int: Int, val member: SharedDataMe
     }
     worker.requestTermination().result
     println("OK")
-}
+}

kotlin-native/backend.native/tests/runtime/workers/worker9.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker9
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker9_experimentalMM.kt

@@ -3,7 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker9_experimentalMM
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker_exception_messages.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 package runtime.workers.worker_exception_messages
 
 import kotlin.test.*

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.worker_exceptions
 

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions_legacy.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.worker_exceptions_legacy
 

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions_terminate.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions_terminate_current.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class)
+@file:OptIn(FreezingIsDeprecated::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions_terminate_hook.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class, ExperimentalStdlibApi::class)
+@file:OptIn(FreezingIsDeprecated::class, ExperimentalStdlibApi::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 

kotlin-native/backend.native/tests/runtime/workers/worker_exceptions_terminate_hook_current.kt

@@ -1,4 +1,4 @@
-@file:OptIn(FreezingIsDeprecated::class, ExperimentalStdlibApi::class)
+@file:OptIn(FreezingIsDeprecated::class, ExperimentalStdlibApi::class, ObsoleteWorkersApi::class)
 
 import kotlin.native.concurrent.*
 

kotlin-native/backend.native/tests/runtime/workers/worker_list_workers.kt

@@ -1,4 +1,4 @@
-@file:OptIn(kotlin.ExperimentalStdlibApi::class)
+@file:OptIn(kotlin.ExperimentalStdlibApi::class, ObsoleteWorkersApi::class)
 
 package runtime.workers.worker_list_workers
 

kotlin-native/backend.native/tests/runtime/workers/worker_threadlocal_no_leak.kt

@@ -3,6 +3,7 @@
  * that can be found in the LICENSE file.
  */
 
+@file:OptIn(ObsoleteWorkersApi::class)
 import kotlin.native.concurrent.*
 import kotlin.native.Platform