From nobody Thu Apr 16 07:09:39 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 454C61AF0BB for ; Mon, 2 Mar 2026 00:52:39 +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=1772412760; cv=none; b=Y/N+mN+nvmPfqO9GRhrnuCdUnKK0gYxgMw18Corebhrsbwri0lYfK08Vmdh1f4+sUqw/Vb+cWgTxGvQsGHxtfKIKqFU9tUSnWOi1XwxVveSx6gYF2/EloQ9YTRCp6C8R/Fu+3yBYHRev1R/DEJudKgfFtYJwkqu19VptnNRuk+c= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772412760; c=relaxed/simple; bh=b+017lsrQ/bJrE0jgWDwHsmlXs16Z0YzgeToashyplw=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=c5pWRRSMy1SbLWz4PBbXSTvrvN+QMKDRTolTyLCo/4hmEW2dm+qDmtAyyYMQ0xoez4sQpuCrVTvwlq3jOoPrRctkLC36bw9wRSgBJlRAIVg5sURptuF3JJew/Axg9+9nCHxwHjiUDsoDr1Dd8BVRO5e0Sxre7aggj4dAdrLNgQI= 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=pdkexLar; 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="pdkexLar" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=FUXWhR8TDzeyrLXWhia7ejl+RAyID4nLbD+jPk4FdZc=; b=pdkexLarp4OxJ7wbCR71Kwo+ic C/UJCiQH+Z1vifKwEBqL03VVd4usDX+dEOQEwO0vZ1TQ8O/wWqnTXqUeBQ11RevsMRhtveRBbBQlp 6QL5sFOhNUTHUhms6kgc1TnZJgHX7lvDi5CjCLst2BI0tvC6QV6gsIt8P03gVsWxEjwRTlS0XkYgG VIxcptkcJjKoCVmFKPiSsHFtII/G5jOsVslE4Bp1hwlCCmp7K6VCkj28dK2jieOGprWf03iPPPUCs cqR/u1lbPlrnoK/MTPwij2tmc1y6QoWRgy0DVyavbN22B1fQQ1GyUnMU80aaj2wIpn2xuXGWr4nI3 kl1jmLDw==; 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 1vwrWY-0000000C29J-25Yq; Mon, 02 Mar 2026 00:52:38 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Ingo Molnar , Peter Zijlstra Subject: [PATCH] sched/wait: correct kernel-doc descriptions Date: Sun, 1 Mar 2026 16:52:37 -0800 Message-ID: <20260302005237.3473095-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-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use the correct function name and function parameter name to avoid these kernel-doc warnings: Warning: include/linux/wait_bit.h:424 expecting prototype for wait_var_event_killable(). Prototype was for wait_var_event_interruptible() instead Warning: include/linux/wait_bit.h:508 function parameter 'lock' not described in 'wait_var_event_mutex' Signed-off-by: Randy Dunlap --- Cc: Ingo Molnar Cc: Peter Zijlstra include/linux/wait_bit.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) --- linux-next-20260227.orig/include/linux/wait_bit.h +++ linux-next-20260227/include/linux/wait_bit.h @@ -406,7 +406,7 @@ do { \ schedule()) =20 /** - * wait_var_event_killable - wait for a variable to be updated and notified + * wait_var_event_interruptible - wait for a variable to be updated and no= tified * @var: the address of variable being waited on * @condition: the condition to wait for * @@ -492,7 +492,7 @@ do { \ * wait_var_event_mutex - wait for a variable to be updated under a mutex * @var: the address of the variable being waited on * @condition: condition to wait for - * @mutex: the mutex which protects updates to the variable + * @lock: the mutex which protects updates to the variable * * Wait for a condition which can only be reliably tested while holding * a mutex. The variables assessed in the condition will normal be