[Native, Wasm] Add `@MustBeDocumented` to opt-in annotations
Without `@MustBeDocumented` the annotations will not be shown in usages
in the generated online Dokka documentation.
^KT-69142
diff --git a/kotlin-native/runtime/src/main/kotlin/kotlin/native/ObsoleteNativeApi.kt b/kotlin-native/runtime/src/main/kotlin/kotlin/native/ObsoleteNativeApi.kt
index bdbca0e..d9941e7 100644
--- a/kotlin-native/runtime/src/main/kotlin/kotlin/native/ObsoleteNativeApi.kt
+++ b/kotlin-native/runtime/src/main/kotlin/kotlin/native/ObsoleteNativeApi.kt
@@ -5,8 +5,6 @@
package kotlin.native
-import kotlin.annotation.AnnotationTarget.*
-
/**
* This annotation marks the Kotlin/Native standard library API that is considered obsolete and is being phased out.
*
@@ -34,4 +32,4 @@
@MustBeDocumented
@SinceKotlin("1.9")
@Suppress("ACTUAL_WITHOUT_EXPECT") // actual visibility mismatch
-public actual annotation class ObsoleteNativeApi
\ No newline at end of file
+public actual annotation class ObsoleteNativeApi
diff --git a/libraries/stdlib/native-wasm/src/kotlin/native/FreezingIsDeprecated.kt b/libraries/stdlib/native-wasm/src/kotlin/native/FreezingIsDeprecated.kt
index 913f03a..513ae82 100644
--- a/libraries/stdlib/native-wasm/src/kotlin/native/FreezingIsDeprecated.kt
+++ b/libraries/stdlib/native-wasm/src/kotlin/native/FreezingIsDeprecated.kt
@@ -33,4 +33,5 @@
AnnotationTarget.TYPEALIAS,
)
@Retention(AnnotationRetention.BINARY)
+@MustBeDocumented
public actual annotation class FreezingIsDeprecated
diff --git a/libraries/stdlib/native-wasm/src/kotlin/native/ObsoleteNativeApi.kt b/libraries/stdlib/native-wasm/src/kotlin/native/ObsoleteNativeApi.kt
index d417ba5..911d43a 100644
--- a/libraries/stdlib/native-wasm/src/kotlin/native/ObsoleteNativeApi.kt
+++ b/libraries/stdlib/native-wasm/src/kotlin/native/ObsoleteNativeApi.kt
@@ -5,8 +5,6 @@
package kotlin.native
-import kotlin.annotation.AnnotationTarget.*
-
/**
* This annotation marks the Kotlin/Native standard library API that is considered obsolete and is being phased out.
*
@@ -31,4 +29,4 @@
@MustBeDocumented
@SinceKotlin("1.9")
@OptionalExpectation // though it has actuals in all dependent source sets, otherwise it is not possible to make it require opt-in
-internal expect annotation class ObsoleteNativeApi()
\ No newline at end of file
+internal expect annotation class ObsoleteNativeApi()
diff --git a/libraries/stdlib/native-wasm/src/kotlin/native/concurrent/ObsoleteWorkersApi.kt b/libraries/stdlib/native-wasm/src/kotlin/native/concurrent/ObsoleteWorkersApi.kt
index 787fe51..53eec0d 100644
--- a/libraries/stdlib/native-wasm/src/kotlin/native/concurrent/ObsoleteWorkersApi.kt
+++ b/libraries/stdlib/native-wasm/src/kotlin/native/concurrent/ObsoleteWorkersApi.kt
@@ -37,4 +37,5 @@
AnnotationTarget.TYPEALIAS,
)
@Retention(AnnotationRetention.BINARY)
+@MustBeDocumented
public annotation class ObsoleteWorkersApi
diff --git a/libraries/stdlib/src/kotlin/annotations/NativeAnnotations.kt b/libraries/stdlib/src/kotlin/annotations/NativeAnnotations.kt
index 6b87fad..d5e0eca 100644
--- a/libraries/stdlib/src/kotlin/annotations/NativeAnnotations.kt
+++ b/libraries/stdlib/src/kotlin/annotations/NativeAnnotations.kt
@@ -49,6 +49,7 @@
AnnotationTarget.TYPEALIAS,
)
@Retention(AnnotationRetention.BINARY)
+@MustBeDocumented
@OptionalExpectation
public expect annotation class FreezingIsDeprecated
@@ -132,4 +133,3 @@
@ExperimentalObjCRefinement
@SinceKotlin("1.8")
public expect annotation class ShouldRefineInSwift()
-
