xref-find-by-kind ceb0173179b: Add a manual entry for xref-find-by-kind (bug#81624)

branch: xref-find-by-kind
commit ceb0173179bae6675c5a297adb6b3bd93e19f6a3
Author: Dmitry Gutov <[email protected]>
Commit: Dmitry Gutov <[email protected]>

    Add a manual entry for xref-find-by-kind (bug#81624)
---
 doc/emacs/maintaining.texi | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 7e893ab4fdf..b6b6f40398b 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -2796,6 +2796,20 @@ new frame for it.  The former is @w{@kbd{C-x 4 .}}
 around the place of a mouse event.  The @code{xref-mouse-mode} minor
 mode binds the command to @kbd{C-mouse-1}.
 
+@kindex M-'
+@findex xref-find-by-kind
+  @kbd{M-'} finds all definitions of a certain kind for the identifier
+at point.  First it prompts to choose the kind using a key character,
+from the available set that is returned by the current backend
+(@pxref{Xref}).  Then it either uses the identifier at point or prompts
+for it if none found or the command was invoked with a prefix argument.
+(If you want it to always prompt, customize
+@code{xref-prompt-for-identifier}.)  The list of supported kinds depends
+on the backend, which are advised to use mnemonic keys and common sense.
+For example, the Emacs Lisp mode has ``variable'', ``function alias''
+and ``face'' among its kinds, whereas Eglot (our built-in LSP Client)
+uses ``declaration'', ``implementation'' and ``type definition''.
+
 @kindex C-M-.
 @findex xref-find-apropos
 @vindex tags-apropos-additional-actions