diff --git a/include/asterisk/astobj.h b/include/asterisk/astobj.h
index a18d70658f9cbe4262f4c7a7c7ae826b9e748883..5959d40d0e948a5121824fe71daf95083ff30e9c 100644
--- a/include/asterisk/astobj.h
+++ b/include/asterisk/astobj.h
@@ -16,8 +16,10 @@
  * at the top of the source tree.
  */
 
-/*
- * Object Model for Asterisk
+/*! \file
+ * \brief Object Model for Asterisk
+ *
+ * \deprecated Use astobj2.h instead
  */
 
 #ifndef _ASTERISK_ASTOBJ_H