Reapply "Introduce @FrontendInternals annotation""

This reverts commit 9ca4717d11. ^KT-39643 Fixed
2020-08-10 12:14:01 +03:00
parent 5e8e60a399
commit f431da2a66
52 changed files with 214 additions and 57 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