Add the ability to annotate exceptions @raises

[vaintrub]

Hello! I have a suggestion to add a new annotation - @raises
I think it would be useful to anyone who has a layer of error classes in their module.

Example:

--- @class NetworkError: cdata
--- @field code number
--- @field body number

--- @raises
---| NetworkError
function some_func() end

[carsakiller]

@throws might be a better choice

[firas-assaad]

What are exceptions in this case? Error objects passed to the error() function and caught with pcall? If that's the case, @raises is a better name because that's the term used in the reference manual: https://www.lua.org/manual/5.4/manual.html#2.3

[ochaton]

@firas-assaad exceptions are objects raised by lua_error. They can be caught by pcall, so yeah @raises sounds good. What should be done to make some progress on this issue? :)