From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:44139) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ravla-0006sM-Gh for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:49:31 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RavlZ-0003jy-4Y for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:49:30 -0500 Received: from mail-yx0-f173.google.com ([209.85.213.173]:37234) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RavlY-0003js-VQ for qemu-devel@nongnu.org; Wed, 14 Dec 2011 15:49:29 -0500 Received: by yenm6 with SMTP id m6so1099189yen.4 for ; Wed, 14 Dec 2011 12:49:28 -0800 (PST) Message-ID: <4EE90BD5.9040901@codemonkey.ws> Date: Wed, 14 Dec 2011 14:49:25 -0600 From: Anthony Liguori MIME-Version: 1.0 References: <1323879637-16901-1-git-send-email-aliguori@us.ibm.com> <1323879637-16901-2-git-send-email-aliguori@us.ibm.com> <4EE8F0D4.3050300@weilnetz.de> <4EE905BC.8000203@redhat.com> In-Reply-To: <4EE905BC.8000203@redhat.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 1/4] memory: make memory API parsable by gtkdoc-scan List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Eric Blake Cc: Stefan Weil , qemu-devel@nongnu.org, Avi Kivity On 12/14/2011 02:23 PM, Eric Blake wrote: > On 12/14/2011 11:54 AM, Stefan Weil wrote: >>> It does violate the standard _ followed by upper case letter is reserved >>> in all contexts. >> >> sCamelCase instead of _CamelCase seems to work, too. > > What about _camelCase instead of _CamelCase? That preserves the leading > underscore, but no longer uses the reserved _ followed by a capital. > > At any rate, that's the convention libvirt is using; all public structs > are prefixed with vir, so things like: > > typedef struct _virConnect virConnect; > > are both parseable by gtkdocs as well as C standard compliant. I just hacked gtk-doc. That seems like the easiest solution to the problem. Regards, Anthony Liguori >