[K/N] Deprecated freezing ^KT-50541

Starting with 1.7.20 freezing is deprecated. See https://github.com/JetBrains/kotlin/blob/master/kotlin-native/NEW_MM.md#freezing-deprecation for details.

Merge-request: KT-MR-6399
Merged-by: Alexander Shabalin <Alexander.Shabalin@jetbrains.com>

libraries/stdlib/src/kotlin/annotations/NativeAnnotations.kt

@@ -16,3 +16,33 @@ package kotlin.native
 @Retention(AnnotationRetention.BINARY)
 @OptionalExpectation
 public expect annotation class CName(val externName: String = "", val shortName: String = "")
+
+/**
+ * Freezing API is deprecated since 1.7.20.
+ *
+ * See [NEW_MM.md#freezing-deprecation](https://github.com/JetBrains/kotlin/blob/master/kotlin-native/NEW_MM.md#freezing-deprecation) for details
+ */
+// Note: when changing level of deprecation here, also change
+// * `freezing` mode handling in KonanConfig.kt
+// * frontend diagnostics in ErrorsNative.kt
+@SinceKotlin("1.7")
+@RequiresOptIn(
+    message = "Freezing API is deprecated since 1.7.20. See https://github.com/JetBrains/kotlin/blob/master/kotlin-native/NEW_MM.md#freezing-deprecation for details",
+    level = RequiresOptIn.Level.WARNING,
+)
+@Target(
+    AnnotationTarget.CLASS,
+    AnnotationTarget.ANNOTATION_CLASS,
+    AnnotationTarget.PROPERTY,
+    AnnotationTarget.FIELD,
+    AnnotationTarget.LOCAL_VARIABLE,
+    AnnotationTarget.VALUE_PARAMETER,
+    AnnotationTarget.CONSTRUCTOR,
+    AnnotationTarget.FUNCTION,
+    AnnotationTarget.PROPERTY_GETTER,
+    AnnotationTarget.PROPERTY_SETTER,
+    AnnotationTarget.TYPEALIAS,
+)
+@Retention(AnnotationRetention.BINARY)
+@OptionalExpectation
+expect annotation class FreezingIsDeprecated

libraries/stdlib/src/kotlin/annotations/NativeConcurrentAnnotations.kt

@@ -21,6 +21,8 @@ package kotlin.native.concurrent
 public expect annotation class ThreadLocal()
 
 /**
+ * Note: with the new MM this annotation has no effect.
+ *
  * Marks a top level property with a backing field as immutable.
  * It is possible to share the value of such property between multiple threads, but it becomes deeply frozen,
  * so no changes can be made to its state or the state of objects it refers to.
@@ -28,9 +30,12 @@ public expect annotation class ThreadLocal()
  * The annotation has effect only in Kotlin/Native platform.
  *
  * PLEASE NOTE THAT THIS ANNOTATION MAY GO AWAY IN UPCOMING RELEASES.
+ *
+ * Since 1.7.20 usage of this annotation is deprecated. See https://github.com/JetBrains/kotlin/blob/master/kotlin-native/NEW_MM.md#freezing-deprecation for details.
  */
 @Target(AnnotationTarget.PROPERTY)
 @Retention(AnnotationRetention.BINARY)
+// Not @FreezingIsDeprecated: Lots of usages, only the doc updated.
 @OptionalExpectation
 public expect annotation class SharedImmutable()