diff --git a/core/include/thread.h b/core/include/thread.h
index ffdc77dfd0..00e9c34477 100644
--- a/core/include/thread.h
+++ b/core/include/thread.h
@@ -63,10 +63,13 @@
  * Usage
  * -----
  * ~~~~~~~~~~~~~~~~~~~~~~~~ {.c}
+ * #include "thread.h"
+ *
  * char rcv_thread_stack[THREAD_STACKSIZE_MAIN];
  *
  * void *rcv_thread(void *arg)
  * {
+ *     (void) arg;
  *     msg_t m;
  *
  *     while (1) {