; etc/NEWS: Document recent changes in 'etags'.

diff --git a/etc/NEWS b/etc/NEWS
index 4333efba975100790fc213bed447ac10ad61dc59..a220330ebbff1e844216d1deafb9271886d0d2f8 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -989,6 +989,22 @@ is strongly dedicated to its buffer.
 ** Tearoff menus and detachable toolbars for Gtk+ has been removed.
 Those features have been deprecated in Gtk+ for a long time.
 
+** Miscellaneous
+
+*** etags no longer qualifies class members by default.
+By default, `etags' will not qualify class members for C-like
+object-oriented languages with their class names and namespaces, and
+will remove qualifications used explicitly in the code from the tag
+names it puts in TAGS files.  This is so the etags.el back-end for
+`xref-find-definitions' is more accurate and produces less false
+positives.
+
+Use --class-qualify (-Q) if you want the old default behavior of
+qualifying class members in C++, Java, and Objective C.  Note that
+using -Q might make some class members become "unknown" to `M-.'
+(`xref-find-definitions'); if so, you can use `C-u M-.' to specify the
+qualified names by hand.
+
 \f
 * Changes in Emacs 25.1 on Non-Free Operating Systems