diff --git a/gdb/doc/python.texi b/gdb/doc/python.texi
index c3dfc7ae0fa..b65991bbad0 100644
--- a/gdb/doc/python.texi
+++ b/gdb/doc/python.texi
@@ -6052,7 +6052,9 @@ local variables will require a frame, but other symbols will not.
 @end defvar
 
 @defvar Symbol.is_variable
-@code{True} if the symbol is a variable.
+@code{True} if the symbol is a variable, as opposed to something like
+a function or type.  Note that this also returns @code{False} for
+arguments.
 @end defvar
 
 A @code{gdb.Symbol} object has the following methods: