[tip:WIP.sched/core 8/11] htmldocs: include/linux/wait.h:584: warning: No description found for parameter 'wq'

From: kbuild test robot
Date: Thu Mar 09 2017 - 11:38:35 EST

Next message: Andrew Banman: "[PATCH 6/6] x86/platform/uv/BAU: Implement uv4_wait_completion with read_status"
Previous message: Rafael J. Wysocki: "Re: [PATCH] cpufreq: User/admin documentation update and consolidation"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

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@xxxxxxxxxx>
:::::: CC: Linus Torvalds <torvalds@xxxxxxxxxxxxxxxxxxxx>

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

Attachment: .config.gz
Description: application/gzip

Next message: Andrew Banman: "[PATCH 6/6] x86/platform/uv/BAU: Implement uv4_wait_completion with read_status"
Previous message: Rafael J. Wysocki: "Re: [PATCH] cpufreq: User/admin documentation update and consolidation"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]