From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 7 Jul 2018 09:01:08 +0000 (+0300)
Subject: Documentation followup for bug#32029
X-Git-Tag: emacs-27.0.90~4714
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=42c0b8f3f27c8700f1f432649f2466aab9127061;p=emacs.git

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 df8c4479000..024fd9728c5 100644
--- 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 c92ee6e6804..375f0400541 100644
--- 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.