diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi index aebe31b478e..aafa5395239 100644 --- a/doc/emacs/maintaining.texi +++ b/doc/emacs/maintaining.texi @@ -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. The Emacs distribution includes @command{etags}, a command for tagging identifier definitions in programs, which supports many programming -languages and other major modes, such as HTML, by extracting -references into @dfn{tags tables}. @xref{Create Tags Table}. Major -modes for languages supported by @command{etags} can use tags tables -as basis for their backend. (One disadvantage of this kind of backend -is that tags tables need to be kept reasonably up to date, by -rebuilding them from time to time.) +languages and other major modes, such as HTML, by extracting references +into @dfn{tags tables}. Major modes for languages supported by +@command{etags} can use tags tables as basis for their backend. Enable +@code{etags-regen-mode} to have tags generated across the current +project for supported file types and updated automatically on edit. Or +build the table manually to control the set of files and when it is +updated, see @xref{Create Tags Table}. @end enumerate @menu @@ -2648,6 +2649,9 @@ to always prompt, customize @code{xref-prompt-for-identifier} to usual minibuffer completion commands (@pxref{Completion}), with the 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 . @findex xref-find-definitions-other-window @kindex C-x 5 . diff --git a/etc/NEWS b/etc/NEWS index a7d2a0b8004..093e525fa81 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -3704,6 +3704,7 @@ This should not cause any trouble as long as the actual buffer modification takes place inside 'with-help-window' or 'with-output-to-temp-buffer' after the call to 'help-setup-xref'. +--- ** 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 suggestions. So the 'M-?' command now works without a tags table. And