linux-kernel - 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

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: <202109280054.0FNXac0V-lkp@intel.com>
Date:   Tue, 28 Sep 2021 00:36:02 +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/btmrvl_main.c:2: warning: This comment starts with
 '/**', but isn't a kernel-doc comment. Refer
 Documentation/doc-guide/kernel-doc.rst

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@...el.com>

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@...vell.com>
:::::: CC: Marcel Holtmann <marcel@...tmann.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" (34202 bytes)