[soc:multiplatform-misc-5.18 6/13] arch/arm/mach-versatile/spc.c:231: 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/soc/soc.git multiplatform-misc-5.18
head:   a2677c00b0f03b8cad961f785941ca257f454df3
commit: 09f6b27d5ddd9ad0ec096d1b0f8decdacc70f0f8 [6/13] ARM: dove: multiplatform support
config: arm-allyesconfig (https://download.01.org/0day-ci/archive/20220406/202204061141.27Z9PAjf-lkp@intel.com/config)
compiler: arm-linux-gnueabi-gcc (GCC) 11.2.0
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # https://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git/commit/?id=09f6b27d5ddd9ad0ec096d1b0f8decdacc70f0f8
        git remote add soc https://git.kernel.org/pub/scm/linux/kernel/git/soc/soc.git
        git fetch --no-tags soc multiplatform-misc-5.18
        git checkout 09f6b27d5ddd9ad0ec096d1b0f8decdacc70f0f8
        # save the config file to linux build tree
        mkdir build_dir
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-11.2.0 make.cross O=build_dir ARCH=arm SHELL=/bin/bash

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp at intel.com>

All warnings (new ones prefixed by >>):

>> arch/arm/mach-versatile/spc.c:231: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster)


vim +231 arch/arm/mach-versatile/spc.c

33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  229  
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  230  /**
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25 @231   * ve_spc_cpu_in_wfi(u32 cpu, u32 cluster)
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  232   *
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  233   * @cpu: mpidr[7:0] bitfield describing CPU affinity level within cluster
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  234   * @cluster: mpidr[15:8] bitfield describing cluster affinity level
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  235   *
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  236   * @return: non-zero if and only if the specified CPU is in WFI
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  237   *
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  238   * Take care when interpreting the result of this function: a CPU might
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  239   * be in WFI temporarily due to idle, and is not necessarily safely
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  240   * parked.
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  241   */
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  242  int ve_spc_cpu_in_wfi(u32 cpu, u32 cluster)
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  243  {
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  244  	int ret;
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  245  	u32 mask = standbywfi_cpu_mask(cpu, cluster);
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  246  
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  247  	if (cluster >= MAX_CLUSTERS)
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  248  		return 1;
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  249  
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  250  	ret = readl_relaxed(info->baseaddr + STANDBYWFI_STAT);
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  251  
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  252  	pr_debug("%s: PCFGREG[0x%X] = 0x%08X, mask = 0x%X\n",
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  253  		 __func__, STANDBYWFI_STAT, ret, mask);
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  254  
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  255  	return ret & mask;
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  256  }
33cb667a00f841 arch/arm/mach-vexpress/spc.c Dave Martin 2013-11-25  257  

:::::: The code at line 231 was first introduced by commit
:::::: 33cb667a00f841fa036ad79f1aaaf7d6380c971d ARM: vexpress/TC2: Implement MCPM power_down_finish()

:::::: TO: Dave Martin <Dave.Martin at arm.com>
:::::: CC: Olof Johansson <olof at lixom.net>

-- 
0-DAY CI Kernel Test Service
https://01.org/lkp