How to document @field values (description not shown when hovering the function)

[ChillerDragon]

---@class Foo
---
---desc1
---@field dostuff fun(param1: integer) # desc2
foo = {}


function foo.dostuff(param1)
	print(param1)
end

I have an api defined in my meta file with functions the user can define. According to the documentation https://luals.github.io/wiki/annotations/#field

The syntax is this one: ---@field [scope] <name[?]> <type> [description]
A bit sad that the description has to come after the field and can not be above it. If the type is already a long callback the entire annotation line with long description will be super long :(

Anyways even that one I could not get to work. My editor would not show the description when hovering the function. Also I could not go to its definition to at least manually browse the type annotations.

[carsakiller]

Interestingly enough, if the table is made local, it works as expected:

Once it is made global, the description disappears:

As for defining functions in a @field, there are various known limitations that could hopefully be fixed with a @function annotation.

[ChillerDragon]

Oh nice catch with it working as local. Sadly I can not use this workaround :/ because the type annotation comes from a meta file and is defined in C++ so without the global definition the instance of the table would not be in scope at all as far as I understand.