It is better to have multiline for annote the @overload

[jakitliang]

How are you using the lua-language-server?

Visual Studio Code Extension (sumneko.lua)

Which OS are you using?

Windows

What is the issue affecting?

Annotations

Expected Behaviour

--- @overload fun(
--- x:number,
--- y:number,
--- width:number,
--- height:number
--- ):Object

Actual Behaviour

--- @overload fun(  x:number, y:number, width:number, height:number  ):Object

Reproduction steps

1. Go to '...'
2. Click '...'
3. See error '...'

Additional Notes

Please adding this feature because some of my annotation is really really long.

Writing in one line makes unreadable and ugly.

Thanks much!

Log File

No response

[jakitliang]

这个问题 我想吐槽很久很久了，为啥函数 注释 给那么一行

结果写得 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊 长啊

诺，就像 上面 👆 这样的

[CppCXY]

因为一般注解是按注释为单元解析的, 不同的注释之间如果要一起解析, 会面临一个问题, 我的下一段注释该不该作为当前注解的延续, 因为下一段注解完全可以是一个普通注释,而注解和非注解的tokenize是完全不同的. 要达成这样的解析,parser基本上只能做分支回溯.分支回溯的parser又很难写,可能当前没有考虑吧.

[jakitliang]

因为一般注解是按注释为单元解析的, 不同的注释之间如果要一起解析, 会面临一个问题, 我的下一段注释该不该作为当前注解的延续, 因为下一段注解完全可以是一个普通注释,而注解和非注解的tokenize是完全不同的. 要达成这样的解析,parser基本上只能做分支回溯.分支回溯的parser又很难写,可能当前没有考虑吧.

假设， S 为完整注释， F 为段落， A 为 Annotation
LL 都能做推导，你把一样注释 S -> F F，然后 F -> A 或 F-> nil 不就行咯。

[sumneko]

随便举个例子

---@overload fun()
---):this not work yet

这个要不要提示你语法错误呢？

[jakitliang]

我谢谢你哦~那你很棒棒哦！

[jakitliang]

随便举个例子

---@overload fun()
---):this not work yet

这个要不要提示你语法错误呢？

给个预期吧，啥时候能实现

[sumneko]

给个预期吧，啥时候能实现

目前没有可以实现的方案，你的方案有问题，我楼上已经给出反例了。

[jakitliang]

给个预期吧，啥时候能实现

目前没有可以实现的方案，你的方案有问题，我楼上已经给出反例了。

你给的反面例子 确实 已经 end 了，我原本例子是由 左括号结尾的

@overload fun( 

[CppCXY]

可行的方案是, 有明显的延续行标志, 这样LL1才比较好做

---@overload fun
---| (aaa,bbbb,ccc)
---| : number

[sumneko]

给个预期吧，啥时候能实现

目前没有可以实现的方案，你的方案有问题，我楼上已经给出反例了。

你给的反面例子 确实 已经 end 了，我原本例子是由 左括号结尾的

@overload fun( 

这样的话语义就不太明确了，某一行是否是注释还是注解的一部分会由前几行的语法决定

[jakitliang]

I don't care 延续 不延续，反正 overload 写一行 真的太长了

[jakitliang]

给个预期吧，啥时候能实现

目前没有可以实现的方案，你的方案有问题，我楼上已经给出反例了。

你给的反面例子 确实 已经 end 了，我原本例子是由 左括号结尾的

@overload fun( 

这样的话语义就不太明确了，某一行是否是注释还是注解的一部分会由前几行的语法决定

某一行 就不能 学 bash line end 给个 \ 斜杠 + 空格 表示换行？

[sumneko]

某一行 就不能 学 bash line end 给个 \ 斜杠 + 空格 表示换行？

简单想了一下这个方案技术上可行，可以考虑一下。
不过建议你以后提方案就好好提，不要用反问句。

[jakitliang]

某一行 就不能 学 bash line end 给个 \ 斜杠 + 空格 表示换行？

简单想了一下这个方案技术上可行，可以考虑一下。 不过建议你以后提方案就好好提，不要用反问句。

谢谢 亲亲爱爱的 森莓果大人~ 感激！