Re: RFA: distinguish between pointers and addresses

[Jim Blandy <jimb at zwingli dot cygnus dot com>]

> > + @section Pointers Are Not Always Addresses
> > + @cindex pointer representation
> > + @cindex address representation
> > + @cindex word-addressed machines
> > + @cindex separate data and code address spaces
> > + @cindex spaces, separate data and code address
> > + @cindex address spaces, separate data and code
> > + @cindex code pointers, word-addressed
> > + @cindex converting between pointers and addresses
> > + @cindex D10V addresses
> 
> Thanks for an extensive indexing!

You're welcome.  I have the feeling, though, that good indexing
requires techniques that I don't know.

> > + For example, the Mitsubishi D10V is a 16-bit processor that uses 32-bit
> > + instructions.@footnote{Some D10V instructions are actually pairs of
> 
> The @footnote should come before the dot which ends the sentence, not
> after it.

Fixed.

> > + To cope with architectures like this --- the D10V is not the only one!
> > + --- GDB tries to distinguish between @code{addresses}, which are byte
> > + numbers, and @code{pointers}, which are the target's representation of
> 
> I think you need to use either @dfn or @emph here, instead of @code.
> The latter is for code identifiers, whereas you want an emphasis as
> far as I understand.

Fixed.  I have no idea why I used @code.

> > + This yields an address
> > + appropriate GDB can use to read target memory, disassemble, etc.
> 
> I think the word ``appropriate'' should be deleted from this
> sentence.

Fixed.

> Other than these minor comments, the docs patches are approved.

Great!  Thanks very much.