Re: [PATCH] docs: make kernel-doc handle varargs properly

[kbuild test robot]

Hi Jonathan,

[auto build test WARNING on linus/master]
[also build test WARNING on v4.8-rc3 next-20160825]
[if your patch is applied to the wrong git tree, please drop us a note to help improve the system]
[Suggest to use git(>=2.9.0) format-patch --base=<commit> (or --base=auto for convenience) to record what (public, well-known) commit your patch series was built on]
[Check https://git-scm.com/docs/git-format-patch for more information]

url:    https://github.com/0day-ci/linux/commits/Jonathan-Corbet/docs-make-kernel-doc-handle-varargs-properly/20160826-213158
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   include/sound/compress_driver.h:162: warning: No description found for parameter 'id[64]'
   include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_root'
   include/sound/compress_driver.h:162: warning: No description found for parameter 'proc_info_entry'
>> include/sound/core.h:323: warning: No description found for parameter '...'
   include/sound/core.h:334: warning: No description found for parameter '...'
   include/sound/core.h:387: warning: No description found for parameter '...'
--
   include/linux/init.h:1: warning: no structured comments found
   kernel/sched/core.c:2082: warning: No description found for parameter 'cookie'
>> include/linux/workqueue.h:391: warning: No description found for parameter '...'
>> include/linux/workqueue.h:391: warning: Excess function parameter 'args' description in 'alloc_workqueue'
   include/linux/workqueue.h:412: warning: No description found for parameter '...'
>> include/linux/workqueue.h:412: warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue'
   kernel/sys.c:1: warning: no structured comments found
   include/linux/fence.h:85: warning: Excess struct/union/enum/typedef member 'child_list' description in 'fence'
   include/linux/fence.h:85: warning: Excess struct/union/enum/typedef member 'active_list' description in 'fence'
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   drivers/dma-buf/fence-array.c:124: warning: No description found for parameter 'signal_on_any'
>> include/sound/core.h:323: warning: No description found for parameter '...'
   include/sound/core.h:334: warning: No description found for parameter '...'
   include/sound/core.h:387: warning: No description found for parameter '...'

vim +323 include/sound/core.h

b9075fa96 Joe Perches    2011-10-31  307  __printf(4, 5)
36ce99c1d Takashi Iwai   2009-08-27  308  void __snd_printk(unsigned int level, const char *file, int line,
b9075fa96 Joe Perches    2011-10-31  309  		  const char *format, ...);
36ce99c1d Takashi Iwai   2009-08-27  310  #else
36ce99c1d Takashi Iwai   2009-08-27  311  #define __snd_printk(level, file, line, format, args...) \
cf0baf16c Takashi Iwai   2009-08-28  312  	printk(format, ##args)
36ce99c1d Takashi Iwai   2009-08-27  313  #endif
36ce99c1d Takashi Iwai   2009-08-27  314  
^1da177e4 Linus Torvalds 2005-04-16  315  /**
^1da177e4 Linus Torvalds 2005-04-16  316   * snd_printk - printk wrapper
^1da177e4 Linus Torvalds 2005-04-16  317   * @fmt: format string
^1da177e4 Linus Torvalds 2005-04-16  318   *
f66fcedc8 Takashi Iwai   2008-11-07  319   * Works like printk() but prints the file and the line of the caller
^1da177e4 Linus Torvalds 2005-04-16  320   * when configured with CONFIG_SND_VERBOSE_PRINTK.
^1da177e4 Linus Torvalds 2005-04-16  321   */
^1da177e4 Linus Torvalds 2005-04-16  322  #define snd_printk(fmt, args...) \
36ce99c1d Takashi Iwai   2009-08-27 @323  	__snd_printk(0, __FILE__, __LINE__, fmt, ##args)
^1da177e4 Linus Torvalds 2005-04-16  324  
^1da177e4 Linus Torvalds 2005-04-16  325  #ifdef CONFIG_SND_DEBUG
^1da177e4 Linus Torvalds 2005-04-16  326  /**
^1da177e4 Linus Torvalds 2005-04-16  327   * snd_printd - debug printk
0863afb32 Martin Waitz   2006-01-09  328   * @fmt: format string
^1da177e4 Linus Torvalds 2005-04-16  329   *
edab938e6 Pavel Machek   2008-04-01  330   * Works like snd_printk() for debugging purposes.
^1da177e4 Linus Torvalds 2005-04-16  331   * Ignored when CONFIG_SND_DEBUG is not set.

:::::: The code at line 323 was first introduced by commit
:::::: 36ce99c1dcab2978fc1900f19b431adedd8f99f6 ALSA: Add debug module option

:::::: TO: Takashi Iwai <tiwai@xxxxxxx>
:::::: CC: Takashi Iwai <tiwai@xxxxxxx>

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation

Attachment: .config.gz
Description: Binary data