| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <e630bf98-05df-4809-9f78-d10abfd075d8@kernel.org> Date: Thu, 5 Feb 2026 17:42:24 +0100 From: Matthieu Baerts <matttbe@...nel.org> To: Jakub Kicinski <kuba@...nel.org> Cc: Mat Martineau <martineau@...nel.org>, Geliang Tang <geliang@...nel.org>, "David S. Miller" <davem@...emloft.net>, Eric Dumazet <edumazet@...gle.com>, Paolo Abeni <pabeni@...hat.com>, Simon Horman <horms@...nel.org>, Shuah Khan <shuah@...nel.org>, netdev@...r.kernel.org, mptcp@...ts.linux.dev, linux-kernel@...r.kernel.org, linux-kselftest@...r.kernel.org Subject: Re: [PATCH net 3/4] mptcp: fix kdoc warnings Hi Jakub, 05 Feb 2026 16:56:08 Jakub Kicinski <kuba@...nel.org>: > On Thu, 5 Feb 2026 11:56:39 +0100 Matthieu Baerts wrote: >>> diff --git a/include/uapi/linux/mptcp_pm.h b/include/uapi/linux/mptcp_pm.h >>> index c97d060ee90b..fe9863d75350 100644 >>> --- a/include/uapi/linux/mptcp_pm.h >>> +++ b/include/uapi/linux/mptcp_pm.h >>> @@ -11,7 +11,7 @@ >>> #define MPTCP_PM_VER 1 >>> >>> /** >>> - * enum mptcp_event_type >>> + * enum mptcp_event_type - Netlink MPTCP event types >> >> I forgot that this file was auto-generated from a YAML file. >> >> Sorry for the noise, I will send a v2 also adapting the YAML file. > > Hm, do we need some clever way to teach the codegen about short > descriptions? In my case, there was no "doc" for this enum: https://lore.kernel.org/20260205-mptcp-fix-kdoc-yml-v1-1-9858c4b7baf6@kernel.org Adding it fixes the kdoc warning. Do you mean that the codegen should add a short description even if "doc" is not set? Cheers, Matt
Powered by blists - more mailing lists