diff --git a/kotlin-native/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Annotations.kt b/kotlin-native/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Annotations.kt index 45d534c8731..13a5f252d19 100644 --- a/kotlin-native/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Annotations.kt +++ b/kotlin-native/Interop/Runtime/src/main/kotlin/kotlinx/cinterop/Annotations.kt @@ -39,10 +39,12 @@ public annotation class UnsafeNumber(val actualPlatformTypes: Array) public annotation class BetaInteropApi /** - * Marks foreign-memory-related API as experimental. + * Marks foreign-language-related API as experimental. * * Foreign API includes all operations and classifiers that are required for operating with * unmanaged and foreign memory, including but not limited to such declarations as [CPointer], [CPointed], [StableRef], and `Pinned`. + * It also includes API of C and Objective-C libraries, except for those that are available in Kotlin by default + * (like `platform.posix.*` or `platform.Foundation.*`). * * Such API is considered experimental and has the following known limitations and caveats: * - It is either undocumented or lacks extensive and sound description.