@@ -34,22 +34,24 @@
 @property (readonly) size_t requestedLength;
 @property (readonly) int errNo;
 #endif
 
 /*!
+ * @brief Creates a new, autoreleased read or write failed exception.
+ *
  * @param class_ The class of the object which caused the exception
  * @param stream The stream which caused the read or write failed exception
  * @param length The requested length of the data that couldn't be read /
  *		 written
- * @return A new open file failed exception
+ * @return A new, autoreleased read or write failed exception
  */
 + (instancetype)exceptionWithClass: (Class)class_
 			    stream: (OFStream*)stream
 		   requestedLength: (size_t)length;
 
 /*!
- * Initializes an already allocated read or write failed exception.
+ * @brief Initializes an already allocated read or write failed exception.
  *
  * @param class_ The class of the object which caused the exception
  * @param stream The stream which caused the read or write failed exception
  * @param length The requested length of the data that couldn't be read /
  *		 written
@@ -58,19 +60,26 @@
 -   initWithClass: (Class)class_
 	   stream: (OFStream*)stream
   requestedLength: (size_t)length;
 
 /*!
+ * @brief Returns the stream which caused the read or write failed exception.
+ *
  * @return The stream which caused the read or write failed exception
  */
 - (OFStream*)stream;
 
 /*!
+ * @brief Returns the requested length of the data that couldn't be read /
+ *	  written.
+ *
  * @return The requested length of the data that couldn't be read / written
  */
 - (size_t)requestedLength;
 
 /*!
+ * @brief Returns the errno from when the exception was created.
+ *
  * @return The errno from when the exception was created
  */
 - (int)errNo;
 @end