[PATCH 0/2] blk-mq-dma: kernel-doc fixes

Bryan Boquel posted 2 patches 1 week ago
block/blk-mq-dma.c | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
[PATCH 0/2] blk-mq-dma: kernel-doc fixes
Posted by Bryan Boquel 1 week ago
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)