Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932625Ab1EZP2w (ORCPT ); Thu, 26 May 2011 11:28:52 -0400 Received: from oproxy3-pub.bluehost.com ([69.89.21.8]:56393 "HELO oproxy3-pub.bluehost.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S932505Ab1EZP2t (ORCPT ); Thu, 26 May 2011 11:28:49 -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=Sl/za5zysB4kG2RkotdNTkGPmLbiJK+3iCufuw9q7TVgqsxXQG/dZookOflhi7/hGw4CjGLFYVo/b3aJ+CwWH9rnUIgn7swlEnchUtbNAmntzji0LJ6lYBzrE72pK7l8; Date: Thu, 26 May 2011 08:28:34 -0700 From: Randy Dunlap To: "Arend van Spriel" Cc: "Andrew Morton" , "linux-kernel@vger.kernel.org" , "linux-wireless@vger.kernel.org" , "John W. Linville" , "Greg Kroah-Hartman" , "Dan Carpenter" Subject: Re: [RFC V1] lib: cordic: add library module for cordic angle calculation Message-Id: <20110526082834.6ac25796.rdunlap@xenotime.net> In-Reply-To: <4DDE0AB4.5020102@broadcom.com> References: <1306352426-1899-1-git-send-email-arend@broadcom.com> <20110525130438.c05605c7.rdunlap@xenotime.net> <4DDE0AB4.5020102@broadcom.com> 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: 1199 Lines: 33 On Thu, 26 May 2011 10:09:24 +0200 Arend van Spriel wrote: > On 05/25/2011 10:04 PM, Randy Dunlap wrote: > > On Wed, 25 May 2011 21:40:26 +0200 Arend van Spriel wrote: > >> +/** > >> + * struct - i/q coordinate. > > * struct cordic_iq - i/q coordinate > > The kernel-doc processing is pretty smart here. In the current form I > get the html as attached. From that perspective your proposed change is > not needed, but if your point is that it would be more clear to the mere > mortal reading through the source code I can change it. Hm, I see. scripts/kernel-doc gets the struct name from the source code in this case. too smart ;) AFAIK, everywhere else we use /** * struct structname - description and that's what Documentation/kernel-doc-nano-HOWTO.txt calls for, and yes, it would be more readable to us mortals also, so please change it. thanks, --- ~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/