Documentation export is missing information

How are you using the lua-language-server?

Command Line

Which OS are you using?

Windows

What is the issue affecting?

Other

Expected Behaviour

After generating documentation with --doc, I expected to have access to the all of the information available in the annotations that is presented or used by the language server.

Actual Behaviour

There were a few things that are missing or strange:

• @see annotations are absent.
• Access levels (@protected, @private, @package) are absent.
• Aliases that extend other aliases include the documentation of the alias that they extend, which makes it difficult to tell which documentation belongs to only the extended alias.
• The start and finish fields seem odd; they're very large numbers (e.g., 5490009, 5490021) that clearly don't refer to character ranges within the files. What are these numbers?

For the purpose of generating documentation, the first two problems seem significant—it would be difficult to filter out private fields and methods, for example.

Reproduction steps

1. Create a Lua file that uses access modifiers, @see, and an alias that extends another alias. I've provided a minimal example of such a file below.
2. Observe the missing data and oddities.

Additional Notes

Example for reproduction:

---@class C
---@field private z integer
local C = {}

---Base alias doc comment.
---@alias Base
---| 'A'
---| 'B'

---Extended alias doc comment.
---@alias Derived
---| Base
---| 'C'

---@protected
function C.x()
end

---@see C.x
function C.y()
end

Log File

No response

Commencez par exécuter l’export --doc sur la reproduction en Lua de l’issue et examinez comment sa sortie représente @see, les modificateurs d’accès, la documentation d’alias héritée et start/finish. Suivez le point d’entrée de l’export de documentation et comparez sa sortie avec les informations d’annotation utilisées par le serveur de langage. Le travail est terminé lorsque les données exportées préservent les détails d’annotation demandés et expliquent ou corrigent les valeurs de plage.