Index: src/OFExceptions.h
==================================================================
--- src/OFExceptions.h
+++ src/OFExceptions.h
@@ -113,12 +113,12 @@
  */
 - (size_t)requestedSize;
 @end
 
 /**
- * \brief An exception indicating that a mutation was detected while
- *        enumerating.
+ * \brief An exception indicating that a mutation was detected during
+ *        enumeration.
  */
 @interface OFEnumerationMutationException: OFException {}
 @end
 
 /**
@@ -238,11 +238,11 @@
  */
 @interface OFInitializationFailedException: OFException {}
 @end
 
 /**
- * \brief An exception indicating the file couldn't be opened.
+ * \brief An exception indicating a file couldn't be opened.
  */
 @interface OFOpenFileFailedException: OFException
 {
 	OFString *path;
 	OFString *mode;
@@ -286,11 +286,11 @@
  */
 - (OFString*)mode;
 @end
 
 /**
- * \brief An exception indicating a read or write to the file failed.
+ * \brief An exception indicating a read or write to a file failed.
  */
 @interface OFReadOrWriteFailedException: OFException
 {
 	size_t req_size;
 	int    err;
@@ -695,11 +695,11 @@
  */
 - (OFString*)service;
 @end
 
 /**
- * \brief An exception indicating that the connection could not be established.
+ * \brief An exception indicating that a connection could not be established.
  */
 @interface OFConnectionFailedException: OFException
 {
 	OFString *node;
 	OFString *service;
@@ -743,11 +743,11 @@
  */
 - (OFString*)service;
 @end
 
 /**
- * \brief An exception indicating that binding the socket failed.
+ * \brief An exception indicating that binding a socket failed.
  */
 @interface OFBindFailedException: OFException
 {
 	OFString *node;
 	OFString *service;
@@ -853,11 +853,11 @@
  */
 - (int)errNo;
 @end
 
 /**
- * \brief An exception indicating that joining the thread failed.
+ * \brief An exception indicating that joining a thread failed.
  */
 @interface OFThreadJoinFailedException: OFException {}
 @end
 
 /**

Index: src/OFNumber.h
==================================================================
--- src/OFNumber.h
+++ src/OFNumber.h
@@ -39,11 +39,11 @@
 	OF_NUMBER_FLOAT,
 	OF_NUMBER_DOUBLE,
 };
 
 /**
- * \brief provides a way to store a number in an object and to manipulate it.
+ * \brief Provides a way to store a number in an object.
  */
 @interface OFNumber: OFObject
 {
 	union {
 		char	       char_;

Index: src/OFObject.h
==================================================================
--- src/OFObject.h
+++ src/OFObject.h
@@ -289,21 +289,21 @@
  */
 - (void)dealloc;
 @end
 
 /**
- * \brief A protocol for creation of copies.
+ * \brief A protocol for the creation of copies.
  */
 @protocol OFCopying
 /**
  * \return A copy of the object
  */
 - (id)copy;
 @end
 
 /**
- * \brief A protocol for creation of mutable copies.
+ * \brief A protocol for the creation of mutable copies.
  *
  * This protocol is implemented by objects that can be mutable and immutable
  * and allows returning a mutable copy.
  */
 @protocol OFMutableCopying

Index: src/OFXMLParser.h
==================================================================
--- src/OFXMLParser.h
+++ src/OFXMLParser.h
@@ -13,11 +13,11 @@
 
 extern int _OFXMLParser_reference;
 
 /**
  * \brief A protocol that needs to be implemented by delegates for
- *	  stringByXMLUnescapingWithHandler:.
+ *	  -[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