Documentation followup for bug#32029

* etc/NEWS: Mention 'xref-find-definitions-at-mouse'

* doc/emacs/maintaining.texi (Looking Up Identifiers):
Document 'xref-find-definitions-at-mouse'.

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index df8c447900076d55fd5b15e9f8cb4084992a3b4d..024fd9728c56475881fc3b6d1ecc9f89bf67e835 100644 (file)
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1813,6 +1813,8 @@ Find definitions of identifier, but display it in another window
 @item C-x 5 .@: @key{RET}
 Find definition of identifier, and display it in a new frame
 (@code{xref-find-definitions-other-frame}).
+@item M-x xref-find-definitions-at-mouse
+Find definition of identifier at mouse click.
 @item M-,
 Go back to where you previously invoked @kbd{M-.} and friends
 (@code{xref-pop-marker-stack}).
@@ -1853,6 +1855,11 @@ former is @w{@kbd{C-x 4 .}}
 (@code{xref-find-definitions-other-window}), and the latter is
 @w{@kbd{C-x 5 .}}  (@code{xref-find-definitions-other-frame}).
 
+  The command @code{xref-find-definitions-at-mouse} works like
+@code{xref-find-definitions}, but it looks for the identifier name at
+or around the place of a mouse event.  This command is intended to be
+bound to a mouse event, such as @kbd{C-M-mouse-1}, for example.
+
 @findex xref-find-apropos
 @kindex C-M-.
   The command @kbd{C-M-.} (@code{xref-find-apropos}) finds the

diff --git a/etc/NEWS b/etc/NEWS
index c92ee6e68044e5b6eb644ae882a36ff8cc1bebf8..375f040054196dee162e17ccba4dafc7454cb338 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -265,6 +265,13 @@ them to the 'browse-url' function, like the other protocols: ftp,
 http, and https.  This allows to have references to local HTML files,
 for example.
 
+** Xref
+
++++
+*** New command 'xref-find-definitions-at-mouse'.
+This command finds definitions of the identifier at the place of a
+mouse click event, and is intended to be bound to a mouse event.
+
 ** Ecomplete
 
 *** The ecomplete sorting has changed to a decay-based algorithm.