[kbuild-all] Re: [RFC] scripts: kernel-doc: improve parsing for kernel-doc comments syntax

Hi Aditya, [FYI, it's a private test report for your RFC patch.] [auto build test WARNING on lwn/docs-next] [also build test WARNING on next-20210414] [cannot apply to linus/master v5.12-rc7] [If your patch is applied to the wrong git tree, kindly drop us a note. And when submitting patch, we suggest to use '--base' as documented in https://git-scm.com/docs/git-format-patch] url: https://github.com/0day-ci/linux/commits/Aditya-Srivastava/scripts-kernel... base: git://git.lwn.net/linux-2.6 docs-next config: i386-randconfig-s001-20210414 (attached as .config) compiler: gcc-9 (Debian 9.3.0-22) 9.3.0 reproduce: # apt-get install sparse # sparse version: v0.6.3-280-g2cd6d34e-dirty # https://github.com/0day-ci/linux/commit/1ce0c4f2c165f733b954591dbf5b31c83... git remote add linux-review https://github.com/0day-ci/linux git fetch --no-tags linux-review Aditya-Srivastava/scripts-kernel-doc-improve-parsing-for-kernel-doc-comments-syntax/20210415-032651 git checkout 1ce0c4f2c165f733b954591dbf5b31c834eb0da7 # save the attached .config to linux build tree make W=1 C=1 CF='-fdiagnostic-prefix -D__CHECK_ENDIAN__' W=1 ARCH=i386 If you fix the issue, kindly add following tag as appropriate Reported-by: kernel test robot <lkp(a)intel.com&gt; All warnings (new ones prefixed by >>): drivers/xen/xenbus/xenbus_client.c:134: warning: Function parameter or member 'will_handle' not described in 'xenbus_watch_path' drivers/xen/xenbus/xenbus_client.c:177: warning: Function parameter or member 'will_handle' not described in 'xenbus_watch_pathfmt' drivers/xen/xenbus/xenbus_client.c:350: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Equivalent to xenbus_dev_fatal(dev, err, fmt, args), but helps drivers/xen/xenbus/xenbus_client.c:414: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Allocate an event channel for the given xenbus_device, assigning the newly drivers/xen/xenbus/xenbus_client.c:443: warning: Function parameter or member 'dev' not described in 'xenbus_free_evtchn' drivers/xen/xenbus/xenbus_client.c:443: warning: Function parameter or member 'port' not described in 'xenbus_free_evtchn' vim +443 drivers/xen/xenbus/xenbus_client.c 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 437 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 438 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 439 /** 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 440 * Free an existing event channel. Returns 0 on success or -errno on error. 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 441 */ 0102e4efda76d0 Yan Yankovskyi 2020-03-23 442 int xenbus_free_evtchn(struct xenbus_device *dev, evtchn_port_t port) 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 @443 { 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 444 struct evtchn_close close; 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 445 int err; 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 446 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 447 close.port = port; 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 448 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 449 err = HYPERVISOR_event_channel_op(EVTCHNOP_close, &close); 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 450 if (err) 0102e4efda76d0 Yan Yankovskyi 2020-03-23 451 xenbus_dev_error(dev, err, "freeing event channel %u", port); 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 452 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 453 return err; 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 454 } 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 455 EXPORT_SYMBOL_GPL(xenbus_free_evtchn); 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 456 4bac07c993d034 Jeremy Fitzhardinge 2007-07-17 457 --- 0-DAY CI Kernel Test Service, Intel Corporation https://lists.01.org/hyperkitty/list/kbuild-all@lists.01.org