.

diff --git a/sched.c b/sched.c
index 3eea90effdd1474a0a07608572be029a7835c182..39777a6742a95d8c92344480b451fe0d237e9f67 100644 (file)
--- a/sched.c
+++ b/sched.c
@@ -220,8 +220,9 @@ void sched_shutdown(struct sched *s)
  * \param info Task information supplied by the caller.
  * \param s The scheduler instance.
  *
- * \return A pointer to a newly allocated task structure. It will be
- * freed by sched_shutdown().
+ * \return A pointer to a newly allocated task. The layout of the task
+ * structure is only known to the scheduler core. The structure can be freed
+ * after \ref schedule() returned ba calling \ref sched_shutdown().
  */
 struct task *task_register(struct task_info *info, struct sched *s)
 {

diff --git a/sched.h b/sched.h
index 60c49cabc601aa11a61b47b803adc36a865569f9..2180941e9a792289bfc90248e3bb07d61a5a9614 100644 (file)
--- a/sched.h
+++ b/sched.h
@@ -18,7 +18,7 @@
  * executables employ the scheduler.
  */
 
-/** \par Describes a scheduler instance. */
+/** Describes a scheduler instance. */
 struct sched {
        /** Initial value (in milliseconds) before any pre_monitor call. */
        int default_timeout;
@@ -40,8 +40,6 @@ struct sched {
        struct list_head task_list;
 };
 
-struct task;
-
 /**
  * Information that must be supplied by callers of \ref task_register().
  *