Skip to content

blk-mq-dma: kernel-doc fixes

Bryan Boquel linux-block lkml 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest2 patches 2 repliesIn review

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/2blk-mq-dma: fix kernel-doc for integrity DMA iteratorsblock/blk-mq-dma.c+2 -31 reply
2/2blk-mq-dma: fix typo in DMA iterator kernel-docblock/blk-mq-dma.c+2 -21 reply

Reviews trailers per patch

All 2 patches have a Reviewed-by or Acked-by.

PatchChristoph Hellwig
1/2R-b
2/2R-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v1 thread

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

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(-)
Signature · 1 line
2.39.2 (Apple Git-143)