Per-parameter signature help documentation

[datho7561]

See #1291

Signed-off-by: David Thompson [email protected]

[datho7561]

I still need to support Markdown vs plaintext properly in this PR, and using regex to split up the parameter documentation isn't the most efficient solution, but other than that, I think this could work.

edit: I think I'm missing something, but I don't think that I can detect if the client supports markdown from the method where I'm generating the signature help parameter documentation.

[rgrunber]

According to the spec, https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#signatureHelpClientCapabilities , documentationFormat, is an array of MarkupKind that represents the preferred order of the format.

[datho7561]

Yes, unfortunately I don't think I get that information in the function where I implement the per-param documentation. This means I will probably have to do a refactoring, so it might be a while longer for this PR. Also, while I'm at it, I should also refactor parts of JavadocContentAccess2 so that I can collect the parameter documentation without the general method documentation.