[drm-intel:for-linux-next 6/12] htmldocs: drivers/gpu/drm/drm_dp_helper.c:523: warning: No description found for parameter 'id[6]'

[Mika Kahola]

I'll fix this.

Cheers,
Mika

On Fri, 2016-09-16 at 10:53 +0300, Jani Nikula wrote:
> Mika, please send in the documentation fix.
> 
> BR,
> Jani.
> 
> 
> On Fri, 16 Sep 2016, kbuild test robot <fengguang.wu at intel.com>
> wrote:
> > 
> > tree:   git://anongit.freedesktop.org/drm-intel for-linux-next
> > head:   80209e5f2c42c491ec5f4a63705b4377b407587c
> > commit: 266d783baaf5f34a5bea3b56489f091451a89767 [6/12] drm: Read
> > DP branch device id
> > reproduce: make htmldocs
> > 
> > All warnings (new ones prefixed by >>):
> > 
> >    drivers/gpu/drm/drm_modes.c:693: warning: No description found
> > for parameter 'bus_flags'
> > > 
> > > > 
> > > > drivers/gpu/drm/drm_dp_helper.c:523: warning: No description
> > > > found for parameter 'id[6]'
> >    drivers/gpu/drm/drm_dp_helper.c:524: warning: No description
> > found for parameter 'id[6]'
> >    drivers/gpu/drm/drm_plane_helper.c:248: warning: No description
> > found for parameter 'dst'
> >    drivers/gpu/drm/drm_plane_helper.c:248: warning: Excess function
> > parameter 'dest' description in 'drm_plane_helper_check_update'
> >    drivers/gpu/drm/drm_plane_helper.c:247: warning: No description
> > found for parameter 'dst'
> >    drivers/gpu/drm/drm_plane_helper.c:247: warning: Excess function
> > parameter 'dest' description in 'drm_plane_helper_check_update'
> >    drivers/gpu/drm/drm_crtc.c:1270: WARNING: Inline literal start-
> > string without end-string.
> >    drivers/gpu/drm/drm_crtc.c:1385: WARNING: Inline literal start-
> > string without end-string.
> >    include/drm/drm_crtc.h:1202: WARNING: Inline literal start-
> > string without end-string.
> >    include/drm/drm_crtc.h:1255: WARNING: Inline literal start-
> > string without end-string.
> >    include/drm/drm_crtc.h:1268: WARNING: Inline literal start-
> > string without end-string.
> >    include/drm/drm_crtc.h:1272: WARNING: Inline literal start-
> > string without end-string.
> >    drivers/gpu/drm/drm_irq.c:718: WARNING: Option list ends without
> > a blank line; unexpected unindent.
> >    drivers/gpu/drm/drm_fb_helper.c:2195: WARNING: Inline emphasis
> > start-string without end-string.
> >    drivers/gpu/drm/drm_simple_kms_helper.c:141: WARNING: Inline
> > literal start-string without end-string.
> >    include/drm/drm_gem.h:212: WARNING: Inline emphasis start-string 
> > without end-string.
> >    drivers/gpu/drm/i915/i915_vgpu.c:176: WARNING: Literal block
> > ends without a blank line; unexpected unindent.
> >    drivers/gpu/drm/i915/intel_audio.c:54: WARNING: Inline emphasis
> > start-string without end-string.
> >    drivers/gpu/drm/i915/intel_audio.c:54: WARNING: Inline emphasis
> > start-string without end-string.
> >    drivers/gpu/drm/i915/intel_guc_fwif.h:159: WARNING: Block quote
> > ends without a blank line; unexpected unindent.
> >    drivers/gpu/drm/i915/intel_guc_fwif.h:178: WARNING: Enumerated
> > list ends without a blank line; unexpected unindent.
> >    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.
> > 
> > vim +523 drivers/gpu/drm/drm_dp_helper.c
> > 
> >    507			case DP_DS_16BPC:
> >    508				return 16;
> >    509			}
> >    510		default:
> >    511			return 0;
> >    512		}
> >    513	}
> >    514	EXPORT_SYMBOL(drm_dp_downstream_max_bpc);
> >    515	
> >    516	/**
> >    517	 * drm_dp_downstream_id() - identify branch device
> >    518	 * @aux: DisplayPort AUX channel
> >    519	 *
> >    520	 * Returns branch device id on success or NULL on
> > failure
> >    521	 */
> >    522	int drm_dp_downstream_id(struct drm_dp_aux *aux, char
> > id[6])
> >  > 523	{
> >    524		return drm_dp_dpcd_read(aux, DP_BRANCH_ID,
> > id, 6);
> >    525	}
> >    526	EXPORT_SYMBOL(drm_dp_downstream_id);
> >    527	
> >    528	/*
> >    529	 * I2C-over-AUX implementation
> >    530	 */
> >    531	
> > 
> > ---
> > 0-DAY kernel test infrastructure                Open Source
> > Technology Center
> > https://lists.01.org/pipermail/kbuild-all                   Intel
> > Corporation