diff --git a/os/nil/src/ch.c b/os/nil/src/ch.c
index fcabcfdb7..0777c3d10 100644
--- a/os/nil/src/ch.c
+++ b/os/nil/src/ch.c
@@ -55,6 +55,7 @@ nil_system_t nil;
  *
  * @param[in] state     thread state
  * @param[in] p         object pointer
+ * @return              Pointer to the thread.
  */
 static thread_t *nil_find_thread(tstate_t state, void * p) {
   thread_t *tp = nil.threads;
@@ -79,8 +80,7 @@ static thread_t *nil_find_thread(tstate_t state, void * p) {
  * @param[in] cnt       number of threads to be readied as a negative number,
  *                      non negative numbers are ignored
  * @param[in] msg       the wakeup message
- *
- * @iclass
+ * @return              Always zero.
  */
 static cnt_t nil_ready_all(void * p, cnt_t cnt, msg_t msg) {
   thread_t *tp = nil.threads;;