All of lore.kernel.org
 help / color / mirror / Atom feed
From: kernel test robot <lkp@intel.com>
To: Aditya Srivastava <yashsri421@gmail.com>
Cc: kbuild-all@lists.01.org, linux-kernel@vger.kernel.org,
	Jonathan Corbet <corbet@lwn.net>,
	linux-doc@vger.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
Date: Mon, 10 May 2021 22:20:16 +0800	[thread overview]
Message-ID: <202105102208.oJFfYsmT-lkp@intel.com> (raw)

[-- 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 --]

WARNING: multiple messages have this Message-ID (diff)
From: kernel test robot <lkp@intel.com>
To: kbuild-all@lists.01.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
Date: Mon, 10 May 2021 22:20:16 +0800	[thread overview]
Message-ID: <202105102208.oJFfYsmT-lkp@intel.com> (raw)

[-- Attachment #1: Type: text/plain, Size: 4089 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(a)lists.01.org

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

             reply	other threads:[~2021-05-10 14:30 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-05-10 14:20 kernel test robot [this message]
2021-05-10 14:20 ` 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

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=202105102208.oJFfYsmT-lkp@intel.com \
    --to=lkp@intel.com \
    --cc=corbet@lwn.net \
    --cc=kbuild-all@lists.01.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=yashsri421@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.