@@ -29,25 +29,31 @@
 #ifdef OF_HAVE_PROPERTIES
 @property (readonly, retain, nonatomic) OFXMLParser *parser;
 #endif
 
 /*!
+ * @brief Creates a new, autoreleased malformed XML exception.
+ *
+ * @param class_ The class of the object which caused the exception
  * @param parser The parser which encountered malformed XML
- * @return A new malformed XML exception
+ * @return A new, autoreleased malformed XML exception
  */
 + (instancetype)exceptionWithClass: (Class)class_
 			    parser: (OFXMLParser*)parser;
 
 /*!
- * Initializes an already allocated malformed XML exception.
+ * @brief Initializes an already allocated malformed XML exception.
  *
+ * @param class_ The class of the object which caused the exception
  * @param parser The parser which encountered malformed XML
  * @return An initialized malformed XML exception
  */
 - initWithClass: (Class)class_
 	 parser: (OFXMLParser*)parser;
 
 /*!
+ * @brief Returns the parser which encountered malformed XML.
+ *
  * @return The parser which encountered malformed XML
  */
 - (OFXMLParser*)parser;
 @end