@@ -18,11 +18,11 @@
 #import "OFObject.h"
 #import "OFCryptoHash.h"
 
 OF_ASSUME_NONNULL_BEGIN
 
-/*!
+/**
  * @class OFHMAC OFHMAC.h ObjFW/OFHMAC.h
  *
  * @brief A class which provides methods to calculate an HMAC.
  */
 OF_SUBCLASSING_RESTRICTED
@@ -33,35 +33,35 @@
 	id <OFCryptoHash> _Nullable _outerHash, _innerHash;
 	id <OFCryptoHash> _Nullable _outerHashCopy, _innerHashCopy;
 	bool _calculated;
 }
 
-/*!
+/**
  * @brief The class for the cryptographic hash used by the HMAC.
  */
 @property (readonly, nonatomic) Class <OFCryptoHash> hashClass;
 
-/*!
+/**
  * @brief Whether data may be stored in swappable memory.
  */
 @property (readonly, nonatomic) bool allowsSwappableMemory;
 
-/*!
+/**
  * @brief A buffer containing the HMAC.
  *
  * The size of the buffer depends on the hash used. The buffer is part of the
  * receiver's memory pool.
  */
 @property (readonly, nonatomic) const unsigned char *digest
     OF_RETURNS_INNER_POINTER;
 
-/*!
+/**
  * @brief The size of the digest.
  */
 @property (readonly, nonatomic) size_t digestSize;
 
-/*!
+/**
  * @brief Returns a new OFHMAC with the specified hashing algorithm.
  *
  * @param hashClass The class of the hashing algorithm
  * @param allowsSwappableMemory Whether data may be stored in swappable memory
  * @return A new, autoreleased OFHMAC
@@ -69,11 +69,11 @@
 + (instancetype)HMACWithHashClass: (Class <OFCryptoHash>)hashClass
 	    allowsSwappableMemory: (bool)allowsSwappableMemory;
 
 - (instancetype)init OF_UNAVAILABLE;
 
-/*!
+/**
  * @brief Initialized an already allocated OFHMAC with the specified hashing
  *	  algorithm.
  *
  * @param hashClass The class of the hashing algorithm
  * @param allowsSwappableMemory Whether data may be stored in swappable memory
@@ -81,11 +81,11 @@
  */
 - (instancetype)initWithHashClass: (Class <OFCryptoHash>)hashClass
 	    allowsSwappableMemory: (bool)allowsSwappableMemory
     OF_DESIGNATED_INITIALIZER;
 
-/*!
+/**
  * @brief Sets the key for the HMAC.
  *
  * @note This resets the HMAC!
  *
  * @warning This invalidates any pointer previously returned by @ref digest. If
@@ -96,20 +96,20 @@
  * @param length The length of the key for the HMAC
  */
 - (void)setKey: (const void *)key
 	length: (size_t)length;
 
-/*!
+/**
  * @brief Adds a buffer to the HMAC to be calculated.
  *
  * @param buffer The buffer which should be included into the calculation
  * @param length The length of the buffer
  */
 - (void)updateWithBuffer: (const void *)buffer
 		  length: (size_t)length;
 
-/*!
+/**
  * @brief Resets the HMAC so that it can be calculated for a new message.
  *
  * @note This does not reset the key so that a new HMAC with the same key can
  *	 be calculated efficiently. If you want to reset both, use
  *	 @ref setKey:length:.
@@ -118,15 +118,15 @@
  *	    you are still interested in the previous digest, you need to memcpy
  *	    it yourself before calling @ref reset!
  */
 - (void)reset;
 
-/*!
+/**
  * @brief This is like @ref reset, but also zeroes the hashed key and all state.
  *
  * @warning After calling this, you *must* set a new key before reusing the
  *	    HMAC!
  */
 - (void)zero;
 @end
 
 OF_ASSUME_NONNULL_END