[PATCH] * etc/NEWS: Document incompatibilities introduced by record types.

[Philipp Stephani <p.stephani2@gmail.com>]

---
 etc/NEWS | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/etc/NEWS b/etc/NEWS
index 64b53d88c8..7cedd28ed9 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1462,6 +1462,20 @@ them through 'format' first.  Even that is discouraged: for ElDoc
 support, you should set 'eldoc-documentation-function' instead of
 calling 'eldoc-message' directly.
 
+** The introduction of record types (see below) brings several
+incompatibilities:
+
+*** The return value of 'type-of' is no longer a reliable indicator
+for the type of an object.  For example, a return value of 'integer'
+now means that the object in question is either an integer or a record
+named 'integer'.  To reliably test the type of an object, use the
+predicate functions such as 'integerp'.  Don't define record types
+whose names clash with primitive type names.
+
+*** The printed representation of a record named 'hash-table' now
+clashes with the printed representation of a hash table.  Don't define
+record types named 'hash-table'.
+
 \f
 * Lisp Changes in Emacs 26.1
 
-- 
2.15.1