diff --git a/idea/idea-frontend-api/src/org/jetbrains/kotlin/idea/frontend/api/symbols/KtSymbol.kt b/idea/idea-frontend-api/src/org/jetbrains/kotlin/idea/frontend/api/symbols/KtSymbol.kt
index 28ef7591a53..92ba2ee3567 100644
--- a/idea/idea-frontend-api/src/org/jetbrains/kotlin/idea/frontend/api/symbols/KtSymbol.kt
+++ b/idea/idea-frontend-api/src/org/jetbrains/kotlin/idea/frontend/api/symbols/KtSymbol.kt
@@ -16,7 +16,13 @@ interface KtSymbol : ValidityTokenOwner {
     fun createPointer(): KtSymbolPointer<KtSymbol>
 }
 
+/**
+ * A place where [KtSymbol] came from
+ */
 enum class KtSymbolOrigin {
+    /**
+     * Declaration from Kotlin sources
+     */
     SOURCE,
 
     /**
@@ -25,6 +31,16 @@ enum class KtSymbolOrigin {
      * For enum classes the `valueOf` & `values` functions are generated
      */
     SOURCE_MEMBER_GENERATED,
+
+    /**
+     * A Kotlin declaration came from some .class file
+     */
     LIBRARY,
-    JAVA, SAM_CONSTRUCTOR
+
+    /**
+     * A Kotlin declaration came from some Java source file or from some Java library
+     */
+    JAVA,
+
+    SAM_CONSTRUCTOR
 }
\ No newline at end of file