Added comments.

1 files changed, 10 insertions, 4 deletions

diff --git a/ace/Thread_Manager.h b/ace/Thread_Manager.h
index e203e068d35..2b43724a0bc 100644
--- a/ace/Thread_Manager.h
+++ b/ace/Thread_Manager.h
@@ -498,14 +498,19 @@ public:
   // treated as "absolute" time.  Returns 0 on success and -1 on
   // failure.  If <abandon_detached_threads> is set, wait will first
   // check thru its thread list for threads with THR_DETACHED or
-  // THR_DAEMON flags set and remove these threads.
+  // THR_DAEMON flags set and remove these threads.  Notice that
+  // unlike other wait_* function, by default, wait () does wait on
+  // all thread spawned by this thread_manager no matter the detached
+  // flags are set or not unless it is called with
+  // <abandon_detached_threads> flag set.
 
   int join (ACE_thread_t tid, void **status = 0);
-  // Join a thread specified by <tid>.
+  // Join a thread specified by <tid>.  Do not wait on a detached thread.
 
   int wait_grp (int grp_id);
   // Block until there are no more threads running in a group.
-  // Returns 0 on success and -1 on failure.
+  // Returns 0 on success and -1 on failure.  Notice that wait_grp
+  // will not wait on detached threads.
 
   // = Accessors for ACE_Thread_Descriptors.
   ACE_Thread_Descriptor *thread_desc_self (void);
@@ -595,7 +600,8 @@ public:
   // = Operations on ACE_Tasks.
   int wait_task (ACE_Task_Base *task);
   // Block until there are no more threads running in <task>.  Returns
-  // 0 on success and -1 on failure.
+  // 0 on success and -1 on failure.  Notice that wait_task will not
+  // wait on detached threads.
   int suspend_task (ACE_Task_Base *task);
   // Suspend all threads in an ACE_Task.
   int resume_task (ACE_Task_Base *task);