@@ -1216,15 +1216,15 @@
 /**
  * @protocol OFComparing OFObject.h ObjFW/OFObject.h
  *
  * @brief A protocol for comparing objects.
  *
- * This protocol is implemented by objects that can be compared.
+ * This protocol is implemented by objects that can be compared. Its only method, @ref compare:, should be overridden with a stronger type.
  */
 @protocol OFComparing
 /**
- * @brief Compares the object with another object.
+ * @brief Compares the object to another object.
  *
  * @param object An object to compare the object to
  * @return The result of the comparison
  */
 - (of_comparison_result_t)compare: (id <OFComparing>)object;