diff --git a/doc/notes/notes-current.rst b/doc/notes/notes-current.rst
index 0b4e9eb565..23b0e20c55 100644
--- a/doc/notes/notes-current.rst
+++ b/doc/notes/notes-current.rst
@@ -34,7 +34,9 @@ New Features
 Removed Features
 ~~~~~~~~~~~~~~~~
 
-- None.
+- The ``glue-cache`` *option* has been marked as deprecated. The glue
+  cache *feature* still works and will be permanently *enabled* in a
+  future release. [GL #2146]
 
 
 Feature Changes