Rename UseExperimental->OptIn, Experimental->RequiresOptIn in stdlib kdocs

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

@@ -11,8 +11,8 @@ import kotlin.annotation.AnnotationTarget.*
  * with the future versions of the standard library.
  *
  * Any usage of a declaration annotated with `@ExperimentalStdlibApi` must be accepted either by
- * annotating that usage with the [UseExperimental] annotation, e.g. `@UseExperimental(ExperimentalStdlibApi::class)`,
- * or by using the compiler argument `-Xuse-experimental=kotlin.ExperimentalStdlibApi`.
+ * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalStdlibApi::class)`,
+ * or by using the compiler argument `-Xopt-in=kotlin.ExperimentalStdlibApi`.
  */
 @Experimental(level = Experimental.Level.ERROR)
 @RequiresOptIn(level = RequiresOptIn.Level.ERROR)

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

@@ -13,8 +13,8 @@ import kotlin.internal.RequireKotlinVersionKind
  * The experimental multiplatform support API marker.
  *
  * Any usage of a declaration annotated with `@ExperimentalMultiplatform` must be accepted either by
- * annotating that usage with the [UseExperimental] annotation, e.g. `@UseExperimental(ExperimentalMultiplatform::class)`,
- * or by using the compiler argument `-Xuse-experimental=kotlin.ExperimentalMultiplatform`.
+ * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalMultiplatform::class)`,
+ * or by using the compiler argument `-Xopt-in=kotlin.ExperimentalMultiplatform`.
  */
 @Experimental
 @RequiresOptIn

libraries/stdlib/src/kotlin/contracts/ContractBuilder.kt

@@ -13,8 +13,8 @@ import kotlin.internal.InlineOnly
  * when declaring contracts of user functions.
  *
  * Any usage of a declaration annotated with `@ExperimentalContracts` must be accepted either by
- * annotating that usage with the [UseExperimental] annotation, e.g. `@UseExperimental(ExperimentalContracts::class)`,
- * or by using the compiler argument `-Xuse-experimental=kotlin.contracts.ExperimentalContracts`.
+ * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalContracts::class)`,
+ * or by using the compiler argument `-Xopt-in=kotlin.contracts.ExperimentalContracts`.
  */
 @Retention(AnnotationRetention.BINARY)
 @SinceKotlin("1.3")

libraries/stdlib/src/kotlin/experimental/inferenceMarker.kt

@@ -9,8 +9,8 @@ package kotlin.experimental
  * The experimental marker for type inference augmenting annotations.
  *
  * Any usage of a declaration annotated with `@ExperimentalTypeInference` must be accepted either by
- * annotating that usage with the [UseExperimental] annotation, e.g. `@UseExperimental(ExperimentalTypeInference::class)`,
- * or by using the compiler argument `-Xuse-experimental=kotlin.experimental.ExperimentalTypeInference`.
+ * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalTypeInference::class)`,
+ * or by using the compiler argument `-Xopt-in=kotlin.experimental.ExperimentalTypeInference`.
  */
 @Experimental(level = Experimental.Level.ERROR)
 @RequiresOptIn(level = RequiresOptIn.Level.ERROR)

libraries/stdlib/src/kotlin/time/ExperimentalTime.kt

@@ -15,8 +15,8 @@ import kotlin.annotation.AnnotationTarget.*
  * with the future versions of the standard library.
  *
  * Any usage of a declaration annotated with `@ExperimentalTime` must be accepted either by
- * annotating that usage with the [UseExperimental] annotation, e.g. `@UseExperimental(ExperimentalTime::class)`,
- * or by using the compiler argument `-Xuse-experimental=kotlin.time.ExperimentalTime`.
+ * annotating that usage with the [OptIn] annotation, e.g. `@OptIn(ExperimentalTime::class)`,
+ * or by using the compiler argument `-Xopt-in=kotlin.time.ExperimentalTime`.
  */
 @Experimental(level = Experimental.Level.ERROR)
 @RequiresOptIn(level = RequiresOptIn.Level.ERROR)