--- a/src/core/model/attribute.h	Fri Oct 17 12:50:15 2014 -0700
+++ b/src/core/model/attribute.h	Tue Oct 21 12:21:13 2014 -0700
@@ -39,8 +39,13 @@
  *
  * The \c ns-3 attribute system is the mechanism used in \c ns-3 to
  * organize, document, and modify the *values* used by the various
- * component models.  Attributes also enable the tracing and statistics
- * gathering in the simulator.
+ * component models.
+ *
+ * Attributes also enable the tracing and statistics gathering
+ * in the simulator.
+ *
+ * See \ref attributehelper for macros to ease the declaration
+ * and definition of Attributes.
  */
 
 /**
@@ -214,14 +219,11 @@
   
 };
 
-/**
- * \brief A class for an empty attribute value
- *
- * \ingroup attribute
- */
+/** A class for an empty attribute value. */
 class EmptyAttributeValue : public AttributeValue
 {
 public:
+  /** Default constructor. */
   EmptyAttributeValue ();
 private:
   /**