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

diff --git a/man/building.texi b/man/building.texi
index 28ea5ec3dc3bdd8b7f859cd940d5f19f15a275f6..989c5732711ca22b6c42ec89f844e7e4076e5a6a 100644 (file)
--- 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}}