From: Dmitry Gutov <dgutov@yandex.ru>
Date: Sun, 3 Jan 2016 00:03:29 +0000 (+0200)
Subject: ; Clarify that xref is still experimental
X-Git-Tag: emacs-25.0.90~285
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=43662a240b682de94299e797452ba56d01a04883;p=emacs.git

; Clarify that xref is still experimental
---

diff --git a/etc/NEWS b/etc/NEWS
index c97edf27bd9..e9b0fb50117 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 fe0af0c3430..26471b0df3f 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".
 ;;