RFA:

[Jim Blandy <jimb@cygnus.com>]

This change makes it clear that ADDR_BITS_REMOVE applies only to code
addresses (as the comment in gdb/defs.h explains).  The original text
doesn't mention this at all, leaving the reader to wonder whether the
88k can address individual bytes.

Index: gdbint.texinfo
===================================================================
RCS file: /cvs/cvsfiles/devo/gdb/doc/gdbint.texinfo,v
retrieving revision 1.127
diff -c -c -b -F'^(' -r1.127 gdbint.texinfo
*** gdbint.texinfo	1999/07/01 09:20:35	1.127
--- gdbint.texinfo	1999/07/14 17:33:31
***************
*** 1163,1175 ****
  i960 Nindy target, and should not be used in any other configuration.
  
  @item ADDR_BITS_REMOVE (addr)
! If a raw machine address includes any bits that are not really part of
! the address, then define this macro to expand into an expression that
! zeros those bits in @var{addr}.  For example, the two low-order bits of
! a Motorola 88K address may be used by some kernels for their own
! purposes, since addresses must always be 4-byte aligned, and so are of
! no use for addressing.  Those bits should be filtered out with an
! expression such as @code{((addr) & ~3)}.
  
  @item BEFORE_MAIN_LOOP_HOOK
  Define this to expand into any code that you want to execute before the
--- 1163,1179 ----
  i960 Nindy target, and should not be used in any other configuration.
  
  @item ADDR_BITS_REMOVE (addr)
! If a raw machine instruction address includes any bits that are not
! really part of the address, then define this macro to expand into an
! expression that zeros those bits in @var{addr}.  This is only used for
! addresses of instructions, and even then not in all contexts.
! 
! For example, the two low-order bits of the PC on the Hewlett-Packard PA
! 2.0 architecture contain the privilege level of the corresponding
! instruction.  Since instructions must always be aligned on four-byte
! boundaries, the processor masks out these bits to generate the actual
! address of the instruction.  ADDR_BITS_REMOVE should filter out these
! bits with an expression such as @code{((addr) & ~3)}.
  
  @item BEFORE_MAIN_LOOP_HOOK
  Define this to expand into any code that you want to execute before the