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