dri-devel Archive on lore.kernel.org
 help / color / mirror / Atom feed
From: Jani Nikula <jani.nikula@intel.com>
To: kbuild test robot <fengguang.wu@intel.com>,
	Mika Kahola <mika.kahola@intel.com>
Cc: intel-gfx@lists.freedesktop.org,
	Jim Bride <jim.bride@linux.intel.com>,
	kbuild-all@01.org, dri-devel@lists.freedesktop.org
Subject: Re: [drm-intel:for-linux-next 6/12] htmldocs: drivers/gpu/drm/drm_dp_helper.c:523: warning: No description found for parameter 'id[6]'
Date: Fri, 16 Sep 2016 10:53:01 +0300	[thread overview]
Message-ID: <871t0kp9gi.fsf@intel.com> (raw)
In-Reply-To: <201609160902.QOD0AMdF%fengguang.wu@intel.com>


Mika, please send in the documentation fix.

BR,
Jani.


On Fri, 16 Sep 2016, kbuild test robot <fengguang.wu@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
_______________________________________________
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

  reply	other threads:[~2016-09-16  7:53 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-09-16  1:00 [drm-intel:for-linux-next 6/12] htmldocs: drivers/gpu/drm/drm_dp_helper.c:523: warning: No description found for parameter 'id[6]' kbuild test robot
2016-09-16  7:53 ` Jani Nikula [this message]
2016-09-16  9:31   ` Mika Kahola

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=871t0kp9gi.fsf@intel.com \
    --to=jani.nikula@intel.com \
    --cc=dri-devel@lists.freedesktop.org \
    --cc=fengguang.wu@intel.com \
    --cc=intel-gfx@lists.freedesktop.org \
    --cc=jim.bride@linux.intel.com \
    --cc=kbuild-all@01.org \
    --cc=mika.kahola@intel.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox