* gdbint.texinfo (Target Conditionals): Extend the

	gdbarch_breakpoint_from_pc description.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 74d7fca..350831b 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2008-11-25  Jan Kratochvil  <jan.kratochvil@redhat.com>
+
+       * gdbint.texinfo (Target Conditionals): Extend the
+       gdbarch_breakpoint_from_pc description.
+
 2008-11-22  Vladimir Prus  <vladimir@codesourcery.com>
 
        * gdb.texinfo (M68K Features): Fix typo.

diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 9caff8f..88dd7f9 100644 (file)
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -3430,16 +3430,23 @@ favor of @code{gdbarch_breakpoint_from_pc}.
 @findex gdbarch_breakpoint_from_pc
 @anchor{gdbarch_breakpoint_from_pc} Use the program counter to determine the
 contents and size of a breakpoint instruction.  It returns a pointer to
-a string of bytes that encode a breakpoint instruction, stores the
+a static string of bytes that encode a breakpoint instruction, stores the
 length of the string to @code{*@var{lenptr}}, and adjusts the program
 counter (if necessary) to point to the actual memory location where the
-breakpoint should be inserted.
+breakpoint should be inserted.  May return @code{NULL} to indicate that
+software breakpoints are not supported.
 
 Although it is common to use a trap instruction for a breakpoint, it's
 not required; for instance, the bit pattern could be an invalid
 instruction.  The breakpoint must be no longer than the shortest
 instruction of the architecture.
 
+Provided breakpoint bytes can be also used by @code{bp_loc_is_permanent} to
+detect permanent breakpoints.  @code{gdbarch_breakpoint_from_pc} should return
+an unchanged memory copy if it was called for a location with permanent
+breakpoint as some architectures use breakpoint instructions containing
+arbitrary parameter value.
+
 Replaces all the other @var{BREAKPOINT} macros.
 
 @item int gdbarch_memory_insert_breakpoint (@var{gdbarch}, @var{bp_tgt})