From nobody Thu Apr 9 18:55:17 2026 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 901EE229B32 for ; Fri, 6 Mar 2026 06:38:31 +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=1772779112; cv=none; b=qqKUPiDJPAyZ8JN0O3dYoHEkPaHFMygKHTm/5RwS5PAaT7KZGYnZHCKKColfJ7j2VCdX6pPkVZ7/RqQ8gSlm0UxCooG6xIJYTtxc+pV5XQQAfD5EvDEOueu/ekYkEgp8ZrLrlOTZXGdO4qG9hqmt3JIzaEdWRBqD93N8S4E9Ibk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772779112; c=relaxed/simple; bh=xwzRa5RwPy4qAPoIufFQJ3kAFx7Xcokv+F3G465M9yE=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=hMTXzQcIPPLjWf66+OZX+mOaIbbllLP9/m8t/nUc9mmwvy0DNk1yQjyaFZzeWBXlHPuCfAQ4N1qNjFqcYbz8xY4MvMILwcSJz5ZaYAqrXLST26+CS4VqLoTOAF6OMvaRb32Q1sahX1mjAzA3dtwKXD0Wa1CCKWpUh2u1r/jityY= 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=2LrXzz8S; 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="2LrXzz8S" 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=N6JF6akKTgGQUfxwJ2K/2O5MySpDS3xJAr2YonSNocM=; b=2LrXzz8SHGuEjpFMinvqjI+sjJ YK4HusXfLEW0/nuUWrnMivTlZswel+D2Sl2S1vKakYU5UNxvK85r8OQl+FNydIYKP13FnbuZde3fc kXlnSbANk0gXubA/XIaFI3iSNMUFmhIlip9rWFglX4+/fdyQyEpbDCqMHgyAU8thsJHtP3sWpwoLY ZRPjH5NdLo3pRCmfRuKyOvNH869lQYLIZPWcN/20GuVz0xjs2AkqaUS8NQrsd5ZFf0LyvlNFx7NOP OYwvRgkJ+TpHfGz7fYGCOUQnyXant3u4iaOTYtZDA961B6piezMofZOy0m0drpT4epNb5hiudp7+m o8ufXftA==; 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 1vyOpS-000000035is-1IiL; Fri, 06 Mar 2026 06:38:30 +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 RESEND] iopoll: fix parameter names in kernel-doc Date: Thu, 5 Mar 2026 22:38:28 -0800 Message-ID: <20260306063829.2059375-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.53.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-20260304.orig/include/linux/iopoll.h +++ linux-next-20260304/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.