[Intel-gfx] [drm-intel:topic/drm-misc 3/3] htmldocs: drivers/gpu/drm/drm_fb_helper.c:1069: warning: No description found for parameter 'suspend'

[kbuild test robot]

tree:   git://anongit.freedesktop.org/drm-intel topic/drm-misc
head:   cfe63423d9be3e7020296c3dfb512768a83cd099
commit: cfe63423d9be3e7020296c3dfb512768a83cd099 [3/3] drm/fb-helper: Add drm_fb_helper_set_suspend_unlocked()
reproduce: make htmldocs

All warnings (new ones prefixed by >>):

>> drivers/gpu/drm/drm_fb_helper.c:1069: warning: No description found for parameter 'suspend'
>> drivers/gpu/drm/drm_fb_helper.c:1069: warning: Excess function parameter 'state' description in 'drm_fb_helper_set_suspend_unlocked'
   drivers/gpu/drm/drm_fb_helper.c:1070: warning: No description found for parameter 'suspend'
   drivers/gpu/drm/drm_fb_helper.c:1070: warning: Excess function parameter 'state' description in 'drm_fb_helper_set_suspend_unlocked'
   Documentation/gpu/drm-kms.rst:13: WARNING: Could not lex literal_block as "C". Highlighting skipped.
   Documentation/gpu/drm-kms-helpers.rst:16: WARNING: Could not lex literal_block as "C". Highlighting skipped.
   Documentation/gpu/i915.rst:57: WARNING: Could not lex literal_block as "C". Highlighting skipped.
   Documentation/gpu/drm-internals.rst:286: WARNING: undefined label: vga_switcheroo (if the link has no caption the label must precede a section header)

vim +/suspend +1069 drivers/gpu/drm/drm_fb_helper.c

  1053	 *                                      takes the console lock
  1054	 * @fb_helper: driver-allocated fbdev helper
  1055	 * @state: desired state, zero to resume, non-zero to suspend
  1056	 *
  1057	 * A wrapper around fb_set_suspend() that takes the console lock. If the lock
  1058	 * isn't available on resume, a worker is tasked with waiting for the lock
  1059	 * to become available. The console lock can be pretty contented on resume
  1060	 * due to all the printk activity.
  1061	 *
  1062	 * This function can be called multiple times with the same state since
  1063	 * &fb_info->state is checked to see if fbdev is running or not before locking.
  1064	 *
  1065	 * Use drm_fb_helper_set_suspend() if you need to take the lock yourself.
  1066	 */
  1067	void drm_fb_helper_set_suspend_unlocked(struct drm_fb_helper *fb_helper,
  1068						int suspend)
> 1069	{
  1070		if (!fb_helper || !fb_helper->fbdev)
  1071			return;
  1072	
  1073		/* make sure there's no pending/ongoing resume */
  1074		flush_work(&fb_helper->resume_work);
  1075	
  1076		if (suspend) {
  1077			if (fb_helper->fbdev->state != FBINFO_STATE_RUNNING)

---
0-DAY kernel test infrastructure                Open Source Technology Center
https://lists.01.org/pipermail/kbuild-all                   Intel Corporation
-------------- next part --------------
A non-text attachment was scrubbed...
Name: .config.gz
Type: application/octet-stream
Size: 6422 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/intel-gfx/attachments/20160823/78f63634/attachment.obj>