Merge pull request #327 from mipt-npm/commandertvis/unstable

Document and change retention for UnstableKMathAPI
This commit is contained in:
Alexander Nozik 2021-05-11 09:01:16 +03:00 committed by GitHub
commit e302b5ea4c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

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