diff --git a/include/mbedtls/mbedtls_config.h b/include/mbedtls/mbedtls_config.h
index 63649f4..ffc216e 100644
--- a/include/mbedtls/mbedtls_config.h
+++ b/include/mbedtls/mbedtls_config.h
@@ -2862,7 +2862,7 @@
 /**
  * \def MBEDTLS_PKCS7_C
  *
- * Enable PKCS7 core for using PKCS7 formatted signatures.
+ * Enable PKCS #7 core for using PKCS #7-formatted signatures.
  * RFC Link - https://tools.ietf.org/html/rfc2315
  *
  * Module:  library/pkcs7.c
diff --git a/include/mbedtls/pkcs7.h b/include/mbedtls/pkcs7.h
index 7f2aa9e..cf1555c 100644
--- a/include/mbedtls/pkcs7.h
+++ b/include/mbedtls/pkcs7.h
@@ -22,8 +22,8 @@
  */
 
 /**
- * Note: For the time being, this implementation of the PKCS #7 cryptographic
- * message syntax is a partial implementation of RFC 2315.
+ * Note: For the time being, this implementation of the PKCS #7 Cryptographic
+ * Message Syntax is a partial implementation of RFC 2315.
  * Differences include:
  *  - The RFC specifies 6 different content types. The only type currently
  *    supported in Mbed TLS is the signed data content type.