; Clarify that xref is still experimental

diff --git a/etc/NEWS b/etc/NEWS
index c97edf27bd9006e059bc2689db2fb16ddff1eab3..e9b0fb50117a305905fd2d763fe896b1b3064d52 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -955,6 +955,9 @@ As a result of this, the following commands are now obsolete:
 `find-tag-other-window', `find-tag-other-frame', `find-tag-regexp',
 `tags-apropos', and `tags-loop-continue'.
 
+The framework's API is still experimental and can change in major,
+backward-incompatible ways.
+
 *** New variables
 
 `find-tag-marker-ring-length' is now an obsolete alias for

diff --git a/lisp/progmodes/xref.el b/lisp/progmodes/xref.el
index fe0af0c343079cd94096bc0aa43bb7317adee80d..26471b0df3f9dde47f021912a1b4bc82370fbb53 100644 (file)
--- a/lisp/progmodes/xref.el
+++ b/lisp/progmodes/xref.el
@@ -19,6 +19,11 @@
 
 ;;; Commentary:
 
+;; NOTE: The xref API is still experimental and can change in major,
+;; backward-incompatible ways.  Everyone is encouraged to try it, and
+;; report to us any problems or use cases we hadn't anticiated, by
+;; sending an email to emacs-devel, or `M-x report-emacs-bug'.
+;;
 ;; This file provides a somewhat generic infrastructure for cross
 ;; referencing commands, in particular "find-definition".
 ;;