Don't stress 'remote' in "Data Caching" in doc

When I try to describe the cache and its related commands (in a
cache-per-address-space world), I find hard to add, because
existing doc is focused on remote debugging, while data cache is used
regardless of the target.  More precisely, GDB cache target data,
instead of remote data.

gdb/doc:

2013-11-20  Yao Qi  <yao@codesourcery.com>

	* gdb.texinfo (Data): Rename menu item.
	(Caching Remote Data): Rename to ...
	(Caching Target Data): ... it.  Update.
This commit is contained in:
Yao Qi 2013-10-31 20:49:49 +08:00
parent 68c765e263
commit b12039c637
2 changed files with 21 additions and 14 deletions

View File

@ -1,3 +1,9 @@
2013-11-20 Yao Qi <yao@codesourcery.com>
* gdb.texinfo (Data): Rename menu item.
(Caching Remote Data): Rename to ...
(Caching Target Data): ... it. Update.
2013-11-18 Joel Brobecker <brobecker@adacore.com> 2013-11-18 Joel Brobecker <brobecker@adacore.com>
* gdb.texinfo (GDB/MI Miscellaneous Commands): Document the new * gdb.texinfo (GDB/MI Miscellaneous Commands): Document the new

View File

@ -8066,7 +8066,7 @@ being passed the type of @var{arg} as the argument.
* Core File Generation:: Cause a program dump its core * Core File Generation:: Cause a program dump its core
* Character Sets:: Debugging programs that use a different * Character Sets:: Debugging programs that use a different
character set than GDB does character set than GDB does
* Caching Remote Data:: Data caching for remote targets * Caching Target Data:: Data caching for targets
* Searching Memory:: Searching memory for a sequence of bytes * Searching Memory:: Searching memory for a sequence of bytes
@end menu @end menu
@ -10823,18 +10823,19 @@ $10 = 78 '+'
The @sc{ibm1047} character set uses the number 78 to encode the @samp{+} The @sc{ibm1047} character set uses the number 78 to encode the @samp{+}
character. character.
@node Caching Remote Data @node Caching Target Data
@section Caching Data of Remote Targets @section Caching Data of Targets
@cindex caching data of remote targets @cindex caching data of targets
@value{GDBN} caches data exchanged between the debugger and a @value{GDBN} caches data exchanged between the debugger and a target.
remote target (@pxref{Remote Debugging}). Such caching generally improves Such caching generally improves performance in remote debugging
performance, because it reduces the overhead of the remote protocol by (@pxref{Remote Debugging}), because it reduces the overhead of the
bundling memory reads and writes into large chunks. Unfortunately, simply remote protocol by bundling memory reads and writes into large chunks.
caching everything would lead to incorrect results, since @value{GDBN} Unfortunately, simply caching everything would lead to incorrect results,
does not necessarily know anything about volatile values, memory-mapped I/O since @value{GDBN} does not necessarily know anything about volatile
addresses, etc. Furthermore, in non-stop mode (@pxref{Non-Stop Mode}) values, memory-mapped I/O addresses, etc. Furthermore, in non-stop mode
memory can be changed @emph{while} a gdb command is executing. (@pxref{Non-Stop Mode}) memory can be changed @emph{while} a gdb command
is executing.
Therefore, by default, @value{GDBN} only caches data Therefore, by default, @value{GDBN} only caches data
known to be on the stack@footnote{In non-stop mode, it is moderately 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 rare for a running thread to modify the stack of a stopped thread
@ -10888,11 +10889,11 @@ Must be a power of 2.
@item show dcache size @item show dcache size
@kindex show dcache size @kindex show dcache size
Show maximum number of dcache entries. See also @ref{Caching Remote Data, info dcache}. Show maximum number of dcache entries. @xref{Caching Target Data, info dcache}.
@item show dcache line-size @item show dcache line-size
@kindex show dcache line-size @kindex show dcache line-size
Show default size of dcache lines. See also @ref{Caching Remote Data, info dcache}. Show default size of dcache lines.
@end table @end table