Introduce @FrontendInternals annotation

#KT-39643
2020-07-27 15:06:01 +03:00
parent eff5839369
commit ffc3d8bdfc
51 changed files with 172 additions and 11 deletions
@@ -0,0 +1,16 @@
+/*
+ * Copyright 2010-2020 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
+ */
+
+package org.jetbrains.kotlin.idea
+
+/**
+ * Indicates sensitive frontend API, which should be used with caution to avoid invariant violation.
+ * Use sites of this annotation include all methods for direct access to frontend components.
+ * Please make sure that components don't receive resolution results (descriptors etc.) from different resolution facade for processing.
+ * The simplest way to do so is to explicitly provide the same resolution facade to all related computations.
+ * Not following this rule may lead to obscure memory leaks and other potential problems.
+ */
+@RequiresOptIn
+annotation class FrontendInternals