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

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

[Michael Snyder]

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

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

[Eli Zaretskii]

> Date: Thu, 31 Jan 2002 11:28:44 -0800
> From: Michael Snyder <msnyder@cygnus.com>
> 
> Eli, is this OK?

Yes, thanks.  One comment:

> + Tell @value{GDBN} that readonly sections in your object file
> + really are read-only (ie. that their contents will not change).

"ie." should be "i.e.@:".  (The "@:" part is so TeX doesn't think the
period ends a sentence, and does not typeset extra whitespace after
the period, as it does at the end of a sentence.)

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

[Michael Snyder]

Eli Zaretskii wrote:
> 
> > Date: Thu, 31 Jan 2002 11:28:44 -0800
> > From: Michael Snyder <msnyder@cygnus.com>
> >
> > Eli, is this OK?
> 
> Yes, thanks.  One comment:
> 
> > + Tell @value{GDBN} that readonly sections in your object file
> > + really are read-only (ie. that their contents will not change).
> 
> "ie." should be "i.e.@:".  (The "@:" part is so TeX doesn't think the
> period ends a sentence, and does not typeset extra whitespace after
> the period, as it does at the end of a sentence.)

Thanks for the tip.  Changed and committed.

I spotted another use of "ie." which I will fix 
as a separate check-in.