[weiny2:fuad-mroth-2M 11/35] arch/x86/kvm/../../../virt/kvm/guest_memfd.c:778: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot <lkp@intel.com>]

tree:   https://github.com/weiny2/linux-kernel.git fuad-mroth-2M
head:   e7a0e768b14b70e6723b2800c0d108cf449c534e
commit: 20151d3e5ed777116e8ee5787115779b68afa70c [11/35] KVM: x86: Compute max_mapping_level with input from guest_memfd
config: x86_64-allyesconfig (https://download.01.org/0day-ci/archive/20250520/202505200432.4ITQ6uW3-lkp@intel.com/config)
compiler: clang version 20.1.2 (https://github.com/llvm/llvm-project 58df0ef89dd64126512e4ee27b4ac3fd8ddf6247)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20250520/202505200432.4ITQ6uW3-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/202505200432.4ITQ6uW3-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> arch/x86/kvm/../../../virt/kvm/guest_memfd.c:778: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Returns the mapping order for this @gfn in @slot.


vim +778 arch/x86/kvm/../../../virt/kvm/guest_memfd.c

   776	
   777	/**
 > 778	 * Returns the mapping order for this @gfn in @slot.
   779	 *
   780	 * This is equal to max_order that would be returned if kvm_gmem_get_pfn() were
   781	 * called now.
   782	 */
   783	int kvm_gmem_mapping_order(const struct kvm_memory_slot *slot, gfn_t gfn)
   784	{
   785		return 0;
   786	}
   787	EXPORT_SYMBOL_GPL(kvm_gmem_mapping_order);
   788	

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