From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f47.google.com (mail-wr1-f47.google.com [209.85.221.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51DEE175A5 for ; Sun, 16 Aug 2026 13:15:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.47 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786886140; cv=none; b=gMZYfbGVtBq4wkCZ1cnXiqDCtDUkAqf7uDIYkLJBkF/wjh2lQwsVVIBbwSPie/4ia1U1L0yeGWcmfEfwa3Avwg5WxNJghsaoNp2gg1MramEjmBQMrn6GFFMuCYfsweihX47OvyyvLr+q8bfmTMwszNGhUrd8/ZeUIRGtpTvc6Uo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786886140; c=relaxed/simple; bh=BXac47jawx3iX5KRiX+sl0th2Nct+GIA+FieEpjeq6k=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=dsGuSd3JZZICIgc9skb/jvei3t3/cIcJa7rEMI1Z8EJSvRxUn2g4AZi1BrpKu/pYjzLxqTQgpVhNfikZXxP4nkoF8HDjVdCp69OgU1FSGO1RD/FOhDpAAG1v2hfxLk8mtYgpmxRA+65zMOSUDzihOZoIA3ZOR+4fPzOBhgkJ0w4= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=E6gYs4t4; arc=none smtp.client-ip=209.85.221.47 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="E6gYs4t4" Received: by mail-wr1-f47.google.com with SMTP id ffacd0b85a97d-47f633e6058so2234760f8f.0 for ; Sun, 16 Aug 2026 06:15:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786886136; x=1787490936; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=eq6iUASZc+iLA5Cv0/JGhI084DB8b2Fr3EMA+PEhPik=; b=E6gYs4t42QGiFIHx1/zgWn84yJCLpKhWsmnRFDduZnosJvxqBEze8Ib3N/dYJJQqkk p/WENxEWBIeGnyh5ap7IUg3CN+K9Y48+aDcb7fzOsMhbtG7IW3ZbVWxjbVV7tV+FDfmo r4FeQIayLSbBI5xGwXiKL7D86++TnE/GceWlb6IwqF/Uw9ZFgi1wpfVZBCoZ11nZ0aT0 9N8lfPvMTUdHIBiCHeHUthwCmuuAvKOGJcAbxFQMjHxgazP1qt5je7k4W2Kc1mCnvDLK pGYcfYkN2fwJeooVH/AiUfS7mpYdQTYA3e7d9ZzCdhbVvcmkBbVyfVS3D1CN40gUM1Zm eJIA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786886136; x=1787490936; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=eq6iUASZc+iLA5Cv0/JGhI084DB8b2Fr3EMA+PEhPik=; b=d61UuBBJE3VqGOLUMsHGrb6NxFrE4G5JwxNd0EmSxxSjRfO4npaxwS4o2Fac8ARwlh 9+XtVenT4sqzCfKuEqAvWD05IjDgaYjkJMQgX6QgvoHkjKw8SXI77bx+U1OSQVLNsCUr 2leOn3RfKEAY3s1GcpQWYk5+XIpDzIEkQ87l6YMVR2xHbBCEDTJJHNqFGWaS6YEfZ4ZC Lo/VxAQb2ch23egYOzTT9uNMfllc0ushEld2wyN2VzAgpXRLI5yjZXs5XO29P1gM37rz 6ih41Srd/CL4Pt4h1Wo/9q7FtEyGi/rub4reW2JSzYg69UfX3enLbqpcUYVBSYhwMVvg gUTQ== X-Forwarded-Encrypted: i=1; AHgh+Rqz7OX82pp2IZTXXyEpXq+0khQplYybYUbuVtVAMV6+H3YTV9pNMyrVrAikJ4Ap5eAP9MAWA6Ts3GLm0WY=@vger.kernel.org X-Gm-Message-State: AOJu0YxAqW4Xy7spe2QIgApWFmiXVHpCesOiBEiKq8sE8f8Zk23z21rN D+HHkEzI3Qf4E8OP6TrMuBsbNMr9J8tr8r14KyRkEMjLi+Gwc7sTyTNa X-Gm-Gg: AR+sD13x0UodnYYS2BygZFs2jIK+CJLacJ66fO0Cm2N7wyCYDDZ+W0ueupWepTza1GG somKmIrpjgTrCCQ18P2xnIKY+gA94EskNHSIt2oS5cXe+uGKiyfZ/xcZJWP/qdJCZwZBbIs7juS ZYTfcYbWDH45EAe4HafzsSaUUmzgVhS+eaHLek8TIjM2I8gshI4H7A8rqJmdvgi7+tw+IOF6LtV hBmQE6uhAzc5ajygSwIqSCO6n+stKGArwmIacSHKX/218EL3ya/PhQG5fJG7+Lp6RPI0psAKNte C+gAm1WaRB8dFN0dNxPnK+iL9mhWufKX66FnOMrsBF+gBFjjHTpcm6Pt0QVcJqVYJFGSg0HZKQn txfnvr8Yg1BkbfgkbmizCaIRGIyJv3en5vW+j5gvGsmiYIgkrwSr9PYVGVTSuxWBZ1Jmsk74rl7 ycYYuhRuxheuhamlTOuAJaGII9glN5n2gvzciOoUfDCn9ulxXU4X8G1atkgbPuGks/SBX1c9Xcy fzJVqym2XsqKNASHXPI+ya8fbi3Ze7cW5B6hzflAS+1ybkGPFZBEpOQQItAItL2iFvbzap2mrRH /TgxLrO9ZQ== X-Received: by 2002:a5d:644c:0:b0:47f:c62e:9cca with SMTP id ffacd0b85a97d-48160798113mr22090627f8f.22.1786886136309; Sun, 16 Aug 2026 06:15:36 -0700 (PDT) Received: from macbook-pro-de-bryan.home ([2a01:e0a:d7f:f4f0:306b:5f99:5378:73e0]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-4815f2cc81csm24721295f8f.34.2026.08.16.06.15.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 16 Aug 2026 06:15:35 -0700 (PDT) From: Bryan Boquel To: axboe@kernel.dk Cc: linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, Bryan Boquel Subject: [PATCH 0/2] blk-mq-dma: kernel-doc fixes Date: Sun, 16 Aug 2026 15:14:54 +0200 Message-Id: <20260816131456.16374-1-boquelbryan6@gmail.com> X-Mailer: git-send-email 2.39.2 (Apple Git-143) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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)