Index: src/OFArray.h
==================================================================
--- src/OFArray.h
+++ src/OFArray.h
@@ -386,11 +386,11 @@
 /*!
  * @brief Returns a copy of the array sorted using the specified selector and
  *	  options.
  *
  * @param selector The selector to use to sort the array. It's signature
- *		   should be the same as that of @ref OFComparing#compare:.
+ *		   should be the same as that of -[compare:].
  * @param options The options to use when sorting the array.@n
  *		  Possible values are:
  *		  Value                      | Description
  *		  ---------------------------|-------------------------
  *		  `OF_ARRAY_SORT_DESCENDING` | Sort in descending order

Index: src/OFDNSResponse.h
==================================================================
--- src/OFDNSResponse.h
+++ src/OFDNSResponse.h
@@ -70,10 +70,11 @@
 @property (readonly, nonatomic) of_dns_response_records_t additionalRecords;
 
 /*!
  * @brief Creates a new, autoreleased OFDNSResponse.
  *
+ * @param domainName The domain name the response is for
  * @param answerRecords The answer records of the response
  * @param authorityRecords The authority records of the response
  * @param additionalRecords The additional records of the response
  * @return A new, autoreleased OFDNSResponse
  */
@@ -84,10 +85,11 @@
 	 additionalRecords: (of_dns_response_records_t)additionalRecords;
 
 /*!
  * @brief Initializes an already allocated OFDNSResponse.
  *
+ * @param domainName The domain name the response is for
  * @param answerRecords The answer records of the response
  * @param authorityRecords The authority records of the response
  * @param additionalRecords The additional records of the response
  * @return An initialized OFDNSResponse
  */

Index: src/OFFileManager.h
==================================================================
--- src/OFFileManager.h
+++ src/OFFileManager.h
@@ -140,19 +140,19 @@
  * via @ref OFDictionary#filePOSIXGID.
  */
 extern const of_file_attribute_key_t of_file_attribute_key_posix_gid;
 
 /*!
- * @brief The owner of the file as an @ref OFString.
+ * @brief The owner of the file as an OFString.
  *
  * For convenience, a category on @ref OFDictionary is provided to access this
  * via @ref OFDictionary#fileOwner.
  */
 extern const of_file_attribute_key_t of_file_attribute_key_owner;
 
 /*!
- * @brief The group of the file as an @ref OFString.
+ * @brief The group of the file as an OFString.
  *
  * For convenience, a category on @ref OFDictionary is provided to access this
  * via @ref OFDictionary#fileGroup.
  */
 extern const of_file_attribute_key_t of_file_attribute_key_group;
@@ -188,11 +188,11 @@
  * via @ref OFDictionary#fileCreationDate.
  */
 extern const of_file_attribute_key_t of_file_attribute_key_creation_date;
 
 /*!
- * @brief The destination of a symbolic link as an @ref OFString.
+ * @brief The destination of a symbolic link as an OFString.
  *
  * For convenience, a category on @ref OFDictionary is provided to access this
  * via @ref OFDictionary#fileSymbolicLinkDestination.
  */
 extern const of_file_attribute_key_t

Index: src/OFMutableArray.h
==================================================================
--- src/OFMutableArray.h
+++ src/OFMutableArray.h
@@ -202,11 +202,11 @@
 
 /*!
  * @brief Sorts the array using the specified selector and options.
  *
  * @param selector The selector to use to sort the array. It's signature
- *		   should be the same as that of @ref OFComparing#compare:.
+ *		   should be the same as that of -[compare:].
  * @param options The options to use when sorting the array.@n
  *		  Possible values are:
  *		  Value                      | Description
  *		  ---------------------------|-------------------------
  *		  `OF_ARRAY_SORT_DESCENDING` | Sort in descending order

Index: src/OFMutableDictionary.h
==================================================================
--- src/OFMutableDictionary.h
+++ src/OFMutableDictionary.h
@@ -66,11 +66,11 @@
 - (instancetype)initWithCapacity: (size_t)capacity;
 
 /*!
  * @brief Sets an object for a key.
  *
- * A key can be any object that conforms to the @ref OFCopying protocol.
+ * A key can be any object that conforms to the OFCopying protocol.
  *
  * @param key The key to set
  * @param object The object to set the key to
  */
 - (void)setObject: (ObjectType)object
@@ -77,11 +77,11 @@
 	   forKey: (KeyType)key;
 
 /*!
  * @brief Sets an object for a key.
  *
- * A key can be any object that conforms to the @ref OFCopying protocol.
+ * A key can be any object that conforms to the OFCopying protocol.
  *
  * This method is also used by the subscripting syntax.
  *
  * @param key The key to set
  * @param object The object to set the key to. If it is nil, this is equal to

Index: src/OFOptionsParser.h
==================================================================
--- src/OFOptionsParser.h
+++ src/OFOptionsParser.h
@@ -53,11 +53,11 @@
 	 * been specified.
 	 */
 	bool *_Nullable isSpecifiedPtr;
 
 	/*!
-	 * An optional pointer to an @ref OFString * that is set to the
+	 * An optional pointer to an `OFString *` that is set to the
 	 * argument specified for the option or `nil` for no argument.
 	 */
 	OFString *__autoreleasing _Nullable *_Nullable argumentPtr;
 } of_options_parser_option_t;
 

Index: src/OFSecureData.h
==================================================================
--- src/OFSecureData.h
+++ src/OFSecureData.h
@@ -25,12 +25,13 @@
  * @brief A class for storing arbitrary data in secure (non-swappable) memory,
  *	  securely wiping it when it gets deallocated.
  *
  * @warning Non-swappable memory might be unavailable, in which case this falls
  *	    back to swappable memory, but still wipes the data when it gets
- *	    deallocated. Check the @ref swappable property to see whether a
- *	    particular OFSecureData was allocated in swappable memory.
+ *	    deallocated. Check the @ref allowsSwappableMemory property to see
+ *	    whether a particular OFSecureData might be allocated in swappable
+ *	    memory.
  */
 OF_SUBCLASSING_RESTRICTED
 @interface OFSecureData: OFData
 {
 	struct page *_page;