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

From: kernel test robot
Date: Mon Sep 27 2021 - 12:36:58 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 92477dd1faa650e50bd3bb35a6c0b8d09198cc35
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 scripts: kernel-doc: improve parsing for kernel-doc comments syntax
date: 6 months ago
config: openrisc-buildonly-randconfig-r006-20210927 (attached as .config)
compiler: or1k-linux-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/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=gcc-11.2.0 make.cross ARCH=openrisc

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/bluetooth/btmrvl_main.c:2: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Marvell Bluetooth driver
--
drivers/clocksource/timer-cadence-ttc.c:78: warning: Function parameter or member 'clk_rate_change_nb' not described in 'ttc_timer'
drivers/clocksource/timer-cadence-ttc.c:157: warning: Function parameter or member 'cs' not described in '__ttc_clocksource_read'
>> drivers/clocksource/timer-cadence-ttc.c:193: warning: expecting prototype for ttc_set_{shutdown|oneshot|periodic}(). Prototype was for ttc_shutdown() instead
--
>> drivers/extcon/extcon-usb-gpio.c:23: warning: expecting prototype for drivers/extcon/extcon-usb-gpio.c(). Prototype was for USB_GPIO_DEBOUNCE_MS() instead
--
>> drivers/clk/imx/clk-pllv1.c:12: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* pll v1
--
>> drivers/mailbox/hi3660-mailbox.c:47: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Hi3660 mailbox channel information
drivers/mailbox/hi3660-mailbox.c:62: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Hi3660 mailbox controller data
--
>> drivers/most/most_cdev.c:301: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Initialization of struct file_operations
drivers/most/most_cdev.c:414: warning: Function parameter or member 'args' not described in 'comp_probe'
--
>> drivers/phy/ti/phy-am654-serdes.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* PCIe SERDES driver for AM654x SoC
--
>> drivers/phy/ti/phy-j721e-wiz.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* Wrapper driver for SERDES used in J721E
--
drivers/video/backlight/ili922x.c:85: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
* START_BYTE(id, rs, rw)
>> drivers/video/backlight/ili922x.c:118: warning: expecting prototype for CHECK_FREQ_REG(spi_device s, spi_transfer x)(). Prototype was for CHECK_FREQ_REG() instead
--
lib/zstd/zstd_common.c:33: warning: Function parameter or member 'stack' not described in 'stack_push'
lib/zstd/zstd_common.c:33: warning: Function parameter or member 'size' not described in 'stack_push'
>> lib/zstd/zstd_common.c:33: warning: expecting prototype for Copyright (c) 2016(). Prototype was for stack_push() instead
--
>> lib/zstd/decompress.c:26: warning: expecting prototype for Copyright (c) 2016(). Prototype was for ZSTD_MAXWINDOWSIZE_DEFAULT() instead


vim +2 drivers/bluetooth/btmrvl_main.c

132ff4e5fa8dfb Bing Zhao 2009-06-02 @2 * Marvell Bluetooth driver
132ff4e5fa8dfb Bing Zhao 2009-06-02 3 *
132ff4e5fa8dfb Bing Zhao 2009-06-02 4 * Copyright (C) 2009, Marvell International Ltd.
132ff4e5fa8dfb Bing Zhao 2009-06-02 5 *
132ff4e5fa8dfb Bing Zhao 2009-06-02 6 * This software file (the "File") is distributed by Marvell International
132ff4e5fa8dfb Bing Zhao 2009-06-02 7 * Ltd. under the terms of the GNU General Public License Version 2, June 1991
132ff4e5fa8dfb Bing Zhao 2009-06-02 8 * (the "License"). You may use, redistribute and/or modify this File in
132ff4e5fa8dfb Bing Zhao 2009-06-02 9 * accordance with the terms and conditions of the License, a copy of which
132ff4e5fa8dfb Bing Zhao 2009-06-02 10 * is available by writing to the Free Software Foundation, Inc.,
132ff4e5fa8dfb Bing Zhao 2009-06-02 11 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the
132ff4e5fa8dfb Bing Zhao 2009-06-02 12 * worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
132ff4e5fa8dfb Bing Zhao 2009-06-02 13 *
132ff4e5fa8dfb Bing Zhao 2009-06-02 14 *
132ff4e5fa8dfb Bing Zhao 2009-06-02 15 * THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE
132ff4e5fa8dfb Bing Zhao 2009-06-02 16 * IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
132ff4e5fa8dfb Bing Zhao 2009-06-02 17 * ARE EXPRESSLY DISCLAIMED. The License provides additional details about
132ff4e5fa8dfb Bing Zhao 2009-06-02 18 * this warranty disclaimer.
132ff4e5fa8dfb Bing Zhao 2009-06-02 19 **/
132ff4e5fa8dfb Bing Zhao 2009-06-02 20

:::::: The code at line 2 was first introduced by commit
:::::: 132ff4e5fa8dfb71a7d99902f88043113947e972 Bluetooth: Add btmrvl driver for Marvell Bluetooth devices

:::::: TO: Bing Zhao <bzhao@xxxxxxxxxxx>
:::::: CC: Marcel Holtmann <marcel@xxxxxxxxxxxx>

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

Attachment: .config.gz
Description: application/gzip