- * br_xxx_BLOCK_SIZE
- * A macro that evaluates to the block size (in bytes) of the
- * cipher. For all implemented block ciphers, this value is a
- * power of two.
- *
- * br_xxx_cbcenc_keys
- * Context structure that contains the subkeys resulting from the key
- * expansion. These subkeys are appropriate for CBC encryption. The
- * structure first field is called 'vtable' and points to the
- * appropriate OOP structure.
- *
- * br_xxx_cbcenc_init(br_xxx_cbcenc_keys *ctx, const void *key, size_t len)
- * Perform key expansion: subkeys for CBC encryption are computed and
- * written in the provided context structure. The key length MUST be
- * adequate for the implemented block cipher. This function also sets
- * the 'vtable' field.
- *
- * br_xxx_cbcenc_run(const br_xxx_cbcenc_keys *ctx,
- * void *iv, void *data, size_t len)
- * Perform CBC encryption of 'len' bytes, in place. The encrypted data
- * replaces the cleartext. 'len' MUST be a multiple of the block length
- * (if it is not, the function may loop forever or overflow a buffer).
- * The IV is provided with the 'iv' pointer; it is also updated with
- * a copy of the last encrypted block.
- *
- * br_xxx_cbcdec_keys
- * Context structure that contains the subkeys resulting from the key
- * expansion. These subkeys are appropriate for CBC decryption. The
- * structure first field is called 'vtable' and points to the
- * appropriate OOP structure.
- *
- * br_xxx_cbcdec_init(br_xxx_cbcenc_keys *ctx, const void *key, size_t len)
- * Perform key expansion: subkeys for CBC decryption are computed and
- * written in the provided context structure. The key length MUST be
- * adequate for the implemented block cipher. This function also sets
- * the 'vtable' field.
- *
- * br_xxx_cbcdec_run(const br_xxx_cbcdec_keys *ctx,
- * void *iv, void *data, size_t num_blocks)
- * Perform CBC decryption of 'len' bytes, in place. The decrypted data
- * replaces the ciphertext. 'len' MUST be a multiple of the block length
- * (if it is not, the function may loop forever or overflow a buffer).
- * The IV is provided with the 'iv' pointer; it is also updated with
- * a copy of the last encrypted block.
- *
- * br_xxx_ctr_keys
- * Context structure that contains the subkeys resulting from the key
- * expansion. These subkeys are appropriate for CTR encryption and
- * decryption. The structure first field is called 'vtable' and
- * points to the appropriate OOP structure.
- *
- * br_xxx_ctr_init(br_xxx_ctr_keys *ctx, const void *key, size_t len)
- * Perform key expansion: subkeys for CTR encryption and decryption
- * are computed and written in the provided context structure. The
- * key length MUST be adequate for the implemented block cipher. This
- * function also sets the 'vtable' field.
- *
- * br_xxx_ctr_run(const br_xxx_ctr_keys *ctx, const void *iv,
- * uint32_t cc, void *data, size_t len) [returns uint32_t]
- * Perform CTR encryption/decryption of some data. Processing is done
- * "in place" (the output data replaces the input data). This function
- * implements the "standard incrementing function" from NIST SP800-38A,
- * annex B: the IV length shall be 4 bytes less than the block size
- * (i.e. 12 bytes for AES) and the counter is the 32-bit value starting
- * with 'cc'. The data length ('len') is not necessarily a multiple of
- * the block size. The new counter value is returned, which supports
- * chunked processing, provided that each chunk length (except possibly
- * the last one) is a multiple of the block size.
- *
- *
- * It shall be noted that the key expansion functions return 'void'. If
+ * - `br_xxx_BLOCK_SIZE`
+ *
+ * A macro that evaluates to the block size (in bytes) of the
+ * cipher. For all implemented block ciphers, this value is a
+ * power of two.
+ *
+ * - `br_xxx_cbcenc_keys`
+ *
+ * Context structure that contains the subkeys resulting from the key
+ * expansion. These subkeys are appropriate for CBC encryption. The
+ * structure first field is called `vtable` and points to the
+ * appropriate OOP structure.
+ *
+ * - `br_xxx_cbcenc_init(br_xxx_cbcenc_keys *ctx, const void *key, size_t len)`
+ *
+ * Perform key expansion: subkeys for CBC encryption are computed and
+ * written in the provided context structure. The key length MUST be
+ * adequate for the implemented block cipher. This function also sets
+ * the `vtable` field.
+ *
+ * - `br_xxx_cbcenc_run(const br_xxx_cbcenc_keys *ctx, void *iv, void *data, size_t len)`
+ *
+ * Perform CBC encryption of `len` bytes, in place. The encrypted data
+ * replaces the cleartext. `len` MUST be a multiple of the block length
+ * (if it is not, the function may loop forever or overflow a buffer).
+ * The IV is provided with the `iv` pointer; it is also updated with
+ * a copy of the last encrypted block.
+ *
+ * - `br_xxx_cbcdec_keys`
+ *
+ * Context structure that contains the subkeys resulting from the key
+ * expansion. These subkeys are appropriate for CBC decryption. The
+ * structure first field is called `vtable` and points to the
+ * appropriate OOP structure.
+ *
+ * - `br_xxx_cbcdec_init(br_xxx_cbcenc_keys *ctx, const void *key, size_t len)`
+ *
+ * Perform key expansion: subkeys for CBC decryption are computed and
+ * written in the provided context structure. The key length MUST be
+ * adequate for the implemented block cipher. This function also sets
+ * the `vtable` field.
+ *
+ * - `br_xxx_cbcdec_run(const br_xxx_cbcdec_keys *ctx, void *iv, void *data, size_t num_blocks)`
+ *
+ * Perform CBC decryption of `len` bytes, in place. The decrypted data
+ * replaces the ciphertext. `len` MUST be a multiple of the block length
+ * (if it is not, the function may loop forever or overflow a buffer).
+ * The IV is provided with the `iv` pointer; it is also updated with
+ * a copy of the last _encrypted_ block.
+ *
+ * - `br_xxx_ctr_keys`
+ *
+ * Context structure that contains the subkeys resulting from the key
+ * expansion. These subkeys are appropriate for CTR encryption and
+ * decryption. The structure first field is called `vtable` and
+ * points to the appropriate OOP structure.
+ *
+ * - `br_xxx_ctr_init(br_xxx_ctr_keys *ctx, const void *key, size_t len)`
+ *
+ * Perform key expansion: subkeys for CTR encryption and decryption
+ * are computed and written in the provided context structure. The
+ * key length MUST be adequate for the implemented block cipher. This
+ * function also sets the `vtable` field.
+ *
+ * - `br_xxx_ctr_run(const br_xxx_ctr_keys *ctx, const void *iv, uint32_t cc, void *data, size_t len)` (returns `uint32_t`)
+ *
+ * Perform CTR encryption/decryption of some data. Processing is done
+ * "in place" (the output data replaces the input data). This function
+ * implements the "standard incrementing function" from NIST SP800-38A,
+ * annex B: the IV length shall be 4 bytes less than the block size
+ * (i.e. 12 bytes for AES) and the counter is the 32-bit value starting
+ * with `cc`. The data length (`len`) is not necessarily a multiple of
+ * the block size. The new counter value is returned, which supports
+ * chunked processing, provided that each chunk length (except possibly
+ * the last one) is a multiple of the block size.
+ *
+ *
+ * It shall be noted that the key expansion functions return `void`. If