@@ -220,21 +220,28 @@
 - (void)setName: (nullable OFString*)name;
 
 /*!
  * @brief Returns the priority of the thread.
  *
+ * This is a value between -1.0 (meaning lowest priority that still schedules)
+ * and +1.0 (meaning highest priority that still allows getting preemptted)
+ * with normal priority being 0.0 (meaning being the same as the main thread).
+ *
  * @return The priority of the thread
  */
 - (float)priority;
 
 /*!
  * @brief Sets the priority of the thread.
  *
  * @note This has to be set before the thread is started!
  *
- * @param priority The priority for the thread, with 0.0 being the lowest and
- *		   1.0 the highest
+ * @param priority The priority of the thread. This is a value between -1.0
+ *		   (meaning lowest priority that still schedules) and +1.0
+ *		   (meaning highest priority that still allows getting
+ *		   preemptted) with normal priority being 0.0 (meaning being
+ *		   the same as the main thread).
  */
 - (void)setPriority: (float)priority;
 
 /*!
  * @brief Returns the stack size of the thread.