[RFA] Documentation -- 'set trust-readonly-sections'

[Michael Snyder <msnyder@cygnus.com>]

Eli, is this OK?

2002-01-30  Michael Snyder  <msnyder@redhat.com>

	* gdb.texinfo (set trust-readonly-sections): Document.

Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.82
diff -p -r1.82 gdb.texinfo
*** gdb.texinfo	2002/01/27 09:34:24	1.82
--- gdb.texinfo	2002/01/31 04:11:31
*************** COFF shared library information.
*** 9410,9415 ****
--- 9410,9430 ----
  Section contains common symbols.
  @end table
  @end table
+ @kindex set trust-readonly-sections
+ @item set trust-readonly-sections on
+ Tell @value{GDBN} that readonly sections in your object file
+ really are read-only (ie. that their contents will not change).
+ In that case, @value{GDBN} can fetch values from these sections
+ out of the object file, rather than from the target program.
+ For some targets (notably embedded ones), this can be a significant
+ enhancement to debugging performance.
+ 
+ The default is off.
+ 
+ @item set trust-readonly-sections off
+ Tell @value{gdbn} not to trust readonly sections.  This means that
+ the contents of the section might change while the program is running,
+ and must therefore be fetched from the target when needed.
  @end table
  
  All file-specifying commands allow both absolute and relative file names