* gdb.texinfo (Caching Data of Remote Targets): Add note on

	non-stop mode's affect on remote caching.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 8831e0aa76e06a4f55a12a2da73efb094147fea7..f23b5076055517b462eb5981fc696d692247a8d6 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2009-09-01  Doug Evans  <dje@google.com>
+
+       * gdb.texinfo (Caching Data of Remote Targets): Add note on
+       non-stop mode's affect on remote caching.
+
 2009-08-31  Jacob Potter  <jdpotter@google.com>
            Doug Evans  <dje@google.com>
 

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 0e9fd449bded4aa2685e8cb2cac969df2993c93f..52ead12303d20d3b22d30f48364005ed15467098 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -8427,8 +8427,14 @@ performance, because it reduces the overhead of the remote protocol by
 bundling memory reads and writes into large chunks.  Unfortunately, simply
 caching everything would lead to incorrect results, since @value{GDBN} 
 does not necessarily know anything about volatile values, memory-mapped I/O
-addresses, etc.  Therefore, by default, @value{GDBN} only caches data
-known to be on the stack.  Other regions of memory can be explicitly marked
+addresses, etc.  Furthermore, in non-stop mode (@pxref{Non-Stop Mode})
+memory can be changed @emph{while} a gdb command is executing.
+Therefore, by default, @value{GDBN} only caches data
+known to be on the stack@footnote{In non-stop mode, it is moderately
+rare for a running thread to modify the stack of a stopped thread
+in a way that would interfere with a backtrace, and caching of
+stack reads provides a significant speed up of remote backtraces.}.
+Other regions of memory can be explicitly marked as
 cacheable; see @pxref{Memory Region Attributes}.
 
 @table @code