Thu Mar 24 13:10:02 UTC 2011 Johnny Willemsen <jwillemsen@remedy.nl>

        * tests/ACE_Init_Test.h:
        * tests/ACE_Init_Test_Resource.h:
        * tests/ACE_Init_Test_StdAfx.h:
        * tests/Aio_Platform_Test.cpp:
        * tests/Atomic_Op_Test.cpp:
        * tests/Auto_Event_Test.cpp:
        * tests/Auto_IncDec_Test.cpp:
        * tests/Barrier_Test.cpp:
        * tests/Based_Pointer_Test.cpp:
        * tests/Based_Pointer_Test_Lib.cpp:
        * tests/Basic_Types_Test.cpp:
        * tests/Bound_Ptr_Test.h:
        * tests/Buffer_Stream_Test.cpp:
        * tests/Bug_2434_Regression_Test.cpp:
        * tests/Bug_2653_Regression_Test.cpp:
        * tests/Bug_2659_Regression_Test.cpp:
        * tests/Bug_3539_Regression_Test.cpp:
        * tests/Bug_3729_Regression_Test.cpp:
        * tests/CDR_Array_Test.cpp:
        * tests/CDR_File_Test.cpp:
        * tests/CDR_Test.cpp:
        * tests/Cache_Map_Manager_Test.h:
        * tests/Cache_Map_Manager_Test.cpp:
        * tests/Cached_Accept_Conn_Test.h:
        * tests/Cached_Accept_Conn_Test.cpp:
        * tests/Cached_Allocator_Test.cpp:
        * tests/Cached_Conn_Test.h:
        * tests/Cached_Conn_Test.cpp:
        * tests/Capabilities_Test.cpp:
        * tests/Codecs_Test.cpp:
        * tests/Collection_Test.h:
        * tests/Collection_Test.cpp:
        * tests/Config_Test.h:
        * tests/Config_Test.cpp:
        * tests/Conn_Test.h:
        * tests/Conn_Test.cpp:
        * tests/DLL_Test.cpp:
        * tests/DLL_Test_Impl.h:
        * tests/DLL_Test_Impl.cpp:
        * tests/DLList_Test.cpp:
        * tests/Dirent_Test.cpp:
        * tests/Dynamic_Priority_Test.cpp:
        * tests/Dynamic_Test.cpp:
        * tests/Enum_Interfaces_Test.cpp:
        * tests/FIFO_Test.cpp:
        * tests/FlReactor_Test.cpp:
        * tests/Framework_Component_DLL.h:
        * tests/Framework_Component_DLL.cpp:
        * tests/Framework_Component_Test.h:
        * tests/Future_Set_Test.cpp:
        * tests/Future_Test.cpp:
        * tests/Handle_Set_Test.cpp:
        * tests/Hash_Map_Bucket_Iterator_Test.cpp:
        * tests/Hash_Map_Manager_Test.cpp:
        * tests/Hash_Multi_Map_Manager_Test.cpp:
        * tests/High_Res_Timer_Test.cpp:
        * tests/INET_Addr_Test.cpp:
        * tests/IOStream_Test.cpp:
        * tests/Intrusive_Auto_Ptr_Test.cpp:
        * tests/Lazy_Map_Manager_Test.cpp:
        * tests/Log_Msg_Backend_Test.cpp:
        * tests/Log_Msg_Test.cpp:
        * tests/Logging_Strategy_Test.cpp:
        * tests/MEM_Stream_Test.h:
        * tests/MEM_Stream_Test.cpp:
        * tests/MM_Shared_Memory_Test.cpp:
        * tests/MT_NonBlocking_Connect_Test.cpp:
        * tests/MT_Reactor_Timer_Test.h:
        * tests/MT_Reactor_Timer_Test.cpp:
        * tests/MT_Reactor_Upcall_Test.cpp:
        * tests/MT_Reference_Counted_Event_Handler_Test.cpp:
        * tests/MT_Reference_Counted_Notify_Test.cpp:
        * tests/MT_SOCK_Test.cpp:
        * tests/Main.cpp:
        * tests/Malloc_Test.h:
        * tests/Malloc_Test.cpp:
        * tests/Manual_Event_Test.cpp:
        * tests/Map_Manager_Test.cpp:
        * tests/Map_Test.h:
        * tests/Map_Test.cpp:
        * tests/Max_Default_Port_Test.h:
        * tests/Max_Default_Port_Test.cpp:
        * tests/Mem_Map_Test.cpp:
        * tests/Message_Block_Test.cpp:
        * tests/Message_Queue_Notifications_Test.cpp:
        * tests/Message_Queue_Test.cpp:
        * tests/Message_Queue_Test_Ex.cpp:
        * tests/Missing_Svc_Conf_Test.cpp:
        * tests/Multihomed_INET_Addr_Test.cpp:
        * tests/Multihomed_INET_Addr_Test_IPV6.cpp:
        * tests/NDDS_Timer_Test.cpp:
        * tests/Naming_Test.cpp:
        * tests/Network_Adapters_Test.h:
        * tests/Network_Adapters_Test.cpp:
        * tests/New_Fail_Test.cpp:
        * tests/NonBlocking_Conn_Test.h:
        * tests/NonBlocking_Conn_Test.cpp:
        * tests/Notify_Performance_Test.cpp:
        * tests/Object_Manager_Flipping_Test.cpp:
        * tests/Object_Manager_Test.cpp:
        * tests/Obstack_Test.cpp:
        * tests/OrdMultiSet_Test.cpp:
        * tests/Pipe_Test.cpp:
        * tests/Priority_Buffer_Test.cpp:
        * tests/Priority_Reactor_Test.h:
        * tests/Priority_Reactor_Test.cpp:
        * tests/Priority_Task_Test.cpp:
        * tests/Proactor_Test.h:
        * tests/Proactor_Timer_Test.cpp:
        * tests/Process_Env_Test.cpp:
        * tests/Process_Manager_Test.cpp:
        * tests/Process_Manual_Event_Test.cpp:
        * tests/Process_Mutex_Test.cpp:
        * tests/Process_Semaphore_Test.cpp:
        * tests/Process_Strategy_Test.h:
        * tests/Process_Strategy_Test.cpp:
        * tests/Process_Test.cpp:
        * tests/QtReactor_Test.cpp:
        * tests/RB_Tree_Test.h:
        * tests/RB_Tree_Test.cpp:
        * tests/RW_Process_Mutex_Test.cpp:
        * tests/Reactor_Dispatch_Order_Test.cpp:
        * tests/Reactor_Dispatch_Order_Test_Dev_Poll.cpp:
        * tests/Reactor_Exceptions_Test.cpp:
        * tests/Reactor_Fairness_Test.h:
        * tests/Reactor_Fairness_Test.cpp:
        * tests/Reactor_Notify_Test.cpp:
        * tests/Reactor_Performance_Test.h:
        * tests/Reactor_Performance_Test.cpp:
        * tests/Reactor_Registration_Test.cpp:
        * tests/Reactor_Timer_Test.cpp:
        * tests/Reactors_Test.cpp:
        * tests/Reader_Writer_Test.cpp:
        * tests/Recursive_Condition_Bug_Test.cpp:
        * tests/Recursive_Condition_Test.cpp:
        * tests/Recursive_Mutex_Test.cpp:
        * tests/Refcounted_Auto_Ptr_Test.h:
        * tests/Refcounted_Event_Handler_Test_DevPoll.cpp:
        * tests/Reference_Counted_Event_Handler_Test.cpp:
        * tests/Reverse_Lock_Test.cpp:
        * tests/SOCK_Connector_Test.cpp:
        * tests/SOCK_Dgram_Bcast_Test.cpp:
        * tests/SOCK_Dgram_Test.cpp:
        * tests/SOCK_Netlink_Test.cpp:
        * tests/SOCK_SEQPACK_SCTP_Test.cpp:
        * tests/SOCK_Send_Recv_Test.cpp:
        * tests/SOCK_Test.cpp:
        * tests/SPIPE_Test.cpp:
        * tests/SSL/Main.cpp:
        * tests/SSL/SSL_Asynch_Stream_Test.cpp:
        * tests/SSL/Thread_Pool_Reactor_SSL_Test.h:
        * tests/SSL/Thread_Pool_Reactor_SSL_Test.cpp:
        * tests/SString_Test.cpp:
        * tests/SV_Shared_Memory_Test.cpp:
        * tests/Semaphore_Test.cpp:
        * tests/Sig_Handlers_Test.cpp:
        * tests/Signal_Test.cpp:
        * tests/Sigset_Ops_Test.cpp:
        * tests/Simple_Message_Block_Test.cpp:
        * tests/Singleton_Test.cpp:
        * tests/Svc_Handler_Test.cpp:
        * tests/TP_Reactor_Test.h:
        * tests/TP_Reactor_Test.cpp:
        * tests/TSS_Static_Test.cpp:
        * tests/TSS_Test.cpp:
        * tests/TSS_Test_Errno.h:
        * tests/Task_Ex_Test.cpp:
        * tests/Task_Test.cpp:
        * tests/Thread_Attrs_Test.cpp:
        * tests/Thread_Creation_Threshold_Test.cpp:
        * tests/Thread_Manager_Test.cpp:
        * tests/Thread_Mutex_Test.cpp:
        * tests/Thread_Pool_Reactor_Resume_Test.h:
        * tests/Thread_Pool_Reactor_Resume_Test.cpp:
        * tests/Thread_Pool_Reactor_Test.h:
        * tests/Thread_Pool_Reactor_Test.cpp:
        * tests/Thread_Pool_Test.cpp:
        * tests/Time_Service_Test.cpp:
        * tests/Time_Value_Test.cpp:
        * tests/Timeprobe_Test.cpp:
        * tests/Timer_Cancellation_Test.cpp:
        * tests/Timer_Queue_Reference_Counting_Test.cpp:
        * tests/Timer_Queue_Test.cpp:
        * tests/TkReactor_Test.cpp:
        * tests/Tokens_Test.cpp:
        * tests/UPIPE_SAP_Test.cpp:
        * tests/UUID_Test.cpp:
        * tests/Unbounded_Set_Test.cpp:
        * tests/Unload_libACE.cpp:
        * tests/Upgradable_RW_Test.h:
        * tests/Upgradable_RW_Test.cpp:
        * tests/Vector_Test.cpp:
        * tests/WFMO_Reactor_Test.cpp:
        * tests/XtAthenaReactor_Test.cpp:
        * tests/XtMotifReactor_Test.cpp:
          Converted to doxygen style of documentation

1 files changed, 46 insertions, 37 deletions

diff --git a/ACE/tests/Upgradable_RW_Test.h b/ACE/tests/Upgradable_RW_Test.h
index 41c6c0dba1e..d9f79c313bf 100644
--- a/ACE/tests/Upgradable_RW_Test.h
+++ b/ACE/tests/Upgradable_RW_Test.h
@@ -1,22 +1,19 @@
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    tests
-//
-// = FILENAME
-//    Upgradable_RW_Test.h
-//
-// = DESCRIPTION
-//    This class gets its own header file to work around AIX C++
-//    compiler "features" related to template instantiation...  It is
-//    only used by Upgradable_RW_Test.cpp.
-//
-// = AUTHOR
-//    Michael Kircher <mk1@cs.wustl.edu>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    Upgradable_RW_Test.h
+ *
+ *  $Id$
+ *
+ *  This class gets its own header file to work around AIX C++
+ *  compiler "features" related to template instantiation...  It is
+ *  only used by Upgradable_RW_Test.cpp.
+ *
+ *
+ *  @author Michael Kircher <mk1@cs.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef ACE_TESTS_UPGRADABLE_RW_TEST_H
 #define ACE_TESTS_UPGRADABLE_RW_TEST_H
@@ -37,10 +34,13 @@
 
 class Element;
 
+  /**
+   * @class Element
+   *
+   * @brief The members for the double linked list.
+   */
 class Element
 {
-  // = TITLE
-  //   The members for the double linked list.
   friend class ACE_Double_Linked_List<Element>;
   friend class ACE_Double_Linked_List_Iterator_Base<Element>;
   friend class ACE_Double_Linked_List_Iterator<Element>;
@@ -69,10 +69,13 @@ private:
 
 typedef ACE_Double_Linked_List<Element> Linked_List;
 
+/**
+ * @class Time_Calculation
+ *
+ * @brief class to do time calculations thread safe
+ */
 class Time_Calculation
 {
-  //  = TITLE
-  //     class to do time calculations thread safe
 public:
   Time_Calculation (void)
     : reported_times_ (0)
@@ -82,26 +85,29 @@ public:
     times_.system_time = 0;
   }
 
+  /// take the time of the thread and add it to
   void report_time (ACE_Profile_Timer::ACE_Elapsed_Time &elapsed_time);
-  // take the time of the thread and add it to
 
   void print_stats (void);
 
 private:
+  /// add the times incrementally
   ACE_Profile_Timer::ACE_Elapsed_Time times_;
-  // add the times incrementally
 
+  /// protect the time
   ACE_SYNCH_MUTEX mutex_;
-  // protect the time
 
+  /// count how many threads gave me the elapsed_time
   unsigned int reported_times_;
-  // count how many threads gave me the elapsed_time
 };
 
+/**
+ * @class Reader_Task
+ *
+ * @brief A Task for readers
+ */
 class Reader_Task : public ACE_Task_Base
 {
-  //  = TITLE
-  //     A Task for readers
 public:
   Reader_Task (Time_Calculation &time_Calculation,
                ACE_Barrier &barrier)
@@ -113,18 +119,21 @@ public:
   virtual int svc (void);
 
 private:
+  /// keep a reference to the time calculation class
   Time_Calculation &time_Calculation_;
-  // keep a reference to the time calculation class
 
+  /// keep this reference for the barrier, in order
+  /// to allow a "nice" start
   ACE_Barrier &barrier_;
-  // keep this reference for the barrier, in order
-  // to allow a "nice" start
 };
 
+/**
+ * @class Writer_Task
+ *
+ * @brief A Task for wirters.
+ */
 class Writer_Task : public ACE_Task_Base
 {
-  //  = TITLE
-  //     A Task for wirters.
 public:
   Writer_Task (Time_Calculation &time_Calculation,
                ACE_Barrier &barrier)
@@ -136,12 +145,12 @@ public:
   virtual int svc (void);
 
 private:
+  /// keep a reference to the time calculation class
   Time_Calculation &time_Calculation_;
-  // keep a reference to the time calculation class
 
+  /// keep this reference for the barrier, in order
+  /// to allow a "nice" start
   ACE_Barrier &barrier_;
-  // keep this reference for the barrier, in order
-  // to allow a "nice" start
 };
 
 #endif /* ACE_TESTS_UPGRADABLE_RW_TEST_H */