[linux-next:master 1819/1905] htmldocs: ./security/landlock/ruleset.h:287: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[linux-next:master 1819/1905] htmldocs: ./security/landlock/ruleset.h:287: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
head:   eff99d8edbed7918317331ebd1e365d8e955d65e
commit: f3672f581e951204d0ff4570a04daef1b81e182c [1819/1905] landlock: Add IOCTL access right
reproduce: (https://download.01.org/0day-ci/archive/20231117/202311172010.AfFjwTiU-lkp@intel.com/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202311172010.AfFjwTiU-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> ./security/landlock/ruleset.h:287: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

vim +287 ./security/landlock/ruleset.h

   285	
   286	/**
 > 287	 * Returns @access with the synthetic IOCTL group flags enabled if necessary.
   288	 *
   289	 * @handled: Handled FS access rights.
   290	 * @access:  FS access rights to expand.
   291	 *
   292	 * Returns:
   293	 * @access expanded by the necessary flags for the synthetic IOCTL access rights.
   294	 */
   295	static inline access_mask_t expand_all_ioctl(access_mask_t handled,
   296						     access_mask_t access)
   297	{
   298		return access |
   299		       expand_ioctl(handled, access, LANDLOCK_ACCESS_FS_WRITE_FILE,
   300				    IOCTL_CMD_G1 | IOCTL_CMD_G2 | IOCTL_CMD_G4) |
   301		       expand_ioctl(handled, access, LANDLOCK_ACCESS_FS_READ_FILE,
   302				    IOCTL_CMD_G1 | IOCTL_CMD_G2 | IOCTL_CMD_G3) |
   303		       expand_ioctl(handled, access, LANDLOCK_ACCESS_FS_READ_DIR,
   304				    IOCTL_CMD_G1);
   305	}
   306	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki