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