*** empty log message ***

1 files changed, 18 insertions, 5 deletions

diff --git a/ace/Reactor.h b/ace/Reactor.h
index ec9cd0a2bac..463c22986a1 100644
--- a/ace/Reactor.h
+++ b/ace/Reactor.h
@@ -90,32 +90,45 @@ public:
   // Run the event loop until the
   // <ACE_Reactor::handle_events/ACE_Reactor::alertable_handle_events>
   // method returns -1 or the <end_event_loop> method is invoked.
+  // Note that this method can only be used by the singleton
+  // <ACE_Reactor::instance>.  Thus, to run another reactor use
+  // <ACE_Reactor::run_reactor_event_loop>.
 
   static int run_event_loop (ACE_Time_Value &tv);
   static int run_alertable_event_loop (ACE_Time_Value &tv);
   // Run the event loop until the <ACE_Reactor::handle_events> or
   // <ACE_Reactor::alertable_handle_events> methods returns -1, the
   // <end_event_loop> method is invoked, or the <ACE_Time_Value>
-  // expires.
+  // expires.  Note that this method can only be used by the singleton
+  // <ACE_Reactor::instance>.  Thus, to run another reactor use
+  // <ACE_Reactor::run_reactor_event_loop>.
 
   static int end_event_loop (void);
   // Instruct the <ACE_Reactor::instance> to terminate its event loop
   // and notifies the <ACE_Reactor::instance> so that it can wake up
-  // and close down gracefully.
+  // and close down gracefully.  Note that this method can only be
+  // used by the singleton <ACE_Reactor::instance>.  Thus, to
+  // terminate another reactor, use
+  // <ACE_Reactor::end_reactor_event_loop>.
 
   static int event_loop_done (void);
   // Report if the <ACE_Reactor::instance>'s event loop is finished.
+  // Note that this method can only be used by the singleton
+  // <ACE_Reactor::instance>.  Thus, to check another reactor use
+  // <ACE_Reactor::reactor_event_loop_done>.
 
   static void reset_event_loop (void);
   // Resets the <ACE_Reactor::end_event_loop_> static so that the
-  // <run_event_loop> method can be restarted.
+  // <run_event_loop> method can be restarted.  Note that this method
+  // can only be used by the singleton <ACE_Reactor::instance>.  Thus,
+  // to reset another reactor use
+  // <ACE_Reactor::reset_reactor_event_loop>.
 
   static int check_reconfiguration (void *);
-  // The singleton reactor is used by the service_configurator.
+  // The singleton reactor is used by the <ACE_Service_Config>.
   // Therefore, we must check for the reconfiguration request and
   // handle it after handling an event.
 
-
   // = Reactor event loop management methods.
 
   // These methods work with an instance of a reactor.