diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index e1f11f9a138..e1814ad21d4 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -1839,6 +1839,8 @@ local keymap, or @code{nil} if it is undefined there.
 
 The argument @var{accept-defaults} controls checking for default bindings,
 as in @code{lookup-key} (above).
+
+Use @code{keymap-local-lookup} instead of this function.
 @end defun
 
 @defun global-key-binding key &optional accept-defaults
@@ -1847,6 +1849,8 @@ current global keymap, or @code{nil} if it is undefined there.
 
 The argument @var{accept-defaults} controls checking for default bindings,
 as in @code{lookup-key} (above).
+
+Use @code{keymap-global-lookup} instead of this function.
 @end defun
 
 @defun event-convert-list list