diff --git a/include/asterisk/astobj.h b/include/asterisk/astobj.h
index a18d70658f..5959d40d0e 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