[Emacs-diffs] emacs-25 43662a2: ; Clarify that xref is still experimental

[Dmitry Gutov]

branch: emacs-25
commit 43662a240b682de94299e797452ba56d01a04883
Author: Dmitry Gutov <address@hidden>
Commit: Dmitry Gutov <address@hidden>

    ; Clarify that xref is still experimental
---
 etc/NEWS               |    3 +++
 lisp/progmodes/xref.el |    5 +++++
 2 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/etc/NEWS b/etc/NEWS
index c97edf2..e9b0fb5 100644
--- 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 fe0af0c..26471b0 100644
--- 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".
 ;;