emacs-27 4d8d25d: * doc/lispref/variables.texi (special-variable-p): Clarify limits

[Stefan Monnier]

branch: emacs-27
commit 4d8d25d6417d3ac64627a44571cf63feb7abe44f
Author: Stefan Monnier <address@hidden>
Commit: Stefan Monnier <address@hidden>

    * doc/lispref/variables.texi (special-variable-p): Clarify limits
---
 doc/lispref/variables.texi | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/lispref/variables.texi b/doc/lispref/variables.texi
index 1e35775..35eb4d5 100644
--- a/doc/lispref/variables.texi
+++ b/doc/lispref/variables.texi
@@ -1229,6 +1229,10 @@ This function returns non-@code{nil} if @var{symbol} is 
a special
 variable (i.e., it has a @code{defvar}, @code{defcustom}, or
 @code{defconst} variable definition).  Otherwise, the return value is
 @code{nil}.
+
+Note that since this is a function, it can only return
+non-@code{nil} for variables which are permanently special, but not
+for those that are only special in the current lexical scope.
 @end defun
 
   The use of a special variable as a formal argument in a function is