drivers/bluetooth/btrsi.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

drivers/bluetooth/btrsi.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[kernel test robot]

[-- Attachment #1: Type: text/plain, Size: 4024 bytes --]

Hi Aditya,

FYI, the error/warning still remains.

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   6efb943b8616ec53a5e444193dccf1af9ad627b5
commit: 3e58e839150db0857dfcb3a0bb3d4af4c6ac1abf scripts: kernel-doc: add warning for comment not following kernel-doc syntax
date:   6 weeks ago
config: alpha-randconfig-r013-20210510 (attached as .config)
compiler: alpha-linux-gcc (GCC) 9.3.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/torvalds/linux.git/commit/?id=3e58e839150db0857dfcb3a0bb3d4af4c6ac1abf
        git remote add linus https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
        git fetch --no-tags linus master
        git checkout 3e58e839150db0857dfcb3a0bb3d4af4c6ac1abf
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=gcc-9.3.0 make.cross W=1 ARCH=alpha 

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

All warnings (new ones prefixed by >>):

>> drivers/bluetooth/btrsi.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Copyright (c) 2017 Redpine Signals Inc.


vim +2 drivers/bluetooth/btrsi.c

38aa4da504837b Prameela Rani Garnepudi 2018-02-27  @2   * Copyright (c) 2017 Redpine Signals Inc.
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   3   *
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   4   * Permission to use, copy, modify, and/or distribute this software for any
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   5   * purpose with or without fee is hereby granted, provided that the above
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   6   * copyright notice and this permission notice appear in all copies.
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   7   *
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   8   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
38aa4da504837b Prameela Rani Garnepudi 2018-02-27   9   * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  10   * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  11   * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  12   * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  13   * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  14   * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  15   */
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  16  #include <linux/module.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  17  #include <linux/kernel.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  18  #include <net/bluetooth/bluetooth.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  19  #include <net/bluetooth/hci_core.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  20  #include <asm/unaligned.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  21  #include <net/rsi_91x.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  22  #include <net/genetlink.h>
38aa4da504837b Prameela Rani Garnepudi 2018-02-27  23  

:::::: The code at line 2 was first introduced by commit
:::::: 38aa4da504837ba8b9c04941e843642f129661eb Bluetooth: btrsi: add new rsi bluetooth driver

:::::: TO: Prameela Rani Garnepudi <prameela.j04cs@gmail.com>
:::::: CC: Kalle Valo <kvalo@codeaurora.org>

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

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 28905 bytes --]