bug#60805: [PATCH] Extend go-ts-mode with command to add docstring to function

[Eshel Yaron]

Eli Zaretskii <eliz@gnu.org> writes:

>> From: Theodor Thornhill <theo@thornhill.no>
>> Cc: Evgeni Kolev <evgenysw@gmail.com>,  dev@rjt.dev,  60805@debbugs.gnu.org
>> Date: Sat, 14 Jan 2023 12:43:21 +0100
>> 
>> Should we maybe generalize this into something all *-ts-modes can use?
>
> I don't know how widespread are such features with other languages.
>
>> Maybe it also could support some syntax to be used by for example
>> yasnippet?  There are examples on how to do so in eglot.el, if I'm not
>> mistaken.
>
> Maybe.  I'd have to see code to have an opinion.  Emacs never had such
> features, AFAIR.

FWIW as a possible reference, sweeprolog.el has a (very) similar feature
in sweeprolog-mode for adding documentation comments.  From the manual[0]:

Key: C-c C-d (sweeprolog-document-predicate-at-point)
    Insert PlDoc documentation comment for the predicate at or above point.

There's a user option that determines how this command populates the
initial doc comment, by default it reads some information in the
minibuffer and use it to create a fully structured comment.


Cheers,
Eshel


[0] https://eshelyaron.com/sweep.html#sweeprolog-pldoc or (info 
"(sweep)Documenting Code")