Changeset 425:4fbe868c1fb4 in lemon-0.x

Timestamp:

04/26/04 19:33:51 (20 years ago)

Author:

Alpar Juttner

Branch:

default

Phase:

public

Convert:

svn:c9d7d8f5-90d6-0310-b91f-818b3a526b0e/lemon/trunk@565

Message:

Some more docs.
Put it into the 'misc' group.

File:

• src/work/marci/time_measure.h (modified) (13 diffs)

src/work/marci/time_measure.h

@@ -2 +2 @@
 #ifndef HUGO_TIME_MEASURE_H
 #define HUGO_TIME_MEASURE_H
+
+///ingroup graphs
+///\file
+///\brief Tools for measuring cpu usage
 
 #include <sys/time.h>
@@ -11 +15 @@
 namespace hugo {
 
-//   double currTime() {
-//     timeval tv;
-//     //timezone tz;
-//     gettimeofday(&tv, 0);
-//     return double(tv.tv_sec)+double(tv.tv_usec)/1000000.0;
-//   }
+  /// \addtogroup misc
+  /// @{
 
-  /// Class to store (cpu)time instances.
+  /// A class to store (cpu)time instances.
 
   /// This class stores five time values.
@@ -28 +28 @@
   ///
   /// TimeStamp's can be added to or substracted from each other and
-  /// they can be push to a stream.
+  /// they can be pushed to a stream.
 
   class TimeStamp
@@ -39 +39 @@
     tms &getTms() {return ts;}
     const tms &getTms() const {return ts;}
-    double getRealTime() const {return real_time;}
-    ///Read the current time values of the process.
+    ///Read the current time values of the process
     void stamp()
     {
@@ -48 +47 @@
     }
   
-    /// Constructor initializing with zero.
+    /// Constructor initializing with zero
     TimeStamp()
     { ts.tms_utime=ts.tms_stime=ts.tms_cutime=ts.tms_cstime=0; real_time=0;}
-    ///Constructor initializing with the current time values of the process.
+    ///Constructor initializing with the current time values of the process
     TimeStamp(void *) { stamp();}
   
+    ///
     TimeStamp &operator+=(const TimeStamp &b)
     {
@@ -63 +63 @@
       return *this;
     }
+    ///
     TimeStamp operator+(const TimeStamp &b) const
     {
@@ -68 +69 @@
       return t+=b;
     }
+    ///
     TimeStamp &operator-=(const TimeStamp &b)
     {
@@ -77 +79 @@
       return *this;
     }
+    ///
     TimeStamp operator-(const TimeStamp &b) const
     {
@@ -92 +95 @@
     friend std::ostream& operator<<(std::ostream& os,const TimeStamp &t);
   
+    ///Gives back the user time of the process
     double getUserTime() const
     {
       return double(ts.tms_utime)/sysconf(_SC_CLK_TCK);
     }
+    ///Gives back the system time of the process
     double getSystemTime() const
     {
       return double(ts.tms_stime)/sysconf(_SC_CLK_TCK);
     }
+    ///Gives back the user time of the process' children
     double getCUserTime() const
     {
       return double(ts.tms_cutime)/sysconf(_SC_CLK_TCK);
     }
+    ///Gives back the user time of the process' children
     double getCSystemTime() const
     {
       return double(ts.tms_cstime)/sysconf(_SC_CLK_TCK);
     }
+    ///Gives back the real time of the process
+    double getRealTime() const {return real_time;}
   };
 
-  ///Class measuring the cpu time and real time usage of the process.
+  ///Class measuring the cpu time and real time usage of the process
   class Timer
   {
@@ -118 +127 @@
   
   public: 
-    ///Constructor. It starts with zero time counters.
+    ///Constructor. It starts with zero time counters
     Timer() {_reset();}
 
-    ///Computes the ellapsed time.
+    ///Computes the ellapsed time
 
     ///This conversion computes the ellapsed time
@@ -133 +142 @@
     }
 
-    ///Resets the time counters.
+    ///Resets the time counters
     TimeStamp reset()
     {
@@ -142 +151 @@
   };
 
-  ///Prints the time counters.
+  ///Prints the time counters
+
+  ///Prints the time counters in the folloing form:
+  ///
+  /// u: XX.XXs s: XX.XXs cu: XX.XXs cs: XX.XXs real: XX.XXs 
+  ///
+  /// where the values are the
+  /// - a user cpu time,
+  /// - a system cpu time,
+  /// - a user cpu time of children,
+  /// - a system cpu time of children and
+  /// - a real time,
+  ///
+  ///respectively
   inline std::ostream& operator<<(std::ostream& os,const TimeStamp &t)
   {
@@ -154 +176 @@
   }
 
+  /// @}  
+
 } //namespace hugo