@@ -28,27 +28,31 @@
 #ifdef OF_HAVE_PROPERTIES
 @property (readonly, retain, nonatomic) id <OFLocking> lock;
 #endif
 
 /**
+ * \brief Creates a new, autoreleased lock failed exception.
+ *
  * \param class_ The class of the object which caused the exception
  * \param lock The lock which could not be locked
- * \return A new lock failed exception
+ * \return A new, autoreleased lock failed exception
  */
 + (instancetype)exceptionWithClass: (Class)class_
 			      lock: (id <OFLocking>)lock;
 
 /**
- * Initializes an already allocated lock failed exception.
+ * \brief Initializes an already allocated lock failed exception.
  *
  * \param class_ The class of the object which caused the exception
  * \param lock The lock which could not be locked
  * \return An initialized lock failed exception
  */
 - initWithClass: (Class)class_
 	   lock: (id <OFLocking>)lock;
 
 /**
- * \param The lock which could not be locked
+ * \brief Returns the lock which could not be locked.
+ *
+ * \return The lock which could not be locked
  */
 - (id <OFLocking>)lock;
 @end