From: g0dil <g0dil@270642c3-0616-0410-b53a-bc976706d245>
Date: Sat, 9 Feb 2008 00:01:04 +0000 (+0000)
Subject: Scheduler: Added EventId documentation
X-Git-Url: http://g0dil.de/git?p=senf.git;a=commitdiff_plain;h=016f5a1e74a59a71dd2b3f5513c1e041ebf54213

Scheduler: Added EventId documentation

git-svn-id: https://svn.berlios.de/svnroot/repos/senf/trunk@677 270642c3-0616-0410-b53a-bc976706d245
---

diff --git a/Scheduler/Scheduler.hh b/Scheduler/Scheduler.hh
index 5f0f635..34e625c 100644
--- a/Scheduler/Scheduler.hh
+++ b/Scheduler/Scheduler.hh
@@ -167,11 +167,23 @@ namespace senf {
         ///////////////////////////////////////////////////////////////////////////
         // Types
 
-        /** \brief Types of file descriptor events */
-        enum EventId { EV_NONE=0,
-                       EV_READ=1, EV_PRIO=2, EV_WRITE=4, 
-                       EV_ALL=7,
-                       EV_HUP=8, EV_ERR=16 };
+        /** \brief Types of file descriptor events 
+
+            These events are grouped into to classes:
+            \li Ordinary file descriptor events for which handlers may be registered. These are
+                EV_READ, EV_PRIO and EV_WRITE. EV_ALL is a combination of these three.
+            \li Error flags. These additional flags may be passed to a handler to pass an error
+                condition to the handler. 
+         */
+        enum EventId { 
+            EV_NONE  =  0   /**< No event */
+          , EV_READ  =  1   /**< File descriptor is readable */
+          , EV_PRIO  =  2   /**< File descriptor has OOB data */
+          , EV_WRITE =  4   /**< File descriptor is writable */
+          , EV_ALL   =  7   /**< Used to register all events at once (read/prio/write) */
+          , EV_HUP   =  8   /**< Hangup condition on file handle */
+          , EV_ERR   = 16   /**< Error condition on file handle */
+        };
 
         /** \brief Template typedef for Callback type
 
diff --git a/doclib/Doxyfile.global b/doclib/Doxyfile.global
index 5ffddee..6e45375 100644
--- a/doclib/Doxyfile.global
+++ b/doclib/Doxyfile.global
@@ -60,7 +60,10 @@ PREDEFINED             = \
     "SENF_PARSER_LIST_N(name,elt_type,size_type)=senf::Parse_ListN<elt_type,size_type>::parser name() const" \
     "SENF_PARSER_VARIANT(name,chooser,types)=senf::Parse_Variant_Direct<chooser ## _t,?,types>::parser name() const" \
     "SENF_PARSER_PRIVATE_VARIANT(name,chooser,types)=private: senf::Parse_Variant_Direct<chooser ## _t,?,types>::parser name() const; public:" \
-    "SENF_PARSER_VEC_N(name,elt_type,size_type)=senf::Parse_VectorN<elt_type,size_type> name() const"
+    "SENF_PARSER_VEC_N(name,elt_type,size_type)=senf::Parse_VectorN<elt_type,size_type> name() const" \
+    "SENF_LOG_CLASS_AREA()=" \
+    "SENF_LOG_DEFAULT_AREA(area)=" \
+    "SENF_LOG_DEFAULT_STREAM(stream)="
 EXPAND_AS_DEFINED      = prefix_ SENF_LOG_DEF_STREAM SENF_LOG_DEF_AREA SENF_LOG_DEF_AREA_I
 
 HTML_HEADER            = "$(TOPDIR)/doclib/doxy-header.html"