From: Bryan Boquel <boquelbryan6@gmail.com>
To: axboe@kernel.dk
Cc: linux-block@vger.kernel.org, linux-kernel@vger.kernel.org,
Bryan Boquel <boquelbryan6@gmail.com>
Subject: [PATCH 0/2] blk-mq-dma: kernel-doc fixes
Date: Sun, 16 Aug 2026 15:14:54 +0200 [thread overview]
Message-ID: <20260816131456.16374-1-boquelbryan6@gmail.com> (raw)
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)
next reply other threads:[~2026-08-16 13:15 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-08-16 13:14 Bryan Boquel [this message]
2026-08-16 13:14 ` [PATCH 1/2] blk-mq-dma: fix kernel-doc for integrity DMA iterators Bryan Boquel
2026-08-16 13:14 ` [PATCH 2/2] blk-mq-dma: fix typo in DMA iterator kernel-doc Bryan Boquel
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260816131456.16374-1-boquelbryan6@gmail.com \
--to=boquelbryan6@gmail.com \
--cc=axboe@kernel.dk \
--cc=linux-block@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.