@@ -29,11 +29,11 @@
 @protocol OFXMLElementBuilderDelegate <OFObject>
 #else
 @protocol OFXMLElementBuilderDelegate
 #endif
 /**
- * This callback is called when the OFXMLElementBuilder built an element.
+ * \brief This callback is called when the OFXMLElementBuilder built an element.
  *
  * If the OFXMLElementBuilder was used as a delegate for the OFXMLParser since
  * parsing started, this will return the complete document as an OFXMLElement
  * with all children.
  *
@@ -45,12 +45,12 @@
 
 #ifdef OF_HAVE_OPTIONAL_PROTOCOLS
 @optional
 #endif
 /**
- * This callback is called when the OFXMLElementBuilder gets a close tag which
- * does not belong there.
+ * \brief This callback is called when the OFXMLElementBuilder gets a close tag
+ *	  which does not belong there.
  *
  * Most likely, the OFXMLElementBuilder was used to build XML only of a child
  * of the root element and the root element was closed. Often the delegate is
  * set to the OFXMLElementBuilder when a certain element is found, this can be
  * used then to set the delegate back after that certain element has been
@@ -68,12 +68,12 @@
   didNotExpectCloseTag: (OFString*)name
 	    withPrefix: (OFString*)prefix
 	     namespace: (OFString*)ns;
 
 /**
- * This callback is called when the XML parser for the element builder found an
- * unknown entity.
+ * \brief This callback is called when the XML parser for the element builder
+ *	  found an unknown entity.
  *
  * \param entity The name of the entity
  * \return The substitution for the entity
  */
 - (OFString*)elementBuilder: (OFXMLElementBuilder*)builder
@@ -97,24 +97,28 @@
 #ifdef OF_HAVE_PROPERTIES
 @property (retain) id <OFXMLElementBuilderDelegate> delegate;
 #endif
 
 /**
+ * \brief Creates a new element builder.
+ *
  * \return A new, autoreleased OFXMLElementBuilder
  */
 + elementBuilder;
 
 /**
+ * \brief Returns the delegate for the OFXMLElementBuilder.
+ *
  * \return The delegate for the OFXMLElementBuilder
  */
 - (id <OFXMLElementBuilderDelegate>)delegate;
 
 /**
- * Sets the delegate for the OFXMLElementBuilder.
+ * \brief Sets the delegate for the OFXMLElementBuilder.
  *
  * \param delegate The delegate for the OFXMLElementBuilder
  */
 - (void)setDelegate: (id <OFXMLElementBuilderDelegate>)delegate;
 @end
 
 @interface OFObject (OFXMLElementBuilderDelegate) <OFXMLElementBuilderDelegate>
 @end