[linux-next:master 9893/10090] drivers/hid/hid-thrustmaster.c:3: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

Hi Stephen,

First bad commit (maybe != root cause):

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master
head:   9c54130cd25528028b2d38f6ada0c79e92210390
commit: 4a55fb864f87cabddd417181e6542bd1d90fe179 [9893/10090] Merge remote-tracking branch 'jc_docs/docs-next'
config: x86_64-randconfig-a001-20210326 (attached as .config)
compiler: clang version 13.0.0 (https://github.com/llvm/llvm-project a46f59a747a7273cc439efaf3b4f98d8b63d2f20)
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
        # install x86_64 cross compiling tool for clang build
        # apt-get install binutils-x86-64-linux-gnu
        # https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?id=4a55fb864f87cabddd417181e6542bd1d90fe179
        git remote add linux-next https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git
        git fetch --no-tags linux-next master
        git checkout 4a55fb864f87cabddd417181e6542bd1d90fe179
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross ARCH=x86_64 

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <redacted>

All warnings (new ones prefixed by >>):

quoted

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

    * When connected to the machine, the Thrustmaster wheels appear as
   drivers/hid/hid-thrustmaster.c:26: warning: cannot understand function prototype: 'const u8 setup_0[] = '
   drivers/hid/hid-thrustmaster.c:49: warning: cannot understand function prototype: 'struct tm_wheel_info '
   drivers/hid/hid-thrustmaster.c:62: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Known wheels.
   drivers/hid/hid-thrustmaster.c:76: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * This structs contains (in little endian) the response data
   drivers/hid/hid-thrustmaster.c:143: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * On some setups initializing the T300RS crashes the kernel,
   drivers/hid/hid-thrustmaster.c:202: warning: Function parameter or member 'urb' not described in 'thrustmaster_model_handler'
   drivers/hid/hid-thrustmaster.c:202: warning: expecting prototype for Called by the USB subsystem when the wheel responses to our request(). Prototype was for thrustmaster_model_handler() instead
   drivers/hid/hid-thrustmaster.c:265: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Function called by HID when a hid Thrustmaster FFB wheel is connected to the host.


vim +3 drivers/hid/hid-thrustmaster.c

c49c33637802a2 Dario Pagani 2021-01-31  @3   * When connected to the machine, the Thrustmaster wheels appear as
c49c33637802a2 Dario Pagani 2021-01-31   4   * a «generic» hid gamepad called "Thrustmaster FFB Wheel".
c49c33637802a2 Dario Pagani 2021-01-31   5   *
c49c33637802a2 Dario Pagani 2021-01-31   6   * When in this mode not every functionality of the wheel, like the force feedback,
c49c33637802a2 Dario Pagani 2021-01-31   7   * are available. To enable all functionalities of a Thrustmaster wheel we have to send
c49c33637802a2 Dario Pagani 2021-01-31   8   * to it a specific USB CONTROL request with a code different for each wheel.
c49c33637802a2 Dario Pagani 2021-01-31   9   *
c49c33637802a2 Dario Pagani 2021-01-31  10   * This driver tries to understand which model of Thrustmaster wheel the generic
c49c33637802a2 Dario Pagani 2021-01-31  11   * "Thrustmaster FFB Wheel" really is and then sends the appropriate control code.
c49c33637802a2 Dario Pagani 2021-01-31  12   *
c49c33637802a2 Dario Pagani 2021-01-31  13   * Copyright (c) 2020-2021 Dario Pagani [off-list ref]
c49c33637802a2 Dario Pagani 2021-01-31  14   * Copyright (c) 2020-2021 Kim Kuparinen [off-list ref]
c49c33637802a2 Dario Pagani 2021-01-31  15   */
c49c33637802a2 Dario Pagani 2021-01-31  16  #include <linux/hid.h>
c49c33637802a2 Dario Pagani 2021-01-31  17  #include <linux/usb.h>
c49c33637802a2 Dario Pagani 2021-01-31  18  #include <linux/input.h>
c49c33637802a2 Dario Pagani 2021-01-31  19  #include <linux/slab.h>
c49c33637802a2 Dario Pagani 2021-01-31  20  #include <linux/module.h>
c49c33637802a2 Dario Pagani 2021-01-31  21  

:::::: The code at line 3 was first introduced by commit
:::::: c49c33637802a2c6957a78119eb8be3b055dd9e9 HID: support for initialization of some Thrustmaster wheels

:::::: TO: Dario Pagani [off-list ref]
:::::: CC: Jiri Kosina [off-list ref]

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