[DOC] Mention what happens when the thread of a thread-specific breakpoint disappears.

We recently made GDB auto-delete thread-specific breakpoints when the
corresponding thread is removed from the thread list, but we hadn't
mentioned it in the manual.

gdb/
2013-10-07  Pedro Alves  <palves@redhat.com>

	PR breakpoints/11568
	* gdb.texinfo (Thread-Specific Breakpoints): Mention what happens
	when the thread is removed from the thread list.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 89254a993946b35ecde9f4993a4e2f820270dc75..5141b3ce0e3b260ebdecb9024a6a95ab568b8f20 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2013-10-07  Pedro Alves  <palves@redhat.com>
+
+       PR breakpoints/11568
+       * gdb.texinfo (Thread-Specific Breakpoints): Mention what happens
+       when the thread is removed from the thread list.
+
 2013-10-06  Sergio Durigan Junior  <sergiodj@redhat.com>
 
        * gdb.texinfo (Convenience Variables): Document $_exitsignal.

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 7ec91d859258a5036cdd58c1378f180905d7bbb2..e196658660b736f8f2989885df63046298af3902 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -5864,6 +5864,24 @@ after the breakpoint condition, like this:
 
 @end table
 
+Thread-specific breakpoints are automatically deleted when
+@value{GDBN} detects the corresponding thread is no longer in the
+thread list.  For example:
+
+@smallexample
+(@value{GDBP}) c
+Thread-specific breakpoint 3 deleted - thread 28 no longer in the thread list.
+@end smallexample
+
+There are several ways for a thread to disappear, such as a regular
+thread exit, but also when you detach from the process with the
+@code{detach} command (@pxref{Attach, ,Debugging an Already-running
+Process}), or if @value{GDBN} loses the remote connection
+(@pxref{Remote Debugging}), etc.  Note that with some targets,
+@value{GDBN} is only able to detect a thread has exited when the user
+explictly asks for the thread list with the @code{info threads}
+command.
+
 @node Interrupted System Calls
 @subsection Interrupted System Calls