diff --git a/src/core/model/ref-count-base.cc b/src/core/model/ref-count-base.cc
index ccde7ba4b..2a33733e8 100644
--- a/src/core/model/ref-count-base.cc
+++ b/src/core/model/ref-count-base.cc
@@ -27,7 +27,8 @@
 /**
  * \file
  * \ingroup ptr
- * (Deprecated) ns3::RefCountBase implementation.
+ * ns3::RefCountBase implementation.
+ * \deprecated See \ref ns3::SimpleRefCount
  */
 
 namespace ns3 {
diff --git a/src/core/model/ref-count-base.h b/src/core/model/ref-count-base.h
index 22d01c9b2..48f6bd661 100644
--- a/src/core/model/ref-count-base.h
+++ b/src/core/model/ref-count-base.h
@@ -28,7 +28,8 @@
 /**
  * \file
  * \ingroup ptr
- * (Deprecated) ns3::RefCountBase declaration.
+ * ns3::RefCountBase declaration.
+ * \deprecated See \ref ns3::SimpleRefCount
  */
 
 namespace ns3 {