[PATCH] capability: remove non-kernel-doc comments

Randy Dunlap <[email protected]> Thu, 23 Jul 2026 09:52:09 -0700
Newsgroups org.kernel.vger.linux-security-module
Message-ID <[email protected]>
Convert 2 "/**" comments to use plain C "/*" comment style to avoid
kernel-doc warnings:

Warning: include/uapi/linux/capability.h:114 expecting prototype for
 POSIX(). Prototype was for CAP_CHOWN() instead
Warning: include/uapi/linux/capability.h:175 expecting prototype for
 Linux(). Prototype was for CAP_SETPCAP() instead

Signed-off-by: Randy Dunlap <[email protected]>
---
Cc: Paul Moore <[email protected]>
Cc: James Morris <[email protected]>
Cc: "Serge E. Hallyn" <[email protected]>

 include/uapi/linux/capability.h |   12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

--- linux-next-20260722.orig/include/uapi/linux/capability.h
+++ linux-next-20260722/include/uapi/linux/capability.h
@@ -104,9 +104,9 @@ struct vfs_ns_cap_data {
 #endif
 
 
-/**
- ** POSIX-draft defined capabilities.
- **/
+/*
+ * POSIX-draft defined capabilities.
+ */
 
 /* In a system with the [_POSIX_CHOWN_RESTRICTED] option defined, this
    overrides the restriction of changing file ownership and group
@@ -159,9 +159,9 @@ struct vfs_ns_cap_data {
 #define CAP_SETUID           7
 
 
-/**
- ** Linux-specific capabilities
- **/
+/*
+ * Linux-specific capabilities
+ */
 
 /* Without VFS support for capabilities:
  *   Transfer any capability in your permitted set to any pid,