* thread-db.c (get_thread_signals): Doc fix.

diff --git a/rda/unix/ChangeLog b/rda/unix/ChangeLog
index 08a2bd0..4505e02 100644 (file)
--- a/rda/unix/ChangeLog
+++ b/rda/unix/ChangeLog
@@ -1,5 +1,7 @@
 2004-10-19  Jim Blandy  <jimb@redhat.com>
 
+       * thread-db.c (get_thread_signals): Doc fix.
+
        * thread-db.c (enum symbol_cache_defined): Move this definition
        above that of (struct symbol_cache), and give it a name.
        (struct symbol_cache): Use that enum as the type of 'defined_p', so

diff --git a/rda/unix/thread-db.c b/rda/unix/thread-db.c
index 22bbced..d9000fe 100644 (file)
--- a/rda/unix/thread-db.c
+++ b/rda/unix/thread-db.c
@@ -1205,9 +1205,19 @@ set_target_int_by_name (char *name, void *value, int size)
 }
 
 /* Function: get_thread_signals
-   Obtain the values of the "cancel", "restart" and "debug" signals 
-   used by linux threads, and store them in a set of global variables
-   for use by check_child_state and friends. */
+
+   Obtain the values of the "cancel", "restart" and "debug" signals
+   used by LinuxThreads, and store them in a set of global variables
+   for use by check_child_state and friends.
+
+   Recent versions of NPTL don't define these symbols at all; you must
+   use the libthread_db event functions instead (td_ta_event_addr,
+   ...) to find out about thread creation, thread exits, and so on.
+
+   Older versions of LinuxThreads provide both interfaces.  To avoid
+   changing RDA's behavior on any system it supports, we use the older
+   signal-based interface if present, and use the event-based
+   interface as a fall-back.  */
 
 static int cancel_signal;
 static int restart_signal;