@@ -64,18 +64,20 @@
 #define nil (id _Null_unspecified)0
 
 /*!
  * @brief An Objective-C boolean representing true.
  *
- * @deprecated Use the standard C99 bool and true instead!
+ * @note This is a legacy from before C had a boolean type. Prefer the standard
+ *	 C99 true instead!
  */
 #define YES true
 
 /*!
  * @brief An Objective-C boolean representing false.
  *
- * @deprecated Use the standard C99 bool and false instead!
+ * @note This is a legacy from before C had a boolean type. Prefer the standard
+ *	 C99 false instead!
  */
 #define NO false
 
 /*! @file */
 
@@ -125,11 +127,12 @@
 
 #if !defined(__wii__) && !defined(__amigaos__)
 /*!
  * @brief An Objective-C boolean. Either @ref YES or @ref NO.
  *
- * @deprecated Use the standard C99 bool instead!
+ * @note This is a legacy from before C had a boolean type. Prefer the standard
+ *	 C99 bool instead!
  */
 typedef bool BOOL;
 #endif
 
 /*!