(Extended Menu Items): Menu item filter functions

can be called at any time.

diff --git a/lispref/keymaps.texi b/lispref/keymaps.texi
index 59e2e19966d689e97b41549e086461393e64da46..e1784dd10a0b8ab1022ec3f1b51a82f0e6ea6928 100644 (file)
--- a/lispref/keymaps.texi
+++ b/lispref/keymaps.texi
@@ -1909,6 +1909,10 @@ This property provides a way to compute the menu item dynamically.
 The property value @var{filter-fn} should be a function of one argument;
 when it is called, its argument will be @var{real-binding}.  The
 function should return the binding to use instead.
+
+Emacs can call this function at any time that it does redisplay or
+operates on menu data structures, so you should write it so it can
+safely be called at any time.
 @end table
 
 @node Menu Separators