From: Jann Horn Date: Mon, 21 Jul 2025 17:09:55 +0000 (+0200) Subject: eventpoll: fix sphinx documentation build warning X-Git-Tag: v6.16.1~594 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d9536ff04b328a9de89efbc1a677e706239a9381;p=thirdparty%2Fkernel%2Fstable.git eventpoll: fix sphinx documentation build warning [ Upstream commit ecb6cc0fd8cd2d34b983e118aa61dd8c9b052d0d ] Sphinx complains that ep_get_upwards_depth_proc() has a kerneldoc-style comment without documenting its parameters. This is an internal function that was not meant to show up in kernel documentation, so fix the warning by changing the comment to a non-kerneldoc one. Fixes: 22bacca48a17 ("epoll: prevent creating circular epoll structures") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/r/20250717173655.10ecdce6@canb.auug.org.au Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202507171958.aMcW08Cn-lkp@intel.com/ Signed-off-by: Jann Horn Link: https://lore.kernel.org/20250721-epoll-sphinx-fix-v1-1-b695c92bf009@google.com Tested-by: Randy Dunlap Acked-by: Randy Dunlap Signed-off-by: Christian Brauner Signed-off-by: Sasha Levin --- diff --git a/fs/eventpoll.c b/fs/eventpoll.c index 7a7b044daadc4..b22d6f819f782 100644 --- a/fs/eventpoll.c +++ b/fs/eventpoll.c @@ -2190,9 +2190,7 @@ static int ep_loop_check_proc(struct eventpoll *ep, int depth) return result; } -/** - * ep_get_upwards_depth_proc - determine depth of @ep when traversed upwards - */ +/* ep_get_upwards_depth_proc - determine depth of @ep when traversed upwards */ static int ep_get_upwards_depth_proc(struct eventpoll *ep, int depth) { int result = 0;