doxify missing bits

[paraslash.git] / sched.h

diff --git a/sched.h b/sched.h
index 8a6ed1a80fb9fca7493f311bbf9116234c19bdb3..ebd38a8ceb8dbf8cfbe7a6fe6982f8baeaa37845 100644 (file)
--- a/sched.h
+++ b/sched.h
@@ -16,7 +16,7 @@
  *     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  */
 
-/** \file sched.c Paraslash's task and scheduling functions */
+/** \file sched.h sched and task structures and exported symbols from sched.c */
 
 
 /**
@@ -47,13 +47,6 @@ struct sched {
  * before registering a task to the scheduler, the task structure must be
  * filled in properly by the caller.
  *
- * The  pre_select or the post_select pointer, but not both may be NULL.  Once
- * a task is registered, its pre_select and post_select function gets called
- * from the scheduler's mainloop. The purpose of the pre_select loop is to add
- * file descriptors to the fd sets of the scheduler and to decrease the select
- * timeout if neccessary. The post_select function may then evaluate these fd
- * sets and act upon the results.
-
  * If one of these functions return a negative value via \a t->ret the
  * (optional) event_handler gets called (it may also be called in case another
  * event happend). In many cases the only possible event is an error or an eof
@@ -65,11 +58,20 @@ struct sched {
 struct task {
        /** pointer to the struct this task is embedded in */
        void *private_data;
-       /** pre_select hook */
+       /**
+        * the pre select hook of \a t
+        *
+        * Its purpose is to add file descriptors to the fd sets of the
+        * scheduler and to decrease the select timeout if neccessary.
+        */
        void (*pre_select)(struct sched *s, struct task *t);
-       /** post_select hook */
+       /**
+        * the postselect hook of \a t
+        *
+        * evaluate and act upon the results of the previous select call.
+        */
        void (*post_select)(struct sched *s, struct task *t);
-       /** gets called */
+       /** gets called if pre_select or post_select returned an error */
        void (*event_handler)(struct task *t);
        /** pre_select() and post_select store their return value here */
        int ret;
@@ -89,7 +91,7 @@ struct task {
  */
 extern struct timeval *now;
 
-void *register_task(struct task *t);
+void register_task(struct task *t);
 void unregister_task(struct task *t);
 int sched(struct sched *s);
 void init_sched(void);