drivers/irqchip/irq-mbigen.c:29: 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/torvalds/linux.git master
head:   a9c9a6f741cdaa2fa9ba24a790db8d07295761e3
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 scripts: kernel-doc: improve parsing for kernel-doc comments syntax
date:   5 months ago
config: arm64-buildonly-randconfig-r004-20210903 (attached as .config)
compiler: clang version 14.0.0 (https://github.com/llvm/llvm-project c9948e9254fbb6ea00f66c7b4542311d21e060be)
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
        # install arm64 cross compiling tool for clang build
        # apt-get install binutils-aarch64-linux-gnu
        # https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross ARCH=arm64 

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@xxxxxxxxx>

All warnings (new ones prefixed by >>):

>> drivers/irqchip/irq-mbigen.c:29: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * In mbigen vector register
   drivers/irqchip/irq-mbigen.c:43: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * offset of clear register in mbigen node
   drivers/irqchip/irq-mbigen.c:50: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * offset of interrupt type register


vim +29 drivers/irqchip/irq-mbigen.c

9650c60ebfec05 Ma Jun 2015-12-17  27  
9650c60ebfec05 Ma Jun 2015-12-17  28  /**
9650c60ebfec05 Ma Jun 2015-12-17 @29   * In mbigen vector register
9650c60ebfec05 Ma Jun 2015-12-17  30   * bit[21:12]:	event id value
9650c60ebfec05 Ma Jun 2015-12-17  31   * bit[11:0]:	device id
9650c60ebfec05 Ma Jun 2015-12-17  32   */
9650c60ebfec05 Ma Jun 2015-12-17  33  #define IRQ_EVENT_ID_SHIFT		12
9650c60ebfec05 Ma Jun 2015-12-17  34  #define IRQ_EVENT_ID_MASK		0x3ff
9650c60ebfec05 Ma Jun 2015-12-17  35  

:::::: The code at line 29 was first introduced by commit
:::::: 9650c60ebfec05fcf74d9b3eb97837501f2bb541 irqchip/mbigen: Create irq domain for each mbigen device

:::::: TO: Ma Jun <majun258@xxxxxxxxxx>
:::::: CC: Marc Zyngier <marc.zyngier@xxxxxxx>

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@xxxxxxxxxxxx

Attachment: .config.gz
Description: application/gzip