From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sat, 18 Sep 2021 16:32:22 +0000 (+0200)
Subject: Mention xref-quit-and-pop-marker-stack in the manual
X-Git-Tag: emacs-28.0.90~858
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=32d85f7b89e21986bcfc7b9caa67ed2dc39f886a;p=emacs.git

Mention xref-quit-and-pop-marker-stack in the manual

* doc/emacs/maintaining.texi (Xref Commands): Mention
xref-quit-and-pop-marker-stack in the manual.
---

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index 4ee0f32bd5b..b692c995513 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -2280,6 +2280,11 @@ the match with @var{replacement}.  @xref{Identifier Search}.
 Refresh the contents of the @file{*xref*} buffer
 (@code{xref-revert-buffer}.
 
+@item M-,
+@findex xref-quit-and-pop-marker-stack
+Quit the window showing the @file{*xref*} buffer, and then jump to the
+previous Xref stack location (@code{xref-quit-and-pop-marker-stack}.
+
 @item q
 @findex xref-quit
 Quit the window showing the @file{*xref*} buffer (@code{xref-quit}).
diff --git a/etc/NEWS b/etc/NEWS
index e99b119e4f0..fd2408d7933 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2436,10 +2436,12 @@ have been renamed to have "proper" public names and documented
 ('xref-show-definitions-buffer' and
 'xref-show-definitions-buffer-at-bottom').
 
-*** New command 'xref-quit-and-pop-marker-stack' and a binding for it
-in "*xref*" buffers ('M-,').  This combination is easy to press
-semi-accidentally if the user wants to go back in the middle of
-choosing the exact definition to go to, and this should do TRT.
++++
+*** New command 'xref-quit-and-pop-marker-stack'.
+This command is bound to 'M-,' in "*xref*" buffers.  This combination
+is easy to press semi-accidentally if the user wants to go back in the
+middle of choosing the exact definition to go to, and this should do
+TRT.
 
 ---
 *** New value 'project-relative' for 'xref-file-name-display'.
@@ -2458,6 +2460,7 @@ binding in 'xref--xref-buffer-mode-map'.
 When non-nil, matches for identifiers in the file visited by the
 current buffer will be shown first in the "*xref*" buffer.
 
++++
 *** The etags Xref backend now honors 'tags-apropos-additional-actions'.
 You can customize it to augment the output of 'xref-find-apropos',
 like it affected the output of 'tags-apropos', which is obsolete since
@@ -2710,6 +2713,7 @@ The 'erc-current-nick-highlight-type', 'erc-pal-highlight-type',
 'erc-dangerous-host-highlight-type' variables now support a 'message'
 type for highlighting the entire message but not the sender's nick.
 
+---
 *** erc-status-sidebar.el is now part of ERC.
 The 'erc-status-sidebar' package which provides a HexChat-like
 activity overview sidebar for joined IRC channels is now part of ERC.