azalea/kotlin-fork
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[Gradle] Add documentation to ExternalKotlinTargetApi

Browse Source 
KT-55524
This commit is contained in:
Sebastian Sellmair
2023-04-18 14:07:19 +02:00
committed by Space Team
parent 9f003328cf
commit b32cae293b
1 changed files with 11 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
libraries/tools/kotlin-gradle-plugin-annotations/src/main/kotlin/org/jetbrains/kotlin/gradle/ExternalKotlinTargetApi.kt
+11 -1
View File
@@ -5,8 +5,18 @@
package org.jetbrains.kotlin.gradle package org.jetbrains.kotlin.gradle
/**
* Marker for APIs that can be used by Google to build and maintain a 'KotlinTarget' outside the kotlin.git repository:
* Declarations marked with this annotation will be checked for binary compatibility.
*
* ### Stability Guarantee:
* Despite those APIs being verified for binary compatibility, the overall 'External Kotlin Target API' surface is
* not stabilised yet and changes might happen until 1.9.20
*
* After 1.9.20 this APIs will have to go through a full deprecation cycle before being broken.
*/
@RequiresOptIn( @RequiresOptIn(
message = "This API is intended to be used by Google to maintain KotlinTargets outside of kotlin.git", message = "This API can be used by Google to maintain KotlinTargets outside of kotlin.git",
level = RequiresOptIn.Level.ERROR level = RequiresOptIn.Level.ERROR
) )
annotation class ExternalKotlinTargetApi annotation class ExternalKotlinTargetApi