Basic annotation for delegation and override

[Wes0617]

When overriding a method without changing its signature, it would be very useful to have an annotation for inheriting the documentation and the annotations from the "parent" method.

--- @class Test:Foo
Foo = {};

--- @inheritDoc Test.hello
function Foo:hello(a,b,c)
     -- override method
end

The effect of this should be the same of writing identical annotations to Test.hello and Foo.hello.
Additional annotations may be allowed below @inheritDoc. Such as defining a covariant return type, or adding more text.
I am sure LuaLS can do some of it automatically via --- @class Test:Foo, but @inheritDoc would be more generic and work also for other patterns such as delegation, decoration, or "abstract" methods/interfaces.

Just a random idea! Thanks!

[CppCXY]

A better annotation would be @override, on the one hand, it can be used to check if the parent class function is overridden, and on the other hand, it can be parameterized(eg. @override inherit-doc) to indicate document inheritance.