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

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>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <201608270025.G9i2Vx1s%fengguang.wu@intel.com>
Date:   Sat, 27 Aug 2016 00:07:40 +0800
From:   kbuild test robot <lkp@...el.com>
To:     Jonathan Corbet <corbet@....net>
Cc:     kbuild-all@...org, linux-doc@...r.kernel.org,
        LKML <linux-kernel@...r.kernel.org>,
        Mauro Carvalho Chehab <mchehab@...pensource.com>,
        Markus Heiser <markus.heiser@...marit.de>,
        Jani Nikula <jani.nikula@...el.com>
Subject: Re: [PATCH] docs: make kernel-doc handle varargs properly

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@...e.de>
:::::: CC: Takashi Iwai <tiwai@...e.de>

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

Download attachment ".config.gz" of type "application/octet-stream" (6422 bytes)