Document and change retention for UnstableKMathAPI #327

Merged
CommanderTvis merged 1 commits from commandertvis/unstable into dev 2021-05-11 09:01:16 +03:00
Showing only changes of commit bbef697b7d - Show all commits

View File

@ -5,5 +5,13 @@
package space.kscience.kmath.misc 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) @RequiresOptIn("This API is unstable and could change in future", RequiresOptIn.Level.WARNING)
public annotation class UnstableKMathAPI public annotation class UnstableKMathAPI