@@ -370,11 +370,11 @@
  * \return The allocated object
  */
 + alloc;
 
 /**
- * \brief Allocates memory for a new instance and calls -[init] on it.
+ * \brief Allocates memory for a new instance and calls \ref init on it.
  * \return An allocated and initialized object
  */
 + new;
 
 /**
@@ -546,13 +546,17 @@
 + (BOOL)resolveInstanceMethod: (SEL)selector;
 
 /**
  * \brief Initializes an already allocated object.
  *
- * Derived classes may override this, but need to do self = [super init] before
- * they do any initialization themselves. init may never return nil, instead
- * an exception (for example OFInitializationFailed) should be thrown.
+ * Derived classes may override this, but need to do
+ * \code
+ *   self = [super init]
+ * \endcode
+ * before they do any initialization themselves. \ref init may never return nil,
+ * instead an exception (for example OFInitializationFailedException) should be
+ * thrown.
  *
  * \return An initialized object
  */
 - init;