diff --git a/include/mbedtls/sha256.h b/include/mbedtls/sha256.h
index 1100869520..22c2c7d7eb 100644
--- a/include/mbedtls/sha256.h
+++ b/include/mbedtls/sha256.h
@@ -128,7 +128,7 @@ int mbedtls_sha256_update_ret( mbedtls_sha256_context *ctx,
  *                 and have a hash operation started.
  * \param output   The SHA-224 or SHA-256 checksum result.
  *                 This must be a writable buffer of length \c 32 bytes
- *                 for SHA-256, 28 bytes for SHA-224.
+ *                 for SHA-256, \c 28 bytes for SHA-224.
  *
  * \return         \c 0 on success.
  * \return         A negative error code on failure.
@@ -166,7 +166,7 @@ int mbedtls_internal_sha256_process( mbedtls_sha256_context *ctx,
  * \param ilen     The length of the input data in Bytes.
  * \param output   The SHA-224 or SHA-256 checksum result.
  *                 This must be a writable buffer of length \c 32 bytes
- *                 for SHA-256, 28 bytes for SHA-224.
+ *                 for SHA-256, \c 28 bytes for SHA-224.
  * \param is224    Determines which function to use. This must be
  *                 either \c 0 for SHA-256, or \c 1 for SHA-224.
  */
diff --git a/include/mbedtls/sha512.h b/include/mbedtls/sha512.h
index 2852273140..ef1fa22231 100644
--- a/include/mbedtls/sha512.h
+++ b/include/mbedtls/sha512.h
@@ -135,7 +135,7 @@ int mbedtls_sha512_update_ret( mbedtls_sha512_context *ctx,
  *                 and have a hash operation started.
  * \param output   The SHA-384 or SHA-512 checksum result.
  *                 This must be a writable buffer of length \c 64 bytes
- *                 for SHA-512, 48 bytes for SHA-384.
+ *                 for SHA-512, \c 48 bytes for SHA-384.
  *
  * \return         \c 0 on success.
  * \return         A negative error code on failure.
@@ -173,7 +173,7 @@ int mbedtls_internal_sha512_process( mbedtls_sha512_context *ctx,
  * \param ilen     The length of the input data in Bytes.
  * \param output   The SHA-384 or SHA-512 checksum result.
  *                 This must be a writable buffer of length \c 64 bytes
- *                 for SHA-512, 48 bytes for SHA-384.
+ *                 for SHA-512, \c 48 bytes for SHA-384.
  * \param is384    Determines which function to use. This must be either
  *                 \c 0 for SHA-512, or \c 1 for SHA-384.
  *