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

[Jani Nikula]

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

-- 
Jani Nikula, Intel Open Source Technology Center