summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDmitry Gutov <dgutov@yandex.ru>2016-01-03 02:03:29 +0200
committerDmitry Gutov <dgutov@yandex.ru>2016-01-03 02:04:09 +0200
commit43662a240b682de94299e797452ba56d01a04883 (patch)
tree9b1a4f853daec9340cf086a502e872b9617f6076
parent0a6e6caf65237e034135dd50979fe06feb426d5b (diff)
downloademacs-43662a240b682de94299e797452ba56d01a04883.tar.gz
; Clarify that xref is still experimental
-rw-r--r--etc/NEWS3
-rw-r--r--lisp/progmodes/xref.el5
2 files changed, 8 insertions, 0 deletions
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".
;;