ExperimentalAnnotationsInMetadata

Marks an API related to the experimental feature "annotations in metadata", enabled by the compiler flag -Xannotations-in-metadata (https://youtrack.jetbrains.com/issue/KT-57919).

kotlin-metadata-jvm clients are encouraged to update the code that reads and writes Kotlin metadata with the support of new annotations, before annotations in metadata become enabled by default (https://youtrack.jetbrains.com/issue/KT-75736).

Note that we have one-version forward compatibility policy on Kotlin/JVM, so kotlin-metadata-jvm 2.2 can read and write metadata of version 2.3. In case annotations in metadata are enabled by default in 2.3, not handling them via kotlin-metadata-jvm of version 2.2 will likely produce incorrect results on class files compiled by Kotlin 2.3. Clients can use the Kotlin compiler flag -Xannotations-in-metadata to check that annotations in metadata are read/written correctly.