diff --git a/src/kernel/bitcoinkernel.h b/src/kernel/bitcoinkernel.h
index d91a4a633bc..1540f20ee22 100644
--- a/src/kernel/bitcoinkernel.h
+++ b/src/kernel/bitcoinkernel.h
@@ -675,10 +675,9 @@ BITCOINKERNEL_API const btck_Txid* BITCOINKERNEL_WARN_UNUSED_RESULT btck_transac
  *
  * @param[in]  tx               Non-null, the transaction to validate.
  * @param[out] validation_state Non-null, previously created with
- *                              btck_tx_validation_state_create. Reset on
- *                              entry (any prior contents are overwritten)
- *                              and updated in-place with the validation
- *                              result before this function returns.
+ *                              btck_tx_validation_state_create.
+ *                              Overwritten in-place with the validation
+ *                              result.
  * @return                      1 if valid, 0 if invalid.
  * @note                        Only btck_TxValidationResult_UNSET and
  *                              btck_TxValidationResult_CONSENSUS are
@@ -1383,9 +1382,10 @@ typedef uint32_t btck_BlockCheckFlags;
  *                                  optional POW and merkle-root checks. Use
  *                                  btck_BlockCheckFlags_BASE to run only the base
  *                                  checks.
- * @param[in,out] validation_state  Non-null, previously created with
- *                                  btck_block_validation_state_create and updated
- *                                  in-place with the validation result.
+ * @param[out]    validation_state  Non-null, previously created with
+ *                                  btck_block_validation_state_create.
+ *                                  Overwritten in-place with the validation
+ *                                  result.
  * @return                          1 if the btck_Block passed the checks, 0 otherwise.
  */
 BITCOINKERNEL_API int BITCOINKERNEL_WARN_UNUSED_RESULT btck_block_check(