[ #364 ] fix debugger hints and support documentation of SymbolLhs(const)

Author: zxj5470

docs/Debugger.md

@@ -18,17 +18,17 @@ Install IntelliJ IDEA (or other JetBrains IntelliJ platform IDEs such as PyCharm
 
 ## Dependencies
 
-- ASTInterpreter2#master
-- DebuggerFramework#master
+- ASTInterpreter2#73711a4
+- DebuggerFramework#78d649e
 - JSON
 - Julia 0.7+
 
 > (using the master branch is required by the debugger)
 
 ### add packages
 ```julia
-(v1.0) pkg> add DebuggerFramework#master
-(v1.0) pkg> add ASTInterpreter2#master
+(v1.0) pkg> add DebuggerFramework#78d649e
+(v1.0) pkg> add ASTInterpreter2#73711a4
 (v1.0) pkg> add JSON
 ```
 

res/org/ice1000/julia/lang/execution/IntelliJDebugger.jl

@@ -15,13 +15,13 @@ if VERSION >= v"0.7.0"
     if "DebuggerFramework" in keys(pkgs) && pkgs["DebuggerFramework"] >= v"0.1.2+"
         println("DebuggerFramework version $(pkgs["DebuggerFramework"]) correct.")
     else
-        println("please add latest version DebuggerFramework by `add DebuggerFramework#78d649e` within pkg REPL.")
+        println("please add lagacy version DebuggerFramework by `add DebuggerFramework#78d649e` within pkg REPL.")
     end
 
     if "ASTInterpreter2" in keys(pkgs) && pkgs["ASTInterpreter2"] >= v"0.1.1+"
         println("ASTInterpreter2 version $(pkgs["ASTInterpreter2"]) correct.")
     else
-        println("please add latest version ASTInterpreter2 by `add ASTInterpreter2#73711a4` within pkg REPL.")
+        println("please add lagacy version ASTInterpreter2 by `add ASTInterpreter2#73711a4` within pkg REPL.")
     end
 else # 0.6
     using Compat

src/org/ice1000/julia/lang/editing/julia-document.kt

@@ -5,7 +5,6 @@ import com.intellij.openapi.project.Project
 import com.intellij.openapi.wm.ToolWindow
 import com.intellij.openapi.wm.ToolWindowFactory
 import com.intellij.psi.PsiElement
-import com.intellij.psi.PsiManager
 import com.intellij.ui.content.ContentFactory
 import com.intellij.util.ui.UIUtil
 import org.apache.commons.lang.StringEscapeUtils
@@ -28,25 +27,42 @@ class JuliaDocumentProvider : AbstractDocumentationProvider() {
 	override fun generateDoc(element: PsiElement?, originalElement: PsiElement?): String? {
 		val symbol = element ?: return null
 		val parent = symbol.parent as? DocStringOwner
+		val name = "# ${symbol.text}\n"
 		return when {
 			// function declaration by written
 			parent != null -> {
-				val name = "# ${symbol.text}\n"
-				parent.docString?.text?.trim('"')?.let {
-					STYLE_HTML + SimplifyJBMarkdownUtil.generateMarkdownHtml(name + it)
-				}
+				val content = parent.docString?.text
+				buildDocument(content, name)
 			}
-			// if Docs.doc can find
 			symbol is JuliaSymbol -> {
-				val ret = symbol.project.languageServer.searchDocsByName(symbol.text) ?: return null
-				val unescaped = StringEscapeUtils.unescapeJava(ret.trim('"'))
-				if (unescaped.startsWith("__INTELLIJ__")) return null
-				STYLE_HTML + SimplifyJBMarkdownUtil.generateMarkdownHtml(unescaped)
+				// find previous docs
+				val symbolOrLhs = symbol.parent.takeIf { it is JuliaSymbolLhs } ?: symbol
+				when {
+					symbolOrLhs.parent is JuliaAssignOp -> {
+						val stringElement = symbolOrLhs.parent.prevRealSibling?.takeIf { it is JuliaString }
+						return buildDocument(stringElement?.text, name) ?: searchFromLanguageServer(symbol)
+					}
+					else -> // else use LanguageServer
+						return searchFromLanguageServer(symbol)
+				}
 			}
 			else -> null
 		}
 	}
 
+	private fun buildDocument(content: String?, symbolName: String): String? {
+		return content?.trim('"')?.let {
+			STYLE_HTML + SimplifyJBMarkdownUtil.generateMarkdownHtml(symbolName + it)
+		}
+	}
+
+	private fun searchFromLanguageServer(symbol: JuliaSymbol): String? {
+		val ret = symbol.project.languageServer.searchDocsByName(symbol.text) ?: return null
+		val unescaped = StringEscapeUtils.unescapeJava(ret.trim('"'))
+		if (unescaped.startsWith("__INTELLIJ__")) return null
+		else return STYLE_HTML + SimplifyJBMarkdownUtil.generateMarkdownHtml(unescaped)
+	}
+
 	companion object {
 		// language=HTML
 		val STYLE_HTML: String

src/org/ice1000/julia/lang/psi/impl/julia-psi-ext.kt

@@ -43,7 +43,7 @@ val PsiElement.prevRealSibling: PsiElement?
 	get() {
 		var pre = this.prevSibling
 		while (pre != null) {
-			if (pre is PsiWhiteSpace) {
+			if (pre is PsiWhiteSpace || pre.elementType == JuliaTypes.EOL) {
 				pre = pre.prevSibling
 			} else {
 				return pre