diff --git a/src/core/model/deprecated.h b/src/core/model/deprecated.h
index c93b604a7..fc57b888a 100644
--- a/src/core/model/deprecated.h
+++ b/src/core/model/deprecated.h
@@ -81,7 +81,7 @@
  * \param msg Optional message to add to the compiler warning.
  *
  */
-#define NS_DEPRECATED(msg) [[deprecated(msg)]]
+#define NS_DEPRECATED(msg) /** \deprecated msg */ [[deprecated(msg)]]
 
 /**
  * \ingroup deprecation