@@ -17,11 +17,11 @@
 @class OFXMLParser;
 @class OFArray;
 @class OFMutableArray;
 
 /**
- * A protocol that needs to be implemented by delegates for OFXMLParser.
+ * \brief A protocol that needs to be implemented by delegates for OFXMLParser.
  */
 @protocol OFXMLParserDelegate
 /**
  * This callback is called when the XML parser found the start of a new tag.
  *
@@ -81,12 +81,12 @@
 -    (OFString*)xmlParser: (OFXMLParser*)parser
   foundUnknownEntityNamed: (OFString*)entity;
 @end
 
 /**
- * A protocol that needs to be implemented by delegates for 
- * stringByXMLUnescapingWithHandler:.
+ * \brief A protocol that needs to be implemented by delegates for
+ *	  stringByXMLUnescapingWithHandler:.
  */
 @protocol OFXMLUnescapingDelegate
 /**
  * This callback is called when an unknown entity was found while trying to
  * unescape XML. The callback is supposed to return a substitution for the
@@ -98,12 +98,14 @@
  */
 - (OFString*)foundUnknownEntityNamed: (OFString*)entity;
 @end
 
 /**
- * An event-based XML parser which calls the delegate's callbacks as soon as
- * it finds something, thus suitable for streams as well.
+ * \brief An event-based XML parser.
+ *
+ * OFXMLParser is an event-based XML parser which calls the delegate's callbacks
+ * as soon asit finds something, thus suitable for streams as well.
  */
 @interface OFXMLParser: OFObject <OFXMLUnescapingDelegate>
 {
 	OFObject <OFXMLParserDelegate> *delegate;
 	enum {
@@ -159,12 +161,11 @@
 - parseBuffer: (const char*)buf
      withSize: (size_t)size;
 @end
 
 /**
- * The OFString (OFXMLUnescaping) category provides methods to unescape XML in
- * strings.
+ * \brief A category for unescaping XML in strings.
  */
 @interface OFString (OFXMLUnescaping)
 /**
  * Unescapes XML in the string.
  */