From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jani Nikula Subject: Re: [PATCH] drm/i915: fix kernel-doc warnings in intel_audio.c Date: Fri, 18 Sep 2015 14:23:39 +0300 Message-ID: <87wpvormx0.fsf@intel.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Daniel Vetter , David Airlie Cc: Geliang Tang , intel-gfx@lists.freedesktop.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org List-Id: dri-devel@lists.freedesktop.org T24gVHVlLCAxNSBTZXAgMjAxNSwgR2VsaWFuZyBUYW5nIDxnZWxpYW5ndGFuZ0AxNjMuY29tPiB3 cm90ZToKPiBGaXggdGhlIGZvbGxvd2luZyAnbWFrZSBodG1sZG9jcycgd2FybmluZ3M6Cj4KPiAg IC4vL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2F1ZGlvLmM6NDM5OiB3YXJuaW5nOiBObyBk ZXNjcmlwdGlvbiBmb3VuZCBmb3IgcGFyYW1ldGVyICdpbnRlbF9lbmNvZGVyJwo+ICAgLi8vZHJp dmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfYXVkaW8uYzo0Mzk6IHdhcm5pbmc6IEV4Y2VzcyBmdW5j dGlvbiBwYXJhbWV0ZXIgJ2VuY29kZXInIGRlc2NyaXB0aW9uIGluICdpbnRlbF9hdWRpb19jb2Rl Y19kaXNhYmxlJwo+ICAgLi8vZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfYXVkaW8uYzo0Mzk6 IHdhcm5pbmc6IE5vIGRlc2NyaXB0aW9uIGZvdW5kIGZvciBwYXJhbWV0ZXIgJ2ludGVsX2VuY29k ZXInCj4gICAuLy9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9hdWRpby5jOjQzOTogd2Fybmlu ZzogRXhjZXNzIGZ1bmN0aW9uIHBhcmFtZXRlciAnZW5jb2RlcicgZGVzY3JpcHRpb24gaW4gJ2lu dGVsX2F1ZGlvX2NvZGVjX2Rpc2FibGUnCj4KPiBTaWduZWQtb2ZmLWJ5OiBHZWxpYW5nIFRhbmcg PGdlbGlhbmd0YW5nQDE2My5jb20+CgpQdXNoZWQgdG8gZHJtLWludGVsLWZpeGVzLCB0aGFua3Mg Zm9yIHRoZSBwYXRjaC4KCkJSLApKYW5pLgoKCj4gLS0tCj4gIGRyaXZlcnMvZ3B1L2RybS9pOTE1 L2ludGVsX2F1ZGlvLmMgfCAyICstCj4gIDEgZmlsZSBjaGFuZ2VkLCAxIGluc2VydGlvbigrKSwg MSBkZWxldGlvbigtKQo+Cj4gZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVs X2F1ZGlvLmMgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9hdWRpby5jCj4gaW5kZXggZjcz ZGUwYi4uZTM1OTk3ZSAxMDA2NDQKPiAtLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9h dWRpby5jCj4gKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfYXVkaW8uYwo+IEBAIC00 MzAsNyArNDMwLDcgQEAgdm9pZCBpbnRlbF9hdWRpb19jb2RlY19lbmFibGUoc3RydWN0IGludGVs X2VuY29kZXIgKmludGVsX2VuY29kZXIpCj4gIAo+ICAvKioKPiAgICogaW50ZWxfYXVkaW9fY29k ZWNfZGlzYWJsZSAtIERpc2FibGUgdGhlIGF1ZGlvIGNvZGVjIGZvciBIRCBhdWRpbwo+IC0gKiBA ZW5jb2RlcjogZW5jb2RlciBvbiB3aGljaCB0byBkaXNhYmxlIGF1ZGlvCj4gKyAqIEBpbnRlbF9l bmNvZGVyOiBlbmNvZGVyIG9uIHdoaWNoIHRvIGRpc2FibGUgYXVkaW8KPiAgICoKPiAgICogVGhl IGRpc2FibGUgc2VxdWVuY2VzIG11c3QgYmUgcGVyZm9ybWVkIGJlZm9yZSBkaXNhYmxpbmcgdGhl IHRyYW5zY29kZXIgb3IKPiAgICogcG9ydC4KPiAtLSAKPiAxLjkuMQo+Cj4KCi0tIApKYW5pIE5p a3VsYSwgSW50ZWwgT3BlbiBTb3VyY2UgVGVjaG5vbG9neSBDZW50ZXIKX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4IG1haWxpbmcgbGlzdApJ bnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5v cmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753642AbbIRLU3 (ORCPT ); Fri, 18 Sep 2015 07:20:29 -0400 Received: from mga03.intel.com ([134.134.136.65]:50489 "EHLO mga03.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751966AbbIRLU0 (ORCPT ); Fri, 18 Sep 2015 07:20:26 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.17,552,1437462000"; d="scan'208";a="808016688" From: Jani Nikula To: Geliang Tang , Daniel Vetter , David Airlie Cc: Geliang Tang , intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] drm/i915: fix kernel-doc warnings in intel_audio.c In-Reply-To: Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo References: User-Agent: Notmuch/0.20.2+58~g39779b9 (http://notmuchmail.org) Emacs/24.4.1 (x86_64-pc-linux-gnu) Date: Fri, 18 Sep 2015 14:23:39 +0300 Message-ID: <87wpvormx0.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 15 Sep 2015, Geliang Tang wrote: > Fix the following 'make htmldocs' warnings: > > .//drivers/gpu/drm/i915/intel_audio.c:439: warning: No description found for parameter 'intel_encoder' > .//drivers/gpu/drm/i915/intel_audio.c:439: warning: Excess function parameter 'encoder' description in 'intel_audio_codec_disable' > .//drivers/gpu/drm/i915/intel_audio.c:439: warning: No description found for parameter 'intel_encoder' > .//drivers/gpu/drm/i915/intel_audio.c:439: warning: Excess function parameter 'encoder' description in 'intel_audio_codec_disable' > > Signed-off-by: Geliang Tang Pushed to drm-intel-fixes, thanks for the patch. BR, Jani. > --- > drivers/gpu/drm/i915/intel_audio.c | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/gpu/drm/i915/intel_audio.c b/drivers/gpu/drm/i915/intel_audio.c > index f73de0b..e35997e 100644 > --- a/drivers/gpu/drm/i915/intel_audio.c > +++ b/drivers/gpu/drm/i915/intel_audio.c > @@ -430,7 +430,7 @@ void intel_audio_codec_enable(struct intel_encoder *intel_encoder) > > /** > * intel_audio_codec_disable - Disable the audio codec for HD audio > - * @encoder: encoder on which to disable audio > + * @intel_encoder: encoder on which to disable audio > * > * The disable sequences must be performed before disabling the transcoder or > * port. > -- > 1.9.1 > > -- Jani Nikula, Intel Open Source Technology Center