ChangeLogTag:Tue Jun 17 22:43:20 2008 Steve Huston <shuston@riverace.com>

1 files changed, 9 insertions, 3 deletions

diff --git a/ACE/ace/Reactor.h b/ACE/ace/Reactor.h
index 405d2718a25..0941f4a3b7e 100644
--- a/ACE/ace/Reactor.h
+++ b/ACE/ace/Reactor.h
@@ -458,9 +458,15 @@ public:
    * Install the new disposition (if given) and return the previous
    * disposition (if desired by the caller).
    *
-   * ACE_Event_Handler::handle_close() will be called with
-   * @c ACE_Event_Handler::SIGNAL_MASK.
-   * ACE_Event_Handler::remove_reference() will also be called.
+   * Note that, unlike removing handler for I/O events,
+   * ACE_Event_Handler::handle_close() will not be called when the
+   * handler is removed. Neither will any reference-counting activity be
+   * involved.
+   *
+   * @note There's an existing enhancement request in Bugzilla,
+   * #2368, to change this behavior so that ACE_Event_Handler::handle_close()
+   * is called when the signal handler is removed. Thus, there's some chance
+   * this behavior will change in a future version of ACE.
    */
   int remove_handler (int signum,
                       ACE_Sig_Action *new_disp,