Clarify code around reference proxying

src/glslplugin/lang/elements/GLSLIdentifier.java

@@ -64,22 +64,18 @@ public PsiElement setName(@NotNull String name) throws IncorrectOperationExcepti
         return newName;
     }
 
-    @Nullable
-    private GLSLReferenceElement getRealReference() {
-        PsiElement parent = getParent();
-        if (parent instanceof GLSLReferenceElement) {
-            return (GLSLReferenceElement) parent;
-        } else {
-            return null;
-        }
-    }
-
+    /**
+     * GLSLIdentifier can be a reference to pretty much anything (functions, variables...),
+     * but it poses only as a "source", the real logic is in the parent.
+     * @return getReferenceProxy() of parent if parent is GLSLReferenceElement
+     * @see GLSLReferenceElement
+     */
     @Override
     @Nullable
     public PsiReference getReference() {
-        GLSLReferenceElement theRealReference = getRealReference();
-        if (theRealReference != null) {
-            return theRealReference.getReferenceProxy();
+        PsiElement parent = getParent();
+        if (parent instanceof GLSLReferenceElement) {
+            return ((GLSLReferenceElement) parent).getReferenceProxy();
         } else {
             return null;
         }

src/glslplugin/lang/elements/preprocessor/GLSLRedefinedToken.java

@@ -16,6 +16,9 @@ public GLSLRedefinedToken(@NotNull ASTNode astNode) {
         super(astNode);
     }
 
+    /**
+     * @return reference to the #define which caused the redefinition of this token
+     */
     @Override
     public GLSLMacroReference getReference() {
         return new GLSLMacroReference(this);