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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202105102208.oJFfYsmT-lkp@intel.com>
Date:   Mon, 10 May 2021 22:20:16 +0800
From:   kernel test robot <lkp@...el.com>
To:     Aditya Srivastava <yashsri421@...il.com>
Cc:     kbuild-all@...ts.01.org, linux-kernel@...r.kernel.org,
        Jonathan Corbet <corbet@....net>, linux-doc@...r.kernel.org
Subject: drivers/bluetooth/btrsi.c:2: warning: This comment starts with
 '/**', but isn't a kernel-doc comment. Refer
 Documentation/doc-guide/kernel-doc.rst

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@...el.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@...il.com>
:::::: CC: Kalle Valo <kvalo@...eaurora.org>

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

Download attachment ".config.gz" of type "application/gzip" (28905 bytes)