Some manual updates for the recent change

* doc/emacs/maintaining.texi (Looking Up Identifiers):
Mention that 'M-.' can signal an error.
(Xref): Recommend using 'etags-regen-mode' (bug#43086).

* etc/NEWS: Add updated marks.
This commit is contained in:
Dmitry Gutov 2026-02-07 00:01:56 +02:00
parent 66d307aa08
commit b37711a25f
2 changed files with 11 additions and 6 deletions

View file

@ -2569,12 +2569,13 @@ files, and build a database of these references. A backend can then
access this database whenever it needs to list or look up references. access this database whenever it needs to list or look up references.
The Emacs distribution includes @command{etags}, a command for tagging The Emacs distribution includes @command{etags}, a command for tagging
identifier definitions in programs, which supports many programming identifier definitions in programs, which supports many programming
languages and other major modes, such as HTML, by extracting languages and other major modes, such as HTML, by extracting references
references into @dfn{tags tables}. @xref{Create Tags Table}. Major into @dfn{tags tables}. Major modes for languages supported by
modes for languages supported by @command{etags} can use tags tables @command{etags} can use tags tables as basis for their backend. Enable
as basis for their backend. (One disadvantage of this kind of backend @code{etags-regen-mode} to have tags generated across the current
is that tags tables need to be kept reasonably up to date, by project for supported file types and updated automatically on edit. Or
rebuilding them from time to time.) build the table manually to control the set of files and when it is
updated, see @xref{Create Tags Table}.
@end enumerate @end enumerate
@menu @menu
@ -2648,6 +2649,9 @@ to always prompt, customize @code{xref-prompt-for-identifier} to
usual minibuffer completion commands (@pxref{Completion}), with the usual minibuffer completion commands (@pxref{Completion}), with the
known identifier names being the completion candidates. known identifier names being the completion candidates.
It uses the current Xref backend, and will signal an error when there
is none configured, with some recommendations.
@kindex C-x 4 . @kindex C-x 4 .
@findex xref-find-definitions-other-window @findex xref-find-definitions-other-window
@kindex C-x 5 . @kindex C-x 5 .

View file

@ -3704,6 +3704,7 @@ This should not cause any trouble as long as the actual buffer
modification takes place inside 'with-help-window' or modification takes place inside 'with-help-window' or
'with-output-to-temp-buffer' after the call to 'help-setup-xref'. 'with-output-to-temp-buffer' after the call to 'help-setup-xref'.
---
** Xref commands don't automatically suggest to visit a tags table anymore. ** Xref commands don't automatically suggest to visit a tags table anymore.
When no tags file is loaded, symbol completion just won't provide any When no tags file is loaded, symbol completion just won't provide any
suggestions. So the 'M-?' command now works without a tags table. And suggestions. So the 'M-?' command now works without a tags table. And