diff --git a/doc/notes/notes-current.rst b/doc/notes/notes-current.rst
index 45adc8e4aa..f5e7f7ffd5 100644
--- a/doc/notes/notes-current.rst
+++ b/doc/notes/notes-current.rst
@@ -39,6 +39,10 @@ Removed Features
   now needs to be manually set in ``CFLAGS`` and ``-lprofiler`` needs to
   be present in ``LDFLAGS``. [GL !4045]
 
+- The ``glue-cache`` *option* has been marked as deprected. The glue
+  cache *feature* still works and will be permanently *enabled* in a
+  future release. [GL #2146]
+
 Feature Changes
 ~~~~~~~~~~~~~~~