2001-09-04 Elena Zannoni <ezannoni@redhat.com>

        * gdbint.texinfo (Target Architecture Definition): Add
        explanation of TARGET_PRINT_INSN macro.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 31bc64e..40a9416 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2001-09-04  Elena Zannoni  <ezannoni@redhat.com>
+
+       * gdbint.texinfo (Target Architecture Definition): Add
+       explanation of TARGET_PRINT_INSN macro.
+
 2001-08-30  Jim Blandy  <jimb@redhat.com>
 
        * gdb.texinfo (`add-symbol-file'): Correct synopsis.
@@ -13,7 +18,7 @@ Wed Aug 15 10:47:28 2001  Christopher Faylor <cgf@cygnus.com>
        * gdbint.texinfo: Add a cautionary note about macro use.
 
 2001-08-02  Corinna Vinschen  <vinschen@redhat.com>
-
+ 
        * gdb.texinfo: Explain omitting the hostname in the
        `target remote' command.
 

diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 914ebf4..2088abe 100644 (file)
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -3566,6 +3566,18 @@ If non-zero, the target has support for hardware-assisted
 watchpoints.  @xref{Algorithms, watchpoints}, for more details and
 other related macros.
 
+@item TARGET_PRINT_INSN (@var{addr}, @var{info})
+@findex TARGET_PRINT_INSN
+This is the function used by @value{GDBN} to print an assembly
+instruction.  It prints the instruction at address @var{addr} in
+debugged memory and returns the length of the instruction, in bytes.  If
+a target doesn't define its own printing routine, it defaults to an
+accessor function for the global pointer @code{tm_print_insn}. This
+usually points to a function in the @code{opcodes} library (@pxref{Support
+Libraries, ,Opcodes}).  @var{info} is a structure (of type
+@code{disassemble_info}) defined in @file{include/dis-asm.h} used to
+pass information to the instruction decoding routine.
+
 @item USE_STRUCT_CONVENTION (@var{gcc_p}, @var{type})
 @findex USE_STRUCT_CONVENTION
 If defined, this must be an expression that is nonzero if a value of the