diff --git a/analysis/project-structure/src/org/jetbrains/kotlin/analysis/project/structure/KotlinModuleDependentsProvider.kt b/analysis/project-structure/src/org/jetbrains/kotlin/analysis/project/structure/KotlinModuleDependentsProvider.kt index 828658ad42e..b8bb0e78ae4 100644 --- a/analysis/project-structure/src/org/jetbrains/kotlin/analysis/project/structure/KotlinModuleDependentsProvider.kt +++ b/analysis/project-structure/src/org/jetbrains/kotlin/analysis/project/structure/KotlinModuleDependentsProvider.kt @@ -10,6 +10,11 @@ import com.intellij.openapi.project.Project /** * [KotlinModuleDependentsProvider] provides dependents for a [KtModule], which are modules that depend on the [KtModule]. * + * [getDirectDependents] and [getTransitiveDependents] may return an empty set for [KtBuiltinsModule]s and [KtSdkModule]s even though most + * modules depend on builtins/SDKs, because it is often not feasible to compute that set. Instead, users of [KotlinModuleDependentsProvider] + * should keep this limitation in mind and handle it separately. For example, a global modification event should be published for builtins + * and SDK changes. + * * Implementations of this provider should ensure that results are provided in reasonable time, for example by caching results, as its * functions may be called frequently. */