ChangeLogTag:Fri Dec 15 11:36:08 2000 Carlos O'Ryan <coryan@uci.edu>

1 files changed, 27 insertions, 27 deletions

diff --git a/TAO/tao/Asynch_Invocation.h b/TAO/tao/Asynch_Invocation.h
index 215b92f45cf..c81a99b9ae1 100644
--- a/TAO/tao/Asynch_Invocation.h
+++ b/TAO/tao/Asynch_Invocation.h
@@ -1,20 +1,20 @@
 // This may look like C, but it's really -*- C++ -*-
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    TAO
-//
-// = DESCRIPTION
-//    Encapsulate the logic for remote Asynchronous Invocations.
-//
-// = AUTHOR
-//   Carlos O'Ryan <coryan@cs.wustl.edu>,
-//   Alexander Babu Arulanthu <alex@cs.wustl.edu>
-//   Jeff Parsons <parsons@cs.wustl.edu>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file   Asynch_Invocation.h
+ *
+ *  $Id$
+ *
+ *  Encapsulate the logic for remote Asynchronous Invocations.
+ *
+ *
+ *  @author Carlos O'Ryan <coryan@cs.wustl.edu>
+ *  @author Alexander Babu Arulanthu <alex@cs.wustl.edu>
+ *  @author Jeff Parsons <parsons@cs.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef TAO_ASYNCH_INVOCATION_H
 #define TAO_ASYNCH_INVOCATION_H
@@ -43,35 +43,35 @@ class TAO_Export TAO_GIOP_Asynch_Invocation
   //    TAO_GIOP_DII_Deferred_Invocation.
   //
 public:
+  /// Default constructor. This should never get called, it is here
+  /// only to appease older versions of g++.
   TAO_GIOP_Asynch_Invocation (void);
-  // Default constructor. This should never get called, it is here
-  // only to appease older versions of g++.
 
+  /// Constructor.
   TAO_GIOP_Asynch_Invocation (TAO_Stub *stub,
                               const char *operation,
                               CORBA::ULong opname_len,
                               CORBA::Boolean argument_flag,
                               TAO_ORB_Core *orb_core);
-  // Constructor.
 
+  /// Send request, without blocking until any reply comes back.
   virtual int invoke (CORBA_Environment &TAO_IN_ENV =
                       TAO_default_environment ())
     ACE_THROW_SPEC ((CORBA::SystemException));
-  // Send request, without blocking until any reply comes back.
 
+  /// Establishes a connection to the remote server, initializes
+  /// headers etc.
   void start (CORBA_Environment &TAO_IN_ENV =
               TAO_default_environment ())
     ACE_THROW_SPEC ((CORBA::SystemException));
-  // Establishes a connection to the remote server, initializes
-  // headers etc.
 
 protected:
+  /// Must be overridden.
   virtual int invoke_i (CORBA::Environment &ACE_TRY_ENV)
     ACE_THROW_SPEC ((CORBA::SystemException)) = 0;
-  // Must be overridden.
 
+  /// Reply dispatcher for the current asynchronous invocation.
   TAO_Asynch_Reply_Dispatcher_Base *rd_;
-  // Reply dispatcher for the current asynchronous invocation.
 };
 
 #if (TAO_HAS_AMI_CALLBACK == 1) || (TAO_HAS_AMI_POLLER == 1)
@@ -89,6 +89,7 @@ class TAO_Export TAO_GIOP_Twoway_Asynch_Invocation
   //    the CDR stream and returns.
   //
 public:
+  /// Constructor.
   TAO_GIOP_Twoway_Asynch_Invocation (
       TAO_Stub *stub,
       const char *operation,
@@ -98,13 +99,12 @@ public:
       const TAO_Reply_Handler_Skeleton &reply_handler_skel,
       Messaging::ReplyHandler_ptr reply_handler_ptr
     );
-  // Constructor.
 
 protected:
+  /// Implementation of the invoke() methods, handles the basic
+  /// send/reply code and the system exceptions.
   virtual int invoke_i (CORBA::Environment &ACE_TRY_ENV)
     ACE_THROW_SPEC ((CORBA::SystemException));
-  // Implementation of the invoke() methods, handles the basic
-  // send/reply code and the system exceptions.
 };
 
 #endif /* (TAO_HAS_AMI_CALLBACK == 1) || (TAO_HAS_AMI_POLLER == 1) == 0 */