bug#81624: New command: xref-find-by-kind

Dmitry Gutov [15/Aug  8:04pm +03] wrote:
> Following a couple of threads in the recent years regarding the addition
> of extra "kinds" to the xref-find-definitions lookup, I think I've
> coalesced what people said they wanted, in the current proposal.
>
> The new command uses the "find definitions" UI, but is based on the
> generic functions which return sort of arbitrary kinds.
>
> The patch takes up the existing M-' binding which would be very handy,
> but I understand that might take some persuading (or a change).
>
> Included is the Eglot implementation as well, which takes advantage of
> the eglot--recover-workspace-symbol-meta thing to allow the lookups not
> just for the thing at point, but from the workspace with completion
> (however much is offered by the server). Works as best-effort solution.
>
> See the branch 'xref-find-by-kind', feedback welcome!
>
> Previously:
>
>    https://lists.gnu.org/archive/html/emacs-devel/2023-02/msg00913.html
>    https://lists.gnu.org/archive/html/emacs-devel/2023-05/msg00413.html
>    https://lists.gnu.org/archive/html/emacs-devel/2023-11/msg00190.html

It's difficult to think about this in the absence of more detailed user
documentation.  Could you write up the manual entries, perhaps including
some examples of what sort of kinds might be available for a language?

The main entry point user command's docstring should say what is prompts
for.  Presumably you have to be asked for the kind and then the symbol.
Which one comes first?  Are they both minibuffer prompts or do you get
an *xref* buffer at some point?

-- 
Sean Whitton