mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [tip:WIP.sched/core 8/11] htmldocs: include/linux/wait.h:584: warning: No description found for parameter 'wq'
@ 2017-03-09 16:37 kbuild test robot
  0 siblings, 0 replies; only message in thread
From: kbuild test robot @ 2017-03-09 16:37 UTC (permalink / raw)
  To: Ingo Molnar; +Cc: kbuild-all, linux-kernel, tipbuild

[-- Attachment #1: Type: text/plain, Size: 10869 bytes --]

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git WIP.sched/core
head:   0605ab6fd5aa0c78133fc6611fa5e4f17e46c396
commit: c98f1694cb0c48b8f100596e4b2d54b82b5af37b [8/11] sched/wait: Re-adjust macro line continuation backslashes in <linux/wait.h>
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

   include/linux/init.h:1: warning: no structured comments found
   kernel/sched/core.c:2085: warning: No description found for parameter 'rf'
   kernel/sched/core.c:2085: warning: Excess function parameter 'cookie' description in 'try_to_wake_up_local'
>> include/linux/wait.h:584: warning: No description found for parameter 'wq'
>> include/linux/wait.h:584: warning: Excess function parameter 'wq_head' description in 'wait_event_interruptible_hrtimeout'
   include/linux/wait.h:788: warning: No description found for parameter 'wq_head'
>> include/linux/wait.h:788: warning: Excess function parameter 'wq' description in 'wait_event_killable'
   include/linux/kthread.h:26: warning: Excess function parameter '...' description in 'kthread_create'
   kernel/sys.c:1: warning: no structured comments found
   include/linux/device.h:969: warning: No description found for parameter 'dma_ops'
   drivers/dma-buf/seqno-fence.c:1: warning: no structured comments found
   include/linux/iio/iio.h:597: warning: No description found for parameter 'trig_readonly'
   include/linux/iio/trigger.h:151: warning: No description found for parameter 'indio_dev'
   include/linux/iio/trigger.h:151: warning: No description found for parameter 'trig'
   include/linux/device.h:970: warning: No description found for parameter 'dma_ops'
   drivers/regulator/core.c:1467: warning: Excess function parameter 'ret' description in 'regulator_dev_lookup'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'open'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'preclose'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'postclose'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'lastclose'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'set_busid'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_handler'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_preinstall'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_postinstall'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'irq_uninstall'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'debugfs_init'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'debugfs_cleanup'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_open_object'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_close_object'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'prime_handle_to_fd'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'prime_fd_to_handle'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_export'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_import'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_pin'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_unpin'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_res_obj'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_get_sg_table'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_import_sg_table'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_vmap'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_vunmap'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_prime_mmap'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'gem_vm_ops'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'major'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'minor'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'patchlevel'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'name'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'desc'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'date'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'driver_features'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'ioctls'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'num_ioctls'
   include/drm/drm_drv.h:438: warning: No description found for parameter 'fops'
   include/drm/drm_color_mgmt.h:1: warning: no structured comments found
   drivers/gpu/drm/drm_fb_cma_helper.c:557: warning: Excess function parameter 'num_crtc' description in 'drm_fbdev_cma_init'
   drivers/gpu/drm/drm_fb_cma_helper.c:558: warning: Excess function parameter 'num_crtc' description in 'drm_fbdev_cma_init'
   drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'pipe'
   drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'dp_output'
   drivers/gpu/drm/i915/intel_lpe_audio.c:342: warning: No description found for parameter 'link_rate'
   drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'pipe'
   drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'dp_output'
   drivers/gpu/drm/i915/intel_lpe_audio.c:343: warning: No description found for parameter 'link_rate'
   drivers/media/dvb-core/dvb_frontend.h:677: warning: No description found for parameter 'refcount'
   Documentation/core-api/assoc_array.rst:13: WARNING: Enumerated list ends without a blank line; unexpected unindent.
   Documentation/doc-guide/sphinx.rst:110: ERROR: Unknown target name: "sphinx c domain".
   kernel/sched/fair.c:7616: WARNING: Inline emphasis start-string without end-string.
   kernel/time/timer.c:1200: ERROR: Unexpected indentation.
   kernel/time/timer.c:1202: ERROR: Unexpected indentation.
   kernel/time/timer.c:1203: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:126: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/wait.h:129: ERROR: Unexpected indentation.
   include/linux/wait.h:131: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/time/hrtimer.c:990: WARNING: Block quote ends without a blank line; unexpected unindent.
   kernel/signal.c:322: WARNING: Inline literal start-string without end-string.
   include/linux/iio/iio.h:219: ERROR: Unexpected indentation.
   include/linux/iio/iio.h:220: WARNING: Block quote ends without a blank line; unexpected unindent.
   include/linux/iio/iio.h:226: WARNING: Definition list ends without a blank line; unexpected unindent.
   drivers/iio/industrialio-core.c:639: ERROR: Unknown target name: "iio_val".
   drivers/iio/industrialio-core.c:646: ERROR: Unknown target name: "iio_val".
   drivers/message/fusion/mptbase.c:5051: WARNING: Definition list ends without a blank line; unexpected unindent.
   drivers/tty/serial/serial_core.c:1898: WARNING: Definition list ends without a blank line; unexpected unindent.
   include/linux/regulator/driver.h:271: ERROR: Unknown target name: "regulator_regmap_x_voltage".
   include/linux/spi/spi.h:369: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:478: ERROR: Unexpected indentation.
   drivers/usb/core/message.c:479: WARNING: Block quote ends without a blank line; unexpected unindent.
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_type".
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_dir".
   Documentation/driver-api/usb.rst:623: ERROR: Unknown target name: "usb_recip".
   Documentation/driver-api/usb.rst:689: ERROR: Unknown target name: "usbdevfs_urb_type".
   sound/soc/soc-core.c:2670: ERROR: Unknown target name: "snd_soc_daifmt".
   sound/core/jack.c:312: ERROR: Unknown target name: "snd_jack_btn".
   WARNING: dvipng command 'dvipng' cannot be run (needed for math display), check the imgmath_dvipng setting

vim +/wq +584 include/linux/wait.h

774a08b35 Kent Overstreet 2013-05-07  568   *
774a08b35 Kent Overstreet 2013-05-07  569   * wake_up() has to be called after changing any variable that could
774a08b35 Kent Overstreet 2013-05-07  570   * change the result of the wait condition.
774a08b35 Kent Overstreet 2013-05-07  571   *
774a08b35 Kent Overstreet 2013-05-07  572   * The function returns 0 if @condition became true, -ERESTARTSYS if it was
774a08b35 Kent Overstreet 2013-05-07  573   * interrupted by a signal, or -ETIME if the timeout elapsed.
774a08b35 Kent Overstreet 2013-05-07  574   */
774a08b35 Kent Overstreet 2013-05-07  575  #define wait_event_interruptible_hrtimeout(wq, condition, timeout)		\
774a08b35 Kent Overstreet 2013-05-07  576  ({										\
774a08b35 Kent Overstreet 2013-05-07  577  	long __ret = 0;								\
e22b886a8 Peter Zijlstra  2014-09-24  578  	might_sleep();								\
774a08b35 Kent Overstreet 2013-05-07  579  	if (!(condition))							\
774a08b35 Kent Overstreet 2013-05-07  580  		__ret = __wait_event_hrtimeout(wq, condition, timeout,		\
774a08b35 Kent Overstreet 2013-05-07  581  					       TASK_INTERRUPTIBLE);		\
774a08b35 Kent Overstreet 2013-05-07  582  	__ret;									\
774a08b35 Kent Overstreet 2013-05-07  583  })
774a08b35 Kent Overstreet 2013-05-07 @584  
35a2af94c Peter Zijlstra  2013-10-02  585  #define __wait_event_interruptible_exclusive(wq, condition)			\
35a2af94c Peter Zijlstra  2013-10-02  586  	___wait_event(wq, condition, TASK_INTERRUPTIBLE, 1, 0,			\
48c252171 Peter Zijlstra  2013-10-02  587  		      schedule())
^1da177e4 Linus Torvalds  2005-04-16  588  
^1da177e4 Linus Torvalds  2005-04-16  589  #define wait_event_interruptible_exclusive(wq, condition)			\
^1da177e4 Linus Torvalds  2005-04-16  590  ({										\
^1da177e4 Linus Torvalds  2005-04-16  591  	int __ret = 0;								\
e22b886a8 Peter Zijlstra  2014-09-24  592  	might_sleep();								\

:::::: The code at line 584 was first introduced by commit
:::::: 774a08b3548f3f4f36c1a4f2a29a1b3710a2c939 wait: add wait_event_hrtimeout()

:::::: TO: Kent Overstreet <koverstreet@google.com>
:::::: CC: Linus Torvalds <torvalds@linux-foundation.org>

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

[-- Attachment #2: .config.gz --]
[-- Type: application/gzip, Size: 6576 bytes --]

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2017-03-09 16:38 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-09 16:37 [tip:WIP.sched/core 8/11] htmldocs: include/linux/wait.h:584: warning: No description found for parameter 'wq' kbuild test robot

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®