[PATCH 0/2] blk-mq-dma: kernel-doc fixes
From: Bryan Boquel
Date: Sun Aug 16 2026 - 09:15:51 EST
Two comment-only fixes for block/blk-mq-dma.c. Neither changes the
generated code.
Patch 1 removes a @state parameter description from
blk_rq_integrity_dma_map_iter_next(), which has never taken that
argument, and fixes the tab-after-"* " alignment checkpatch complains
about in the two integrity summary lines.
Patch 2 fixes "ft" -> "if" in the return value description of
blk_rq_dma_map_iter_start() and blk_rq_dma_map_iter_next().
Per Documentation/process/generated-content.rst, disclosure of the
tooling used:
- The defects were found by running scripts/kernel-doc and
scripts/checkpatch.pl over block/ and comparing the resulting
warnings against the function prototypes.
- An AI coding assistant (Claude, claude-opus-5) was used across an
interactive session to run those scripts, cross-check the
signatures in include/linux/blk-integrity.h, identify the
introducing commits for the Fixes: tags, and draft these
changelogs. The code changes themselves are confined to comment
text and whitespace.
- Verification: scripts/kernel-doc reports no warnings for
block/blk-mq-dma.c after the series; scripts/checkpatch.pl reports
no errors or warnings on either patch; both apply cleanly to
for-next. The series has not been compile-tested, as it was
prepared on a non-Linux host; it touches only comments.
Bryan Boquel (2):
blk-mq-dma: fix kernel-doc for integrity DMA iterators
blk-mq-dma: fix typo in DMA iterator kernel-doc
block/blk-mq-dma.c | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
--
2.39.2 (Apple Git-143)