Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755439Ab1F0XMU (ORCPT ); Mon, 27 Jun 2011 19:12:20 -0400 Received: from oproxy5-pub.bluehost.com ([67.222.38.55]:48202 "HELO oproxy5-pub.bluehost.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S1755299Ab1F0XKo (ORCPT ); Mon, 27 Jun 2011 19:10:44 -0400 DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=xenotime.net; h=Received:Date:From:To:Cc:Subject:Message-Id:In-Reply-To:References:Organization:X-Mailer:Mime-Version:Content-Type:Content-Transfer-Encoding:X-Identified-User; b=PWKiqacl64p5WWrSAxdCe8DjsiTQRG5O8pLSaJa+yAi3FVji6ALaiYNbe4FhqxFL+cCzQpbvZWLV/ySkXHLJNfFiQMzi0YsGs1UASkVT20Ta+VACR/VvB3k84Kjmn5gy; Date: Mon, 27 Jun 2011 16:10:41 -0700 From: Randy Dunlap To: Vitaliy Ivanov Cc: LKML , Linus Torvalds , Jiri Kosina , Grant Likely , "David S. Miller" , Eric Dumazet , Thomas Gleixner Subject: Re: [PATCH] treewide: fix kernel-doc warnings Message-Id: <20110627161041.4f975c30.rdunlap@xenotime.net> In-Reply-To: <1309192426.17574.47.camel@vivanov> References: <1309192426.17574.47.camel@vivanov> Organization: YPO4 X-Mailer: Sylpheed 2.7.1 (GTK+ 2.16.6; x86_64-unknown-linux-gnu) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-Identified-User: {1807:box742.bluehost.com:xenotime:xenotime.net} {sentby:smtp auth 50.53.38.135 authed with rdunlap@xenotime.net} Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3563 Lines: 87 On Mon, 27 Jun 2011 19:33:46 +0300 Vitaliy Ivanov wrote: > Fixing 'make htmldocs' warnings: > > Warning(/include/linux/hrtimer.h:153): No description found for parameter 'clockid' > Warning(/include/linux/device.h:604): Excess struct/union/enum/typedef member 'of_match' description in 'device' > Warning(/include/net/sock.h:349): Excess struct/union/enum/typedef member 'sk_rmem_alloc' description in 'sock' > > Issue with: > Warning(/include/net/wimax.h:432): No description found for parameter 'rfkill_input' > is already solved in net-next tree - > commit #c6af9c406ceb3434281cf230938453931dcbab75 - net: wimax: Remove of unused 'rfkill_input' pointer. > > Patch is against latest Linus' tree. Acked-by: Randy Dunlap Thanks. > --- > >From 55fe3701d1ed1f1302a73cd5bfdfc7972e89f5b7 Mon Sep 17 00:00:00 2001 > From: Vitaliy Ivanov > Date: Mon, 27 Jun 2011 19:07:08 +0300 > Subject: [PATCH] treewide: fix kernel-doc warnings > > Fix 'make htmldocs' warnings: > > Warning(/include/linux/hrtimer.h:153): No description found for > parameter 'clockid' > Warning(/include/linux/device.h:604): Excess struct/union/enum/typedef > member 'of_match' description in 'device' > Warning(/include/net/sock.h:349): Excess struct/union/enum/typedef > member 'sk_rmem_alloc' description in 'sock' > > Signed-off-by: Vitaliy Ivanov > --- > include/linux/device.h | 1 - > include/linux/hrtimer.h | 1 + > include/net/sock.h | 1 - > 3 files changed, 1 insertions(+), 2 deletions(-) > > diff --git a/include/linux/device.h b/include/linux/device.h > index 553fd37..e4f62d8 100644 > --- a/include/linux/device.h > +++ b/include/linux/device.h > @@ -530,7 +530,6 @@ struct device_dma_parameters { > * @dma_mem: Internal for coherent mem override. > * @archdata: For arch-specific additions. > * @of_node: Associated device tree node. > - * @of_match: Matching of_device_id from driver. > * @devt: For creating the sysfs "dev". > * @devres_lock: Spinlock to protect the resource of the device. > * @devres_head: The resources list of the device. > diff --git a/include/linux/hrtimer.h b/include/linux/hrtimer.h > index 51932e5..fd0dc30 100644 > --- a/include/linux/hrtimer.h > +++ b/include/linux/hrtimer.h > @@ -135,6 +135,7 @@ struct hrtimer_sleeper { > * @cpu_base: per cpu clock base > * @index: clock type index for per_cpu support when moving a > * timer to a base on another cpu. > + * @clockid: clock id for per_cpu support > * @active: red black tree root node for the active timers > * @resolution: the resolution of the clock, in nanoseconds > * @get_time: function to retrieve the current time of the clock > diff --git a/include/net/sock.h b/include/net/sock.h > index f2046e4..c0b938c 100644 > --- a/include/net/sock.h > +++ b/include/net/sock.h > @@ -178,7 +178,6 @@ struct sock_common { > * @sk_dst_cache: destination cache > * @sk_dst_lock: destination cache lock > * @sk_policy: flow policy > - * @sk_rmem_alloc: receive queue bytes committed > * @sk_receive_queue: incoming packets > * @sk_wmem_alloc: transmit queue bytes committed > * @sk_write_queue: Packet sending queue > -- --- ~Randy *** Remember to use Documentation/SubmitChecklist when testing your code *** -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/