? penddoc.patch
Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.185
diff -u -r1.185 gdb.texinfo
--- gdb.texinfo	28 Oct 2003 22:04:47 -0000	1.185
+++ gdb.texinfo	3 Dec 2003 01:23:13 -0000
@@ -2600,16 +2600,23 @@
 Enabled breakpoints are marked with @samp{y}.  @samp{n} marks breakpoints
 that are not enabled.
 @item Address
-Where the breakpoint is in your program, as a memory address.
+Where the breakpoint is in your program, as a memory address.  If the
+breakpoint is pending on a future load of a shared library, the address
+will be listed as <PENDING>.
 @item What
 Where the breakpoint is in the source for your program, as a file and
-line number.
+line number.  For a pending breakpoint, the original string passed to
+the breakpoint command will be listed as it cannot be resolved until
+the appropriate shared library is loaded in the future.
 @end table
 
 @noindent
 If a breakpoint is conditional, @code{info break} shows the condition on
 the line following the affected breakpoint; breakpoint commands, if any,
-are listed after that.
+are listed after that.  A pending breakpoint is allowed to have a condition
+specified for it.  The condition is not parsed for validity until a shared
+library is loaded that allows the pending breakpoint to resolve to a
+valid location.
 
 @noindent
 @code{info break} with a breakpoint
@@ -2631,6 +2638,23 @@
 your program.  There is nothing silly or meaningless about this.  When
 the breakpoints are conditional, this is even useful
 (@pxref{Conditions, ,Break conditions}).
+
+@cindex pending breakpoints
+If a specified breakpoint location cannot be found, you will be prompted
+as to whether you want to make the breakpoint pending on a future shared
+library load.  This is useful for setting breakpoints at the start of your
+@value{GDBN} session for locations that you know will be dynamically loaded
+later by the program being debugged.
+You may specify
+a condition for a pending breakpoint, however, the
+condition will only be parsed for correctness after the breakpoint location
+is resolved by a future shared library load.  A pending breakpoint can be
+enabled or disabled.  A disabled pending breakpoint will not be resolved
+on subsequent shared library loads.  Enabling a disabled pending breakpoint
+will cause @value{GDBN} to attempt to resolve the breakpoint in the event
+that the required shared library has already been loaded.
+Once a shared library load resolves a pending breakpoint location, the
+pending breakpoint is removed and a real breakpoint is created.
 
 @cindex negative breakpoint numbers
 @cindex internal @value{GDBN} breakpoints