Hi Aditya, Thank you for the patch! Perhaps something to improve: [auto build test WARNING on lwn/docs-next] [also build test WARNING on linus/master v5.12-rc5 next-20210329] [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-doc-add-warning-for-comment-not-following-kernel-doc-syntax/20210329-173213 base: git://git.lwn.net/linux-2.6 docs-next config: i386-tinyconfig (attached as .config) compiler: gcc-9 (Debian 9.3.0-22) 9.3.0 reproduce (this is a W=1 build): # https://github.com/0day-ci/linux/commit/274a7b0af9aa2846ed0a5b2096e07fe76e47fe29 git remote add linux-review https://github.com/0day-ci/linux git fetch --no-tags linux-review Aditya-Srivastava/scripts-kernel-doc-add-warning-for-comment-not-following-kernel-doc-syntax/20210329-173213 git checkout 274a7b0af9aa2846ed0a5b2096e07fe76e47fe29 # save the attached .config to linux build tree make W=1 ARCH=i386 If you fix the issue, kindly add following tag as appropriate Reported-by: kernel test robot <lkp@xxxxxxxxx> All warnings (new ones prefixed by >>): >> arch/x86/kernel/i8259.c:234: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * ELCR registers (0x4d0, 0x4d1) control edge/level of IRQ -- >> arch/x86/lib/cmdline.c:17: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Find a boolean option (like quiet,noapic,nosmp....) -- arch/x86/lib/msr.c:40: warning: expecting prototype for Read an MSR with error handling(). Prototype was for msr_read() instead arch/x86/lib/msr.c:58: warning: expecting prototype for Write an MSR with error handling(). Prototype was for msr_write() instead >> arch/x86/lib/msr.c:91: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Set @bit in a MSR @msr. arch/x86/lib/msr.c:104: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Clear @bit in a MSR @msr. vim +234 arch/x86/kernel/i8259.c 4305df947ca1fd Thomas Gleixner 2010-09-28 231 21fd5132b223a1 Pavel Machek 2008-05-21 232 static char irq_trigger[2]; 21fd5132b223a1 Pavel Machek 2008-05-21 233 /** 21fd5132b223a1 Pavel Machek 2008-05-21 @234 * ELCR registers (0x4d0, 0x4d1) control edge/level of IRQ 21fd5132b223a1 Pavel Machek 2008-05-21 235 */ 21fd5132b223a1 Pavel Machek 2008-05-21 236 static void restore_ELCR(char *trigger) 21fd5132b223a1 Pavel Machek 2008-05-21 237 { 21fd5132b223a1 Pavel Machek 2008-05-21 238 outb(trigger[0], 0x4d0); 21fd5132b223a1 Pavel Machek 2008-05-21 239 outb(trigger[1], 0x4d1); 21fd5132b223a1 Pavel Machek 2008-05-21 240 } 21fd5132b223a1 Pavel Machek 2008-05-21 241 --- 0-DAY CI Kernel Test Service, Intel Corporation https://lists.01.org/hyperkitty/list/kbuild-all@xxxxxxxxxxxx
Attachment:
.config.gz
Description: application/gzip