From nobody Sun Feb 8 16:53:25 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 1EFC63168F1; Fri, 23 Jan 2026 07:40:57 +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=1769154059; cv=none; b=XiUp+rEw9DPh8/lC1ITVpgaIf2STeIDaNqoAXVr0MURljk9AUpxVt43qZbtG4xoSmZsbeyGUit9bbY9mOI+nM3tLh/JCy8s7+iSyN3VcpdfbFV3/SVRQrvnaHemUGbcRgQ8SI/jnpMBjgF7J3/7zyfuWzcd8lj5hruDd2w4/3Jc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769154059; c=relaxed/simple; bh=9IGNDlLd9+jtX5x92W92Wl3+VxxnLQ1STaFbGHAlxf8=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=MoI+d2YTcC4hfqaFi4jzs0PR38h8jZxibOPtE11pNmLDv85605hcBmHZud1L8TAnFmmJGVBkq5Qd9shtQEI81zJmNcVRnxjcPrxCwZCtOqWB+ASag9egsR86NN9WeURVkQFFaehQIWDukFiI2ARQs/pzvMKX4hcYyEnIAWDIBOs= 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=BjOso4F9; 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="BjOso4F9" 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=F8ZCLpVna+xpAcsE4nXLu6X6jf3LvcqAxXch9kFrxAQ=; b=BjOso4F9/d4fjJqrLxlEyusP8t rc71A3ptfD8hve91fd6PTCggQyawCFYYDV5e2w/CfZXsIZuib9RK+qShP7NrWMWgzkBI+cYjIXey9 BOtBvbPSnOdzmgM7TobSJSCvKvqhWaOM+S39MBTnhzoHt28thzVnOnr35KGGT4zB7T//yUNjWBvaD E3zDlJ1aeqUtUgu329JijvVGyGGYcIQmjEAJ7+V7FC6IXcIzkEPPGE+oAccgmq8eERwXzk8FAEagO BEBcEm7GNm/4LDEyaeL3lDMqYSuz4eh5j1fD+FfcVAfRz8K0B2dHeBM5y46S5X6G7i4yUPVYoQF3S A1Pn+lSw==; 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 1vjBmk-00000008NyQ-249c; Fri, 23 Jan 2026 07:40:50 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Stephen Rothwell , Mauro Carvalho Chehab , Jonathan Corbet , Shuah Khan , Mauro Carvalho Chehab , linux-doc@vger.kernel.org, Peter Zijlstra , Marco Elver Subject: [PATCH] docs: kdoc_parser: ignore __cond_acquires() Date: Thu, 22 Jan 2026 23:40:49 -0800 Message-ID: <20260123074049.3912065-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-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Drop "__cond_acquires(.*)" in function prototypes to avoid kernel-doc warnings. Documentation/core-api/kref:328: ../include/linux/kref.h:72: WARNING: Inval= id C declaration: Expected end of definition. [error at 96] int kref_put_mutex (struct kref *kref, void (*release)(struct kref *kref)= , struct mutex *mutex) __cond_acquires(true# mutex) -------------------------------------------------------------------------= -----------------------^ Documentation/core-api/kref:328: ../include/linux/kref.h:94: WARNING: Inval= id C declaration: Expected end of definition. [error at 92] int kref_put_lock (struct kref *kref, void (*release)(struct kref *kref),= spinlock_t *lock) __cond_acquires(true# lock) -------------------------------------------------------------------------= -------------------^ Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/all/20260107161548.45530e1c@canb.auug.org.a= u/ Signed-off-by: Randy Dunlap Reviewed-by: Mauro Carvalho Chehab --- The regex is suggested by Mauro; mine was too greedy. Thanks. Cc: Jonathan Corbet Cc: Shuah Khan Cc: Mauro Carvalho Chehab Cc: linux-doc@vger.kernel.org Cc: Peter Zijlstra Cc: Marco Elver tools/lib/python/kdoc/kdoc_parser.py | 1 + 1 file changed, 1 insertion(+) --- linux-next-20260121.orig/tools/lib/python/kdoc/kdoc_parser.py +++ linux-next-20260121/tools/lib/python/kdoc/kdoc_parser.py @@ -186,6 +186,7 @@ function_xforms =3D [ (KernRe(r"__sched +"), ""), (KernRe(r"_noprof"), ""), (KernRe(r"__always_unused *"), ""), + (KernRe(r"__cond_acquires\s*\([^\)]*\)"), ""), (KernRe(r"__printf\s*\(\s*\d*\s*,\s*\d*\s*\) +"), ""), (KernRe(r"__(?:re)?alloc_size\s*\(\s*\d+\s*(?:,\s*\d+\s*)?\) +"), ""), (KernRe(r"__diagnose_as\s*\(\s*\S+\s*(?:,\s*\d+\s*)*\) +"), ""),