Fix some documentation markup/wording issues
diff --git a/include/mbedtls/aes.h b/include/mbedtls/aes.h
index d21427e..b42e564 100644
--- a/include/mbedtls/aes.h
+++ b/include/mbedtls/aes.h
@@ -250,9 +250,9 @@
* \param mode The AES operation: #MBEDTLS_AES_ENCRYPT or
* #MBEDTLS_AES_DECRYPT.
* \param input The buffer holding the input data.
- * It must be readable and at least 16 Bytes long.
+ * It must be readable and at least \c 16 Bytes long.
* \param output The buffer where the output data will be written.
- * It must be writeable and at least 16 Bytes long.
+ * It must be writeable and at least \c 16 Bytes long.
* \return \c 0 on success.
*/
@@ -276,7 +276,7 @@
* before the first call to this API with the same context.
*
* \note This function operates on full blocks, that is, the input size
- * must be a multiple of the AES block size of 16 Bytes.
+ * must be a multiple of the AES block size of \c 16 Bytes.
*
* \note Upon exit, the content of the IV is updated so that you can
* call the same function again on the next
@@ -291,13 +291,13 @@
* \param mode The AES operation: #MBEDTLS_AES_ENCRYPT or
* #MBEDTLS_AES_DECRYPT.
* \param length The length of the input data in Bytes. This must be a
- * multiple of the block size (16 Bytes).
+ * multiple of the block size (\c 16 Bytes).
* \param iv Initialization vector (updated after use).
- * It must be a readable and writeable buffer of 16 Bytes.
+ * It must be a readable and writeable buffer of \c 16 Bytes.
* \param input The buffer holding the input data.
- * It must be readable and of size \p length.
+ * It must be readable and of size \p length Bytes.
* \param output The buffer holding the output data.
- * It must be writeable and of size \p length.
+ * It must be writeable and of size \p length Bytes.
*
* \return \c 0 on success.
* \return #MBEDTLS_ERR_AES_INVALID_INPUT_LENGTH
@@ -328,7 +328,7 @@
* It must be initialized and bound to a key.
* \param mode The AES operation: #MBEDTLS_AES_ENCRYPT or
* #MBEDTLS_AES_DECRYPT.
- * \param length The length of a data unit in bytes. This can be any
+ * \param length The length of a data unit in Bytes. This can be any
* length between 16 bytes and 2^24 bytes inclusive
* (between 1 and 2^20 block cipher blocks).
* \param data_unit The address of the data unit encoded as an array of 16
@@ -336,15 +336,15 @@
* is typically the index of the block device sector that
* contains the data.
* \param input The buffer holding the input data (which is an entire
- * data unit). This function reads \p length bytes from \p
+ * data unit). This function reads \p length Bytes from \p
* input.
* \param output The buffer holding the output data (which is an entire
- * data unit). This function writes \p length bytes to \p
+ * data unit). This function writes \p length Bytes to \p
* output.
*
* \return \c 0 on success.
* \return #MBEDTLS_ERR_AES_INVALID_INPUT_LENGTH if \p length is
- * smaller than an AES block in size (16 bytes) or if \p
+ * smaller than an AES block in size (16 Bytes) or if \p
* length is larger than 2^20 blocks (16 MiB).
*/
int mbedtls_aes_crypt_xts( mbedtls_aes_xts_context *ctx,
@@ -383,15 +383,15 @@
* It must be initialized and bound to a key.
* \param mode The AES operation: #MBEDTLS_AES_ENCRYPT or
* #MBEDTLS_AES_DECRYPT.
- * \param length The length of the input data.
+ * \param length The length of the input data in Bytes.
* \param iv_off The offset in IV (updated after use).
* It must point to a valid \c size_t.
* \param iv The initialization vector (updated after use).
- * It must be a readable and writeable buffer of 16 Bytes.
+ * It must be a readable and writeable buffer of \c 16 Bytes.
* \param input The buffer holding the input data.
- * It must be readable and of size \p length.
+ * It must be readable and of size \p length Bytes.
* \param output The buffer holding the output data.
- * It must be writeable and of size \p length.
+ * It must be writeable and of size \p length Bytes.
*
* \return \c 0 on success.
*/
@@ -431,11 +431,11 @@
* #MBEDTLS_AES_DECRYPT
* \param length The length of the input data.
* \param iv The initialization vector (updated after use).
- * It must be a readable and writeable buffer of 16 Bytes.
+ * It must be a readable and writeable buffer of \c 16 Bytes.
* \param input The buffer holding the input data.
- * It must be readable and of size \p length.
+ * It must be readable and of size \p length Bytes.
* \param output The buffer holding the output data.
- * It must be writeable and of size \p length.
+ * It must be writeable and of size \p length Bytes.
*
* \return \c 0 on success.
*/
@@ -485,11 +485,11 @@
* \param iv_off The offset in IV (updated after use).
* It must point to a valid \c size_t.
* \param iv The initialization vector (updated after use).
- * It must be a readable and writeable buffer of 16 Bytes.
+ * It must be a readable and writeable buffer of \c 16 Bytes.
* \param input The buffer holding the input data.
- * It must be readable and of size \p length.
+ * It must be readable and of size \p length Bytes.
* \param output The buffer holding the output data.
- * It must be writeable and of size \p length.
+ * It must be writeable and of size \p length Bytes.
*
* \return \c 0 on success.
*/
@@ -568,14 +568,14 @@
* offset pointer should be 0 at the start of a stream.
* It must point to a valid \c size_t.
* \param nonce_counter The 128-bit nonce and counter.
- * It must be a readable-writeable buffer of 16 Bytes.
+ * It must be a readable-writeable buffer of \c 16 Bytes.
* \param stream_block The saved stream block for resuming. This is
* overwritten by the function.
- * It must be a readable-writeable buffer of 16 Bytes.
+ * It must be a readable-writeable buffer of \c 16 Bytes.
* \param input The buffer holding the input data.
- * It must be readable and of size \p length.
+ * It must be readable and of size \p length Bytes.
* \param output The buffer holding the output data.
- * It must be writeable and of size \p length.
+ * It must be writeable and of size \p length Bytes.
*
* \return \c 0 on success.
*/
@@ -628,7 +628,7 @@
* \brief Deprecated internal AES block encryption function
* without return value.
*
- * \deprecated Superseded by mbedtls_internal_aes_encrypt() in 2.5.0.
+ * \deprecated Superseded by mbedtls_internal_aes_encrypt()
*
* \param ctx The AES context to use for encryption.
* \param input Plaintext block.
@@ -642,7 +642,7 @@
* \brief Deprecated internal AES block decryption function
* without return value.
*
- * \deprecated Superseded by mbedtls_internal_aes_decrypt() in 2.5.0.
+ * \deprecated Superseded by mbedtls_internal_aes_decrypt()
*
* \param ctx The AES context to use for decryption.
* \param input Ciphertext block.