(Watch Expressions): Describe gdb-delete-out-of-scope.

1 files changed, 9 insertions, 0 deletions

diff --git a/man/building.texi b/man/building.texi
index 28ea5ec3dc3..989c5732711 100644
--- a/man/building.texi
+++ b/man/building.texi
@@ -1117,6 +1117,15 @@ changed and @code{shadow} face to make variables which have gone out of
 scope less noticeable.  When a variable goes out of scope you can't
 edit its value.
 
+@vindex gdb-delete-out-of-scope
+  If the variable @code{gdb-delete-out-of-scope} is
+non-@code{nil} (the default value), Emacs automatically deletes watch
+expressions which go out of scope.  This is safest because GDB may
+think that a variable in a new frame is an old one that previously
+went of of scope.  Sometimes, when re-entering the same function,
+it may be useful to set this value to nil so that you don't need to
+recreate the watch expression.
+
 @vindex gdb-use-colon-colon-notation
   If the variable @code{gdb-use-colon-colon-notation} is
 non-@code{nil}, Emacs uses the @samp{@var{function}::@var{variable}}