All of lore.kernel.org
 help / color / mirror / Atom feed
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)


             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.