]> Dogcows Code - chaz/openbox/blobdiff - otk/timer.hh
documenting classes!
[chaz/openbox] / otk / timer.hh
index 2deeba58ea831c615b79a0164810ae026cda04f6..0bc38e1be945ed6474e54028fd18c199153f936c 100644 (file)
@@ -102,11 +102,20 @@ struct TimerLessThan {
 typedef _timer_queue<OBTimer*,
                      std::vector<OBTimer*>, TimerLessThan> TimerQueue;
 
+//! Manages a queue of OBTimer objects
+/*!
+  All OBTimer objects add themself to an OBTimerQueueManager. The manager is
+  what fires the timers when their time has elapsed. This is done by having the
+  application call the OBTimerQueueManager::fire class in its main event loop.
+*/
 class OBTimerQueueManager {
 private:
+  //! A priority queue of all timers being managed by this class.
   TimerQueue timerList;
 public:
+  //! Constructs a new OBTimerQueueManager
   OBTimerQueueManager() {}
+  //! Destroys the OBTimerQueueManager
   virtual ~OBTimerQueueManager() {}
 
   //! Will wait for and fire the next timer in the queue.
@@ -114,8 +123,16 @@ public:
     The function will stop waiting if an event is received from the X server.
   */
   virtual void fire();
-  
+
+  //! Adds a new timer to the queue
+  /*!
+    @param timer An OBTimer to add to the queue
+  */
   virtual void addTimer(OBTimer* timer);
+  //! Removes a timer from the queue
+  /*!
+    @param timer An OBTimer already in the queue to remove
+  */
   virtual void removeTimer(OBTimer* timer);
 };
 
This page took 0.023312 seconds and 4 git commands to generate.