Document and change retention for UnstableKMathAPI

This commit is contained in:
Iaroslav Postovalov 2021-05-09 18:10:06 +07:00
parent 6d78bb8d91
commit bbef697b7d
No known key found for this signature in database
GPG Key ID: 46E15E4A31B3BCD7

View File

@ -5,5 +5,13 @@
package space.kscience.kmath.misc
/**
* Marks declarations that are still experimental in the KMath APIs, which means that the design of the corresponding
* declarations has open issues which may (or may not) lead to their changes in the future. Roughly speaking, there is
* a chance that those declarations will be deprecated in the near future or the semantics of their behavior may change
* in some way that may break some code.
*/
@MustBeDocumented
@Retention(value = AnnotationRetention.BINARY)
@RequiresOptIn("This API is unstable and could change in future", RequiresOptIn.Level.WARNING)
public annotation class UnstableKMathAPI