Index: src/OFIRI.h
==================================================================
--- src/OFIRI.h
+++ src/OFIRI.h
@@ -26,12 +26,14 @@
 @class OFString;
 
 /**
  * @class OFIRI OFIRI.h ObjFW/OFIRI.h
  *
- * @brief A class for parsing Internationalized Resource Identifiers as per
- *	  RFC 3987 and accessing parts of it.
+ * @brief A class for representing IRIs, URIs, URLs and URNs, for parsing them
+ *	  as well as accessing parts of them.
+ *
+ * This class follows RFC 3976 and RFC 3987.
  */
 @interface OFIRI: OFObject <OFCopying, OFMutableCopying, OFSerialization>
 {
 	OFString *_scheme;
 	OFString *_Nullable _percentEncodedHost;
@@ -159,11 +161,11 @@
  * @brief The IRI with relative subpaths resolved.
  */
 @property (readonly, nonatomic) OFIRI *IRIByStandardizingPath;
 
 /**
- * @brief The IRI with percent-encoding applied to all Unicode characters.
+ * @brief The IRI with percent-encoding added for all Unicode characters.
  */
 @property (readonly, nonatomic)
     OFIRI *IRIByAddingPercentEncodingForUnicodeCharacters;
 
 #ifdef OF_HAVE_FILES

Index: src/OFMutableIRI.h
==================================================================
--- src/OFMutableIRI.h
+++ src/OFMutableIRI.h
@@ -18,12 +18,14 @@
 OF_ASSUME_NONNULL_BEGIN
 
 /**
  * @class OFMutableIRI OFMutableIRI.h ObjFW/OFMutableIRI.h
  *
- * @brief A class for parsing Internationalized Resource Identifiers as per
- *	  RFC 3987 and accessing and modifying parts of it.
+ * @brief A class for representing IRIs, URIs, URLs and URNs, for parsing them,
+ *	  accessing parts of them as well as modifying them.
+ *
+ * This class follows RFC 3976 and RFC 3987.
  */
 @interface OFMutableIRI: OFIRI
 {
 	OF_RESERVE_IVARS(OFMutableIRI, 4)
 }