From nobody Tue Dec 16 07:40:17 2025 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 14715270575 for ; Sun, 14 Dec 2025 20:20:20 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765743623; cv=none; b=lmejbQrIcn+jZKoGJWhdMX0sa+0J42jJOfTXkQCIGG0mggwducJJQ6Kej+7GS0apq6y6Zj6Px6g7JwsIxP0z77m7HimvJfnBkdEVM40tquXEKttJpQwKFEf5wm1aqcsV+F0HYYsYx45asTJeD+s1I9t7vp0T3NRbLnZjCiAKwfE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765743623; c=relaxed/simple; bh=KQsc+ryytMmEdtzcpH6Wm9sYyAYu+khswooMqv0a+Ys=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=r6l/Ol1WWJlB0/vuzoEA1nf434B84CKN4SsW6UNHT0b+qnb0CJLsuxNKr5n3YKrCXHyqq5hO6VfXqJh9PtjaLecO68VVrBM20tJffcZ9NEKVf6hHPVFmXsPiBLQoTatGzvgDoXlKY/L0PqjiTYS7JmsYms8Jv0NkaYHNtthiRVs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=voPLXKkS; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="voPLXKkS" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: Content-ID:Content-Description:In-Reply-To:References; bh=sdZ2XNso7LaVfo7xffwtPadlGCczVr6VgA9Hc58ER7M=; b=voPLXKkS0xllnSy/qI9HUA+dpU 2b8HSR3VgmhwTx2iki/+vGiD9iLMm2A3DLC+X/eFYnwgRqSsXUsxyFSPNibEyKpKh/sUqYQihPCDV YbflAKSK5Ra8HWrb8cLyjawRLU88ODOZv9mZTVCEJ9dlGp4IQtN/Ih4mxs7JeaFECPS6a/EXN85eT UH4N7XUQAHie+0LhlWs7ky5Zf2jV2zZbrrkDYBCYt2JgikFw2CWROy1QklmRUrODXHSWzW0xa1P+y d3nR/NTlL56udnW/gse3ISPZx/lbabwcGY+QcgXBFKFrCW91eBzEG3gYBLMKVqxbIEzE2obC81/pr VuudzgPA==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vUsZn-00000002iOd-3P2v; Sun, 14 Dec 2025 20:20:20 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , =?UTF-8?q?Ville=20Syrj=C3=A4l=C3=A4?= , Jani Nikula , intel-gfx@lists.freedesktop.org, intel-xe@lists.freedesktop.org Subject: [PATCH] iopoll: fix parameter names in kernel-doc Date: Sun, 14 Dec 2025 12:20:16 -0800 Message-ID: <20251214202016.2198503-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.52.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Correct the parameter names to avoid kernel-doc warnings: Warning: include/linux/iopoll.h:169 function parameter 'sleep_us' not described in 'read_poll_timeout_atomic' Warning: ../include/linux/iopoll.h:169 function parameter 'sleep_before_read' not described in 'read_poll_timeout_atomic' Fixes: 9df8043a546d ("iopoll: Generalize read_poll_timeout() into poll_time= out_us()") Signed-off-by: Randy Dunlap --- Cc: Ville Syrj=C3=A4l=C3=A4 Cc: Jani Nikula Cc: intel-gfx@lists.freedesktop.org Cc: intel-xe@lists.freedesktop.org --- include/linux/iopoll.h | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) --- linux-next-20251201.orig/include/linux/iopoll.h +++ linux-next-20251201/include/linux/iopoll.h @@ -150,16 +150,16 @@ * @op: accessor function (takes @args as its arguments) * @val: Variable to read the value into * @cond: Break condition (usually involving @val) - * @delay_us: Time to udelay between reads in us (0 tight-loops). Please + * @sleep_us: Time to udelay between reads in us (0 tight-loops). Please * read udelay() function description for details and * limitations. * @timeout_us: Timeout in us, 0 means never timeout - * @delay_before_read: if it is true, delay @delay_us before read. + * @sleep_before_read: if it is true, delay @sleep_us before read. * @args: arguments for @op poll * * This macro does not rely on timekeeping. Hence it is safe to call even= when * timekeeping is suspended, at the expense of an underestimation of wall = clock - * time, which is rather minimal with a non-zero delay_us. + * time, which is rather minimal with a non-zero @sleep_us. * * When available, you'll probably want to use one of the specialized * macros defined below rather than this macro directly.