1 files changed, 40 insertions, 13 deletions

diff --git a/examples/Timer_Queue/Driver.h b/examples/Timer_Queue/Driver.h
index 2e669a8b12b..b6e9d25a196 100644
--- a/examples/Timer_Queue/Driver.h
+++ b/examples/Timer_Queue/Driver.h
@@ -11,7 +11,8 @@
 //    Driver.h
 //
 // = DESCRIPTION
-//   // @@ Please comment me
+//    This code builds an abstraction to factor out common code for 
+//    the different implementations of the Timer_Queue.
 //
 // = AUTHORS
 //    Sergio Flores-Gaitan <sergio@cs.wustl.edu>
@@ -40,50 +41,76 @@ typedef ACE_Thread_Timer_Queue_Adapter<Timer_Heap>
 
 template <class Receiver>
 class Command 
+// = TITLE
+//    Command
+//
+// = DESCRIPTION
+//    This class declares an interface to execute operations, binding a Receiver 
+//     object with an Action.  The Receiver knows how to  implement the operation. 
+//     A class can invoke operations without knowing anything about it, or how it
+//     was implemented.ue_Test_Driver>.
 {
 public:
   typedef int (Receiver::*Action) (void *);
 
-  Command (Receiver &recvr, Action action) 
-    : receiver_(recvr), 
-      action_(action)
-    {}
+  Command (Receiver &recvr, Action action);
 
-  virtual int execute (void *arg)
-    {
-      return (receiver_.*action_) (arg);
-    }
+  virtual int execute (void *arg);
 
 private:
   Receiver &receiver_;
+  // object where the method resides.
+
   Action action_;
+  // method that is going to be invoked.
 };
 
 template <class TQ, class Receiver>
 class Timer_Queue_Test_Driver
+// = TITLE
+//    Timer_Queue_Test_Driver
+//
+// = DESCRIPTION
+//    This class implements a test driver for timer queues.  
+//    This is the place where the common code to test the 
+//     different implementations of the timer queue resides.
+//    This class has the logic for the parse_commands() method,
+//     the run_test(), read_input() and the get_next_request().
+//    Subclasses can override these methods if there is some 
+//     logic that is specific to that implementation.
 {
 public:
   virtual int parse_commands (const char *buf);
 
   virtual int run_test (void);
   
+  virtual int get_next_request (void);
+
+  virtual ssize_t read_input (char *buf, size_t bufsiz);
+
   // = Template Methods.
     
   virtual int display_menu (void)=0;
   
   virtual int init (void)=0;
   
-  virtual int get_next_request (void);
-
-  virtual ssize_t read_input (char *buf, size_t bufsiz);
-
 protected:
   TQ timer_queue_;
+  // timer queue
+
+  // Set of <Command>s to be executed.
 
   Command<Receiver> *schedule_cmd_;
+  // schedule timer command
+
   Command<Receiver> *cancel_cmd_;
+  // cancel timer command.
+
   Command<Receiver> *list_cmd_;
+  // list timers command.
+
   Command<Receiver> *shutdown_cmd_;
+  // shutdown the driver.
 
 };